{"id":21597144,"url":"https://github.com/luisadha/alrc-termux","last_synced_at":"2025-04-11T00:52:05.392Z","repository":{"id":215128416,"uuid":"738196083","full_name":"luisadha/alrc-termux","owner":"luisadha","description":"Alrc-termux is a framework designed to enrich the Termux user experience by providing bash shell configuration and useful plugins.\"","archived":false,"fork":false,"pushed_at":"2025-02-19T16:07:37.000Z","size":1753,"stargazers_count":24,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-11T00:51:55.127Z","etag":null,"topics":["alrc","alrc-termux","android","bash","bashprofile","bashrc","framework","linux","mytermux","oh-my-bash","oh-my-zsh","scripts","termux","termux-banner","termux-environment","termux-hacking","termux-recommended-for-android","termux-style","termux-tools"],"latest_commit_sha":null,"homepage":"http://alrc.luisadha.my.id/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/luisadha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"Copying","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-02T16:49:35.000Z","updated_at":"2025-03-04T02:53:48.000Z","dependencies_parsed_at":"2024-04-02T07:46:49.818Z","dependency_job_id":"3cdc4303-35bc-4e4e-adc4-166a64e16cf5","html_url":"https://github.com/luisadha/alrc-termux","commit_stats":null,"previous_names":["luisadha/alrc-termux"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luisadha%2Falrc-termux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luisadha%2Falrc-termux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luisadha%2Falrc-termux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luisadha%2Falrc-termux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/luisadha","download_url":"https://codeload.github.com/luisadha/alrc-termux/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248322609,"owners_count":21084336,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alrc","alrc-termux","android","bash","bashprofile","bashrc","framework","linux","mytermux","oh-my-bash","oh-my-zsh","scripts","termux","termux-banner","termux-environment","termux-hacking","termux-recommended-for-android","termux-style","termux-tools"],"created_at":"2024-11-24T18:08:08.777Z","updated_at":"2025-04-11T00:52:05.380Z","avatar_url":"https://github.com/luisadha.png","language":"Shell","funding_links":["https://www.buymeacoffee.com/luisadha","https://www.paypal.com/paypalme/luisadha01"],"categories":[],"sub_categories":[],"readme":"# +2 New plugins added since version 4.3.06, try it now!\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./img/alrc-favicon.svg\" alt=\"Logo\" sanitize=true height=\"130\" width=\"250\" /\u003e\n\u003c/p\u003e\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://github.com/luisadha/alrc-termux\" title=\"Go to GitHub repo\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=luisadha\u0026message=alrc-termux\u0026color=blue\u0026logo=github\" alt=\"luisadha - alrc-termux\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/luisadha/alrc-termux\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/luisadha/alrc-termux?style=social\" alt=\"stars - alrc-termux\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/luisadha/alrc-termux\"\u003e\u003cimg src=\"https://img.shields.io/github/forks/luisadha/alrc-termux?style=social\" alt=\"forks - alrc-termux\"\u003e\u003c/a\u003e\n\u003c!-- \u003ca href=\"https://github.com/luisadha/alrc-termux/actions?query=workflow:%22GH+Pages+Deploy%22\"\u003e\u003cimg src=\"https://github.com/luisadha/alrc-termux/workflows/GH%20Pages%20Deploy/badge.svg\" alt=\"GH Pages Deploy\"\u003e\u003c/a\u003e\n--\u003e\n\u003ca href=\"https://github.com/luisadha/alrc-termux/releases/\"\u003e\u003cimg src=\"https://img.shields.io/github/release/luisadha/alrc-termux?include_prereleases=\u0026sort=semver\u0026color=blue\" alt=\"GitHub release\"\u003e\u003c/a\u003e\n\u003ca href=\"#license\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-GPLv3.0-blue\" alt=\"License\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/luisadha/alrc-termux/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/luisadha/alrc-termux\" alt=\"issues - alrc-termux\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n\u003ch2\u003eDemo\u003c/h2\u003e\n\u003ca href=\"https://asciinema.org/a/WBz9QOP5xNeKLFcIOB9wZYeBP\" target=\"_blank\"\u003e\u003cimg src=\"https://asciinema.org/a/WBz9QOP5xNeKLFcIOB9wZYeBP.svg\" /\u003e\u003c/a\u003e\n\n\u003c!-- [![Shorts Video](https://img.youtube.com/vi/9X6naGKNOys/0.jpg)](https://www.youtube.com/shorts/9X6naGKNOys) --\u003e\nDESCRIPTION\n-----------\nAlrc-termux is a framework designed to enrich the Termux user experience by providing bash shell configuration and useful plugins.\"\n\nINSTALLATION\n------------\n\n### REQUIREMENTS\n- Install the application with the [Termux App](https://f-droid.org/packages/com.termux/),\n[Termux API](https://f-droid.org/packages/com.termux.api/), the [Termux Widget](https://f-droid.org/packages/com.termux.widget/) and the Optional Termux Float\n- Enough basic tools like git, curl, grep, sed, gawk, bc, cut and more.\n- Ran \\`termux-setup-storage' first and Uncomment or write `allow-external-apps = true` in ~/.termux/termux.properties.\n- This requires the environment variable export PATH=\"$PATH:/system/bin \" set to be used for the \\`input' and \\`am' commands.\n\n\nA. Termux\n---------\n- *Automatic*\n\n```sh\ncurl -Lo- https://alrc.luisadha.my.id | bash\n```\n\n- *Manual*\n\t\nclone this repository\n\n```sh\nexport PATH=\"$PATH:$HOME/.local/bin\"; git clone https://github.com/luisadha/alrc-termux.git ~/.local/share/alrc-termux\n```\n\n\u003c!--if you use github (**recommended**)\n\n```sh\nexport PATH=\"$PATH:$HOME/.local/bin\"; git clone https://github.com/luisadha/alrc-termux.git ~/.local/share/alrc-termux\n``` --\u003e\n\n\nand linking alrc to your ~/.local/bin path\n\n```sh\nln -s ~/.local/share/alrc-termux/alrc ~/.local/bin/alrc\n```\n\nand then follow step [usage](#usage) or try the following alternatives [one line command](#test)\n\n- *Uninstall*\n\n\t```\n\talrc uninstall\n\t```\n\n- *Updates*\n\n\t```\n\talrc updates\n\t```\n\nB. Other Platform Termux based\n------------------------------\n\n  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\n\nUSAGE\n-----\n\n### usage:\n\nCopy the following code snippet, paste it into the terminal. This will add the configuration directly to your .bash_profile\n\n```text\necho ' export PATH=\"$PATH:$HOME/.local/bin:/system/bin\" ' \u003e\u003e ~/.bash_profile\n\necho ' source \u003c(~/.local/bin/alrc env)\u003e /dev/null 2\u003e\u00261; ' \u003e\u003e ~/.bash_profile\n\necho ' al;' \u003e\u003e ~/.bash_profile\n```\n\n```text\n\nchsh -s bash \u0026\u0026 login      change to bash shell and exit\n\nwhatisal                   print this help message and return\n```\n\n### Templates\n\u003e Use the templates [folder](https://github.com/luisadha/alrc-termux/tree/main/templates) for config recommendations or [online config example](https://luisadha.my.id)\n\n### Test \u0026 Testing\n#### test\n\u003e 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.\n\n\u003e CLI: shot on terminal with \n\n```\nbash ~/.shortcuts/alrc.test \n```\n\n#### testing\n\n- [x] Termux\n- [x] ~~Ztmexluis~~\n- [x] Acode Terminal (Plugin Acode)\n- [ ] AndroidIDE (Terminal) But some gui features and features that require fire extinguishers won't work.\n- [x] Nix-on-droid But some gui features and features that require fire extinguishers won't work.\n- [ ] Proot-distro (Experimental)\n- [ ] Replit (Just for testing purposes)\n- [ ] Wayland (Not working Alif said)\n\nBUGS\n----\n- The al option, namely al_ab, cannot be exported to environment variables. I don't know why that can.\n- 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.\n- 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.\n- 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).\n\n\n\nROADMAP\n-------\n\nDEV: I no longer create scripts for the .shortcuts folder \"It was tiring\" but requests will still be accepted just not our priority anymore.\n\nDEV: I welcome new plugin support ideas\n\nCONTRIBUTION\n------------\nFeedback, contributors, pull requests are all very welcome.\n\n## 💰 Support my work by Donating\n \n[![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://www.buymeacoffee.com/luisadha) \n[![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge\u0026logo=paypal\u0026logoColor=white)](https://www.paypal.com/paypalme/luisadha01)\n\n### Thanks \u0026 Reference\n\n- God \n \n- Contributor\n\n- Termux Apps https://github.com/termux/termux-app\n\n- Termuxlauncher  Plugin Dependencies  https://github.com/amsitlab/termuxlauncher/releases\n\n- Mkshrc (Inspirations) https://forum.xda-developers.com/t/shell-mksh-scripting-mksh-r50e-static-full-mkshrc_mods.2770804/\n\n- Many internet source\n\nAUTHOR AND CONTRIBUTOR\n----------------------\n__Luis Adha__\n\n__Fmways__\n\nLICENSE\n-------\nCopyright © 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.\n\nThis project is licensed under the [GPL-3.0 License](https://www.gnu.org/licenses/gpl-3.0.en.html). Please refer to the license link for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluisadha%2Falrc-termux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluisadha%2Falrc-termux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluisadha%2Falrc-termux/lists"}