Skip to content

Alrc-termux is a framework designed to enrich the Termux user experience by providing bash shell configuration and useful plugins."

License

Notifications You must be signed in to change notification settings

luisadha/alrc-termux

Repository files navigation

+2 New plugins added since version 4.3.06, try it now!

Logo

luisadha - alrc-termux stars - alrc-termux forks - alrc-termux GitHub release License issues - alrc-termux

Demo

DESCRIPTION

Alrc-termux is a framework designed to enrich the Termux user experience by providing bash shell configuration and useful plugins."

INSTALLATION

REQUIREMENTS

  • Install the application with the Termux App, Termux API, the Termux Widget and the Optional Termux Float
  • Enough basic tools like git, curl, grep, sed, gawk, bc, cut and more.
  • Ran `termux-setup-storage' first and Uncomment or write allow-external-apps = true in ~/.termux/termux.properties.
  • This requires the environment variable export PATH="$PATH:/system/bin " set to be used for the `input' and `am' commands.

A. Termux

  • Automatic
curl -Lo- https://get.luisadha.my.id/alrc.sh | bash
  • Manual

clone this repository

export PATH="$PATH:$HOME/.local/bin"; git clone https://github.com/luisadha/alrc-termux.git ~/.local/share/alrc-termux

and linking alrc to your ~/.local/bin path

ln -s ~/.local/share/alrc-termux/alrc ~/.local/bin/alrc

and then follow step usage or try the following alternatives one line command

  • Uninstall

     alrc uninstall
    
  • Updates

     alrc updates
    

B. Other Platform Termux based

If you install alrc-termux in another place like fork termux. You can replace/remove the shebang! so you can continue the installation process. But it is highly recommended to install it in Termux environment

USAGE

usage:

Copy the following code snippet, paste it into the terminal. This will add the configuration directly to your .bash_profile

echo ' export PATH="$PATH:$HOME/.local/bin:/system/bin" ' >> ~/.bash_profile

echo ' source <(~/.local/bin/alrc env)> /dev/null 2>&1; ' >> ~/.bash_profile

echo ' al;' >> ~/.bash_profile

chsh -s bash && login      change to bash shell and exit

whatisal                   print this help message and return

Templates

Use the templates folder for config recommendations or online config example

Test & Testing

test

GUI: Test with the termux widget. If you don't want to mess up your .bash_profile, put the file ~/local/share/alrc-termux/test/.shortcuts/alrc.test To ~/.shortcuts/alrc.test Then make the Termux widget run from there, if it doesn't show up do the refresh.

CLI: shot on terminal with

bash ~/.shortcuts/alrc.test 

testing

  • Termux
  • Ztmexluis
  • Acode Terminal (Plugin Acode)
  • AndroidIDE (Terminal) But some gui features and features that require fire extinguishers won't work.
  • Nix-on-droid But some gui features and features that require fire extinguishers won't work.
  • Proot-distro (Experimental)
  • Replit (Just for testing purposes)
  • Wayland (Not working Alif said)

BUGS

  • The al option, namely al_ab, cannot be exported to environment variables. I don't know why that can.
  • On my device The imjpgrand automation feature won't consistently select the image viewer even if I press "Select always" in the end the solution was that one of the apps had to be uninstalled. I kept the zarchiver viewer and deleted the other one.
  • Be careful installing other dotfiles, it can cause unwanted bugs/errors due to misconfiguration. first uninstall alrc-termux if you want to try using other dotfiles. termux-desktop causes imjpgrand to not work and other weird bugs.
  • MI Music and DMP Music player are tested, brandomusicv only tested on mi music player version 6.4.20i other than that version does not work (solution uninstall update or change to another supported music player).

ROADMAP

DEV: I no longer create scripts for the .shortcuts folder "It was tiring" but requests will still be accepted just not our priority anymore.

DEV: I welcome new plugin support ideas

CONTRIBUTION

Feedback, contributors, pull requests are all very welcome.

💰 Support my work by Donating

BuyMeACoffee PayPal

Thanks & Reference

AUTHOR AND CONTRIBUTOR

Luis Adha

Fmways

LICENSE

Copyright © 2023 Adharudin (Luis Adha). License GPLv3+: GNU GPL version 3 or later http://gnu.org/licenses/gpl.html. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

This project is licensed under the GPL-3.0 License. Please refer to the license link for more information.