Script Runner for Termux

A secure Android bridge for managing and executing scripts via Termux.

Automate tasks, manage environment variables, and create home screen shortcuts for your favourite scripts, with a focus on security and ease of use.

Features

- Integrated script editor: write and modify scripts directly within the app. - Flexible execution: background execution or interactive Termux sessions. - Highly configurable: any file extension, custom prefix commands and arguments, environment variable management, up to 5 Quick Settings tiles for rapid access, and runtime parameters via text input or custom presets. - Customisation: personalise script shortcuts with custom icons. - Data portability: full import and export of the script library, including script files and JSON metadata. - Monitoring (experimental): monitor scripts and auto-restart them if the system kills them. Scripts that finish normally are not restarted.

Remote execution via ADB

Trigger script execution remotely via ADB using the following command:

adb shell am start -n io.github.swiftstagrime.termuxrunner/io.github.swiftstagrime.termuxrunner.ui.features.adbtrigger.AdbTriggerActivity --es io.github.swiftstagrime.termuxrunner.adb_code "YOUR_CODE_HERE"

The code is the unique ADB code specified when saving the script. It is empty by default. Remote execution ignores runtime arguments, as it is designed for non-interactive automation.

Security

Scripts often handle sensitive information, such as API keys in environment variables or private logic. All script data and configurations are stored in an encrypted database using SQLCipher.

Setup

A streamlined onboarding process simplifies initial setup.

During setup, you will be asked to grant the com.termux.permission.RUN_COMMAND permission. The system warning may look intimidating, but this is the standard and necessary way for third-party apps to securely send commands to Termux.

Compatibility

- Minimum SDK: 24 (Android 7.0) - Target SDK: 36 (Android 16) - Xiaomi, MIUI, and HyperOS: specific fixes are included to handle the unique way these systems manage shortcut permissions. - Other OEMs: if shortcuts do not appear, manually check Background Start or Shortcut permissions in system settings. Some OS versions may silently reject permissions without notifying the app. - Exact alarms permission may differ by OEM on Android 12 and above. If that is the case, grant it in settings.

Note

This project is in early development. While functional, keep backups of vital scripts using the built-in export feature.

Language support: English and Russian are manually translated. All other languages are AI-generated and switchable in settings.

License

GNU General Public License v3.0