菜单
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
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/perminder-klair/ruuh --skill termux-device命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| 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 |
Control device hardware, sensors, and system UI from the command line via Termux API.
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.
| Command | Description |
|---|---|
termux-battery-status | Battery level, status, health, temperature |
termux-audio-info | Current audio output device and routing info |
termux-brightness | Set screen brightness (0–255) |
termux-torch | Toggle flashlight on/off |
termux-vibrate | Vibrate the device |
termux-volume | Get/set audio stream volumes |
termux-sensor | Read device sensors (accelerometer, gyroscope, etc.) |
termux-fingerprint | Authenticate via fingerprint scanner |
termux-location | Get GPS/network location |
termux-wifi-connectioninfo | Current WiFi connection details |
termux-wifi-scaninfo | Scan nearby WiFi networks |
termux-wifi-enable | Enable/disable WiFi |
termux-clipboard-get | Read clipboard contents |
termux-clipboard-set | Set clipboard contents |
termux-notification | Show a persistent notification |
termux-notification-remove | Remove a notification by ID |
termux-notification-list | List active notifications |
termux-dialog | Show an interactive dialog (input, confirm, list, etc.) |
termux-toast | Show a short toast message |
termux-wake-lock | Acquire CPU wake lock (prevent sleep) |
termux-wake-unlock | Release CPU wake lock |
termux-wallpaper | Set device wallpaper |
termux-download | Download a file using Android's DownloadManager |
Returns JSON with battery state.
termux-battery-status
{
"health": "GOOD",
"percentage": 72,
"plugged": "UNPLUGGED",
"status": "DISCHARGING",
"temperature": 28.5,
"current": -412000
}
Returns JSON with current audio output device and routing information.
termux-audio-info
{
"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
}
Set screen brightness. Use auto for automatic or a value 0–255.
termux-brightness 128 # mid brightness
termux-brightness auto # automatic
termux-brightness 0 # minimum
Toggle the flashlight.
termux-torch on
termux-torch off
Vibrate the device.
termux-vibrate # default duration
termux-vibrate -d 500 # vibrate for 500ms
termux-vibrate -f # force vibrate even in silent mode
Flags:
-d <ms> — duration in milliseconds (default: 1000)-f — force vibrate in silent modeGet or set audio volumes.
termux-volume # list all audio streams and volumes
termux-volume music 8 # set music volume to 8
termux-volume ring 5 # set ring volume to 5
Streams: alarm, music, notification, ring, system, call
Output (no args):
[
{"stream": "music", "volume": 8, "max_volume": 15},
{"stream": "ring", "volume": 5, "max_volume": 7},
{"stream": "alarm", "volume": 6, "max_volume": 7}
]
Read hardware sensors.
termux-sensor -l # list all available sensors
termux-sensor -s "accelerometer" # read accelerometer once
termux-sensor -s "accelerometer" -n 5 # read 5 samples
termux-sensor -s "accelerometer" -d 100 # delay 100ms between reads
termux-sensor -a # read all sensors once
Flags:
-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 sensorsAuthenticate using the device fingerprint scanner. Blocks until scan or timeout.
termux-fingerprint
{
"auth_result": "AUTH_RESULT_SUCCESS"
}
Possible auth_result values: AUTH_RESULT_SUCCESS, AUTH_RESULT_FAILURE, AUTH_RESULT_UNKNOWN
Get device location via GPS or network.
termux-location # default provider
termux-location -p gps # GPS provider (more accurate, slower)
termux-location -p network # network provider (faster, less accurate)
termux-location -r once # single reading (default)
termux-location -r updates # continuous updates
Flags:
-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"
}
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"
}
Scan for nearby WiFi networks.
termux-wifi-scaninfo
Returns a JSON array of discovered networks with SSID, BSSID, signal strength, frequency, and capabilities.
Enable or disable WiFi.
termux-wifi-enable true
termux-wifi-enable false
Read the current clipboard contents.
termux-clipboard-get
Returns the plain text clipboard content.
Set the clipboard contents.
termux-clipboard-set "Hello, world!"
echo "copied text" | termux-clipboard-set
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
Flags:
-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 buttonRemove a notification by its ID.
termux-notification-remove mynotif
List all active notifications on the device.
termux-notification-list
[
{
"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.
Show an interactive UI dialog and return user input as JSON.
termux-dialog # default text input
termux-dialog confirm -t "Are you sure?" # yes/no confirm
termux-dialog checkbox -v "A,B,C" -t "Pick" # multi-select checkboxes
termux-dialog radio -v "Red,Green,Blue" # single-select radio
termux-dialog spinner -v "Opt1,Opt2,Opt3" # dropdown spinner
termux-dialog date -t "Pick a date" # date picker
termux-dialog time -t "Pick a time" # time picker
termux-dialog sheet -v "Copy,Paste,Delete" # bottom sheet
termux-dialog speech -t "Speak now" # speech input
Widget types: confirm, checkbox, counter, date, radio, sheet, spinner, speech, text, time
Common flags:
-t <title> — dialog title-v <values> — comma-separated values for list-based widgets-i <hint> — input hint textReturns JSON with code (-1 = cancelled, -2 = error, 0+ = success) and text (user input).
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 # short duration (default)
Flags:
-g <position> — gravity: top, middle, bottom (default: bottom)-b <colour> — background colour-c <colour> — text colour-s — short duration (default)Keep the CPU awake (prevents device sleep).
termux-wake-lock # acquire lock
# ... do long-running work ...
termux-wake-unlock # release lock
Set the device wallpaper.
termux-wallpaper -f /sdcard/photo.jpg # from file
termux-wallpaper -u "https://example.com/img.jpg" # from URL
termux-wallpaper -l # set lock screen wallpaper
Flags:
-f <file> — image file path-u <url> — image URL-l — set as lock screen wallpaper (instead of home screen)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"
Flags:
-t <title> — notification title-d <description> — notification descriptionBATTERY=$(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
termux-notification --id build -t "Build" -c "Starting..." --ongoing
# ... run build ...
termux-notification --id build -t "Build" -c "Tests passed" --alert-once
# ... deploy ...
termux-notification-remove build
termux-toast "Build complete!"
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
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
# Post a notification
termux-notification --id build -t "Build" -c "Compiling..." --ongoing
# Check it's active
termux-notification-list | jq '.[] | select(.tag == "build")'
# Update it
termux-notification --id build -t "Build" -c "Running tests..." --alert-once
# Remove when done
termux-notification-remove build
termux-toast "Build complete!"
termux-wake-lock
# ... long running process ...
termux-wake-unlock
termux-vibrate -d 200
termux-toast "Task finished"