repository·master·Indexed 41 days ago
https://github.com/t-e-l/telA specialized launcher designed for Termux experts to provide enhanced control and automation capabilities within the Termux environment.
Termux allows third-party Android applications to execute commands or scripts by sending an Intent to the RunCommandService.
allow-external-apps to true in your termux.properties file (located at ~/.termux/termux.properties or ~/.config/termux/termux.properties).com.termux.permission.RUN_COMMAND permission and the user must grant it.RUN_COMMAND_BACKGROUND set to false to automatically bring Termux to the foreground without manual notification interaction, Termux must be granted the 'draw over apps' permission.When sending the Intent, use the following keys:
com.termux.RUN_COMMAND_PATH (String, Required): The absolute path to the command or script. Supports $PREFIX/ and ~/ prefixes.com.termux.RUN_COMMAND_ARGUMENTS (String[]): Optional arguments for the command.com.termux.RUN_COMMAND_WORKDIR (String): Optional working directory. Defaults to Termux home. Supports $PREFIX/ and ~/ prefixes.com.termux.RUN_COMMAND_BACKGROUND (Boolean): Whether to run in the background. Defaults to false.// Java example to run 'top -n 5' in Termux home
Intent intent = new Intent();
intent.setClassName("com.termux", "com.termux.app.RunCommandService");
intent.setAction("com.termux.RUN_COMMAND");
intent.putExtra("com.termux.RUN_COMMAND_PATH", "/data/data/com.termux/files/usr/bin/top");
intent.putExtra("com.termux.RUN_COMMAND_ARGUMENTS", new String[]{"-n", "5"});
intent.putExtra("com.termux.RUN_COMMAND_WORKDIR", "/data/data/com.termux/files/home");
intent.putExtra("com.termux.RUN_COMMAND_BACKGROUND", false);
startService(intent);You can trigger command execution from a shell environment (e.g., via ADB) using the am startservice command. This is useful for automation scripts interacting with the Termux service.
am startservice --user 0 -n com.termux/com.termux.app.RunCommandService \
-a com.termux.RUN_COMMAND \
--es com.termux.RUN_COMMAND_PATH '/data/data/com.termux/files/usr/bin/top' \
--esa com.termux.RUN_COMMAND_ARGUMENTS '-n,5' \
--es com.termux.RUN_COMMAND_WORKDIR '/data/data/com.termux/files/home' \
--ez com.termux.RUN_COMMAND_BACKGROUND 'false'--esa is used for the String array com.termux.RUN_COMMAND_ARGUMENTS (comma-separated values).--es is used for String extras (PATH, WORKDIR).--ez is used for the Boolean extra (BACKGROUND).You can interact with the TermuxService using Android Intents. This allows external applications or system components to trigger specific actions within the Termux environment.
Use the com.termux.service_execute action to launch a new terminal session or a background task.
TerminalSession and launch TermuxActivity to display it.com.termux.execute.background extra to true. This creates a BackgroundJob instead of a visible session.| Extra Key | Type | Description |
|---|---|---|
com.termux.execute.arguments | String[] | Arguments to pass to the executable. |
com.termux.execute.cwd | String | The current working directory for the execution. |
com.termux.execute.background | boolean | If true, runs the command as a background task. |
| Action String | Purpose |
|---|---|
com.termux.service_execute | Launches a session or background job. |
com.termux.service_wake_lock | Acquires a partial wake lock and a high-performance WiFi lock. |
com.termux.service_wake_unlock | Releases both the wake lock and the WiFi lock. |
com.termux.service_stop | Finishes all running terminal sessions and stops the service. |
// Example: Launching a background task via Intent
Intent intent = new Intent("com.termux.service_execute");
intent.setData(Uri.parse("/data/data/com.termux/files/usr/bin/top"));
intent.putExtra("com.termux.execute.arguments", new String[]{"-b"});
intent.putExtra("com.termux.execute.background", true);
context.startService(intent);The following action strings are used to control the TermuxService lifecycle and power management via startService(Intent).
private static final String ACTION_STOP_SERVICE = "com.termux.service_stop";
private static final String ACTION_LOCK_WAKE = "com.termux.service_wake_lock";
private static final String ACTION_UNLOCK_WAKE = "com.termux.service_wake_unlock";
public static final String ACTION_EXECUTE = "com.termux.service_execute";The following constants define the Intent extras used by com.termux.app.RunCommandService to configure command execution.
public static final String RUN_COMMAND_ACTION = "com.termux.RUN_COMMAND";
public static final String RUN_COMMAND_PATH = "com.termux.RUN_COMMAND_PATH";
public static final String RUN_COMMAND_ARGUMENTS = "com.termux.RUN_COMMAND_ARGUMENTS";
public static final String RUN_COMMAND_WORKDIR = "com.termux.RUN_COMMAND_WORKDIR";
public static final String RUN_COMMAND_BACKGROUND = "com.termux.RUN_COMMAND_BACKGROUND";The following extra keys are used with the com.termux.service_execute action to configure the execution environment.
public static final String EXTRA_ARGUMENTS = "com.termux.execute.arguments";
public static final String EXTRA_CURRENT_WORKING_DIRECTORY = "com.termux.execute.cwd";
public static final String EXTRA_EXECUTE_IN_BACKGROUND = "com.termux.execute.background";These constants define the primary directory structure used by Termux. Note that FILES_PATH is a symlink on Android M preview.
public static final String FILES_PATH = "/data/data/com.termux/files";
public static final String PREFIX_PATH = FILES_PATH + "/usr";
public static final String HOME_PATH = FILES_PATH + "/home";