Skip to main content Inicio Creadores perminder-klair ruuh termux-device
termux-device Android device control via Termux API — battery, brightness, torch, vibrate, volume, audio info, sensors, fingerprint, location, WiFi, clipboard, notifications, dialogs, toasts, wake lock, wallpaper, downloads
Ir a la instalación Skills Marketplace Descubre y explora habilidades de IA creadas por la comunidad.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Mostrar detalles del prompt Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.
npx skills add https://github.com/perminder-klair/ruuh --skill termux-deviceEl comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.
¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.
Descargar Zip Descargando... Ocupaciones relacionadas SOC
Basado en la clasificación ocupacional SOC
name termux-device description Android device control via Termux API — battery, brightness, torch, vibrate, volume, audio info, sensors, fingerprint, location, WiFi, clipboard, notifications, dialogs, toasts, wake lock, wallpaper, downloads
Termux Device — Android Hardware, Sensors & UI
Control device hardware, sensors, and system UI from the command line via Termux API.
Important: Permission Handling
When a Termux API command runs for the first time, Android may prompt the user to grant permission. The command will fail with a permission/access error, but the user sees an approval dialog on their device. Always retry the command once if you get a permission error — the user will have approved the permission by then, and the retry will succeed.
Do not assume you lack access after a single permission failure. One retry is all it takes.
Quick Reference
Command Description termux-battery-statusBattery level, status, health, temperature termux-audio-infoCurrent audio output device and routing info termux-brightnessSet screen brightness (0–255) termux-torchToggle flashlight on/off termux-vibrateVibrate the device termux-volumeGet/set audio stream volumes termux-sensorRead device sensors (accelerometer, gyroscope, etc.) termux-fingerprintAuthenticate via fingerprint scanner
termux-locationGet GPS/network location
termux-wifi-connectioninfoCurrent WiFi connection details
termux-wifi-scaninfoScan nearby WiFi networks
termux-wifi-enableEnable/disable WiFi
termux-clipboard-getRead clipboard contents
termux-clipboard-setSet clipboard contents
termux-notificationShow a persistent notification
termux-notification-removeRemove a notification by ID
termux-notification-listList active notifications
termux-dialogShow an interactive dialog (input, confirm, list, etc.)
termux-toastShow a short toast message
termux-wake-lockAcquire CPU wake lock (prevent sleep)
termux-wake-unlockRelease CPU wake lock
termux-wallpaperSet device wallpaper
termux-downloadDownload a file using Android's DownloadManager
Detailed Usage
termux-battery-status Returns JSON with battery state.
{
"health" : "GOOD" ,
"percentage" : 72 ,
"plugged" : "UNPLUGGED" ,
"status" : "DISCHARGING" ,
"temperature" : 28.5 ,
"current" : -412000
}
termux-audio-info Returns JSON with current audio output device and routing information.
{
"STREAM_MUSIC" : {
"volume" : 8 ,
"max_volume" : 15
} ,
"STREAM_RING" : {
"volume" : 5 ,
"max_volume" : 7
} ,
"STREAM_NOTIFICATION" : {
"volume" : 5 ,
"max_volume" : 7
} ,
"BLUETOOTH_A2DP_IS_ON" : false ,
"WIREDHEADSET_IS_ON" : false ,
"SPEAKERPHONE_IS_ON" : false }
termux-brightness Set screen brightness. Use auto for automatic or a value 0–255.
termux-brightness 128
termux-brightness auto
termux-brightness 0
termux-torch termux-torch on
termux-torch off
termux-vibrate termux-vibrate
termux-vibrate -d 500
termux-vibrate -f
-d <ms> — duration in milliseconds (default: 1000)-f — force vibrate in silent mode
termux-volume Get or set audio volumes.
termux-volume
termux-volume music 8
termux-volume ring 5
Streams: alarm, music, notification, ring, system, call
[
{ "stream" : "music" , "volume" : 8 , "max_volume" : 15 } ,
{ "stream" : "ring" , "volume" : 5 , "max_volume" : 7 } ,
{ "stream" : "alarm" , "volume" : 6 , "max_volume" : 7 }
]
termux-sensor termux-sensor -l
termux-sensor -s "accelerometer"
termux-sensor -s "accelerometer" -n 5
termux-sensor -s "accelerometer" -d 100
termux-sensor -a
-l — list available sensors-s <name> — sensor to read-n <count> — number of readings (default: 1)-d <ms> — delay between readings in milliseconds-a — read all sensors
termux-fingerprint Authenticate using the device fingerprint scanner. Blocks until scan or timeout.
{
"auth_result" : "AUTH_RESULT_SUCCESS"
}
Possible auth_result values: AUTH_RESULT_SUCCESS, AUTH_RESULT_FAILURE, AUTH_RESULT_UNKNOWN
termux-location Get device location via GPS or network.
termux-location
termux-location -p gps
termux-location -p network
termux-location -r once
termux-location -r updates
-p <provider> — gps or network (default: gps)-r <request> — once or updates (default: once) {
"latitude" : 51.5074 ,
"longitude" : -0.1278 ,
"altitude" : 11.0 ,
"accuracy" : 20.0 ,
"bearing" : 0.0 ,
"speed" : 0.0 ,
"elapsedMs" : 42 ,
"provider" : "gps"
}
termux-wifi-connectioninfo Current WiFi connection info.
termux-wifi-connectioninfo
{
"bssid" : "02:00:00:00:00:00" ,
"frequency_mhz" : 5180 ,
"ip" : "192.168.1.100" ,
"link_speed_mbps" : 866 ,
"mac_address" : "02:00:00:00:00:00" ,
"network_id" : 0 ,
"rssi" : -45 ,
"ssid" : "MyNetwork" ,
"ssid_hidden" : false ,
"supplicant_state" : "COMPLETED"
}
termux-wifi-scaninfo Scan for nearby WiFi networks.
Returns a JSON array of discovered networks with SSID, BSSID, signal strength, frequency, and capabilities.
termux-wifi-enable termux-wifi-enable true
termux-wifi-enable false
termux-clipboard-get Read the current clipboard contents.
Returns the plain text clipboard content.
termux-clipboard-set Set the clipboard contents.
termux-clipboard-set "Hello, world!"
echo "copied text" | termux-clipboard-set
termux-notification Show a persistent notification in the notification shade.
termux-notification -t "Title" -c "Body text"
termux-notification --id mynotif -t "Download" -c "In progress..." --ongoing
termux-notification --id mynotif -t "Download" -c "Complete!" --alert-once
-t <title> — notification title-c <content> — notification body text--id <id> — unique ID (for updates/removal)--ongoing — persistent notification (user can't dismiss)--alert-once — only alert on first show (for updates)--priority <p> — high, low, max, min, default--sound — play default notification sound--vibrate <pattern> — vibration pattern (comma-separated ms)--led-color <rrggbb> — LED colour--led-on <ms> — LED on duration--led-off <ms> — LED off duration--action <cmd> — command to run when notification is tapped--button1 <label> — first action button label--button1-action <cmd> — command for first button--button2 <label> / --button2-action <cmd> — second action button--button3 <label> / --button3-action <cmd> — third action button
termux-notification-remove Remove a notification by its ID.
termux-notification-remove mynotif
termux-notification-list List all active notifications on the device.
[
{
"id" : 1 ,
"tag" : "mynotif" ,
"key" : "0|com.termux.api|1|mynotif|10108" ,
"group" : "" ,
"packageName" : "com.termux.api" ,
"title" : "Build" ,
"content" : "In progress..." ,
"when" : "2025-01-15 14:30:00"
}
]
Returns a JSON array of all active notifications with their ID, tag, package, title, content, and timestamp.
termux-dialog Show an interactive UI dialog and return user input as JSON.
termux-dialog
termux-dialog confirm -t "Are you sure?"
termux-dialog checkbox -v "A,B,C" -t "Pick"
termux-dialog radio -v "Red,Green,Blue"
termux-dialog spinner -v "Opt1,Opt2,Opt3"
termux-dialog date -t "Pick a date"
termux-dialog time -t "Pick a time"
termux-dialog sheet -v "Copy,Paste,Delete"
termux-dialog speech -t "Speak now"
Widget types: confirm, checkbox, counter, date, radio, sheet, spinner, speech, text, time
-t <title> — dialog title-v <values> — comma-separated values for list-based widgets-i <hint> — input hint text Returns JSON with code (-1 = cancelled, -2 = error, 0+ = success) and text (user input).
termux-toast Show a brief toast message.
termux-toast "Hello!"
termux-toast -g middle "Centred toast"
termux-toast -b white -c black "Custom colours"
termux-toast -s
-g <position> — gravity: top, middle, bottom (default: bottom)-b <colour> — background colour-c <colour> — text colour-s — short duration (default)
termux-wake-lock / termux-wake-unlock Keep the CPU awake (prevents device sleep).
termux-wake-lock
termux-wake-unlock
termux-wallpaper Set the device wallpaper.
termux-wallpaper -f /sdcard/photo.jpg
termux-wallpaper -u "https://example.com/img.jpg"
termux-wallpaper -l
-f <file> — image file path-u <url> — image URL-l — set as lock screen wallpaper (instead of home screen)
termux-download Download a file using Android's DownloadManager.
termux-download "https://example.com/file.zip"
termux-download -t "My Download" -d "Downloading file..." "https://example.com/file.zip"
-t <title> — notification title-d <description> — notification description
Common Patterns
Battery check before long tasks BATTERY=$(termux-battery-status)
LEVEL=$(echo "$BATTERY " | jq -r '.percentage' )
STATUS=$(echo "$BATTERY " | jq -r '.status' )
if [ "$LEVEL " -lt 20 ] && [ "$STATUS " = "DISCHARGING" ]; then
termux-toast "Battery low ($LEVEL %). Plug in before running."
else
echo "Battery OK: ${LEVEL} % (${STATUS} )"
fi
Notification with progress updates termux-notification --id build -t "Build" -c "Starting..." --ongoing
termux-notification --id build -t "Build" -c "Tests passed" --alert-once
termux-notification-remove build
termux-toast "Build complete!"
Get user confirmation via dialog RESULT=$(termux-dialog confirm -t "Deploy to production?" )
if echo "$RESULT " | jq -e '.text == "yes"' > /dev/null 2>&1; then
echo "Deploying..."
else
echo "Cancelled."
fi
Location-stamped log LOC=$(termux-location -p network)
LAT=$(echo "$LOC " | jq -r '.latitude' )
LON=$(echo "$LOC " | jq -r '.longitude' )
echo "[$(date -Iseconds) ] lat=$LAT lon=$LON " >> /sdcard/ruuh/location.log
Full notification lifecycle
termux-notification --id build -t "Build" -c "Compiling..." --ongoing
termux-notification-list | jq '.[] | select(.tag == "build")'
termux-notification --id build -t "Build" -c "Running tests..." --alert-once
termux-notification-remove build
termux-toast "Build complete!"
Keep device awake during a task termux-wake-lock
termux-wake-unlock
termux-vibrate -d 200
termux-toast "Task finished"
