Get phone battery status including level, charging state, temperature, etc.

Get current WiFi connection information (SSID, IP, signal strength, etc.).

Scan for nearby WiFi networks.

Get telephony device info (carrier, phone type, SIM state, etc.).

Get detailed cellular network information.

Get the phone's current GPS location.

Args: provider: Location provider - 'gps', 'network', or 'passive' (default: gps) request: 'once' for single reading, 'last' for last known location, 'updates' for continuous

Check if ADB is set up and connected. On Android 12+, ADB is required for screencap, input, uiautomator, am, etc. to work from Termux.

If not connected, follow the instructions in the output to set up.

Connect ADB to this device wirelessly. Required on Android 12+.

Step 1: If pair_code and pair_port are given, pair first. Step 2: If connect_port is given (or after pairing), connect.

Find these in: Settings → Developer Options → Wireless Debugging

Args: pair_code: Pairing code from wireless debugging (for first-time pairing) pair_port: Pairing port from wireless debugging (e.g. '37123') connect_port: Connection port shown on wireless debugging main page (e.g. '5555' or '45678')

List currently running processes/apps on the phone with CPU and memory usage.

List all installed Termux packages.

Open a URL in the default browser on the phone.

Args: url: The URL to open

Launch an Android app or activity using am (Activity Manager).

Args: package_or_action: Package name (e.g. 'com.whatsapp') or intent action. Common examples: - com.whatsapp - com.tencent.mm (WeChat) - com.android.chrome - com.android.settings - com.android.camera2

List installed Android apps/packages.

Args: filter_keyword: Optional keyword to filter package names (e.g. 'camera', 'wechat')

Take a screenshot of the current phone screen. Returns the screenshot as base64 image data.

Args: output_path: Where to save the screenshot file

Get the phone screen resolution (width x height in pixels).

Tap the screen at specific coordinates.

Use take_screenshot + dump_ui first to find the right coordinates.

Args: x: X coordinate (pixels from left) y: Y coordinate (pixels from top)

Long press at specific screen coordinates.

Args: x: X coordinate y: Y coordinate duration_ms: Press duration in milliseconds (default: 1000)

Swipe on the screen from one point to another.

Args: x1: Start X coordinate y1: Start Y coordinate x2: End X coordinate y2: End Y coordinate duration_ms: Swipe duration in milliseconds (default: 300)

Type text into the currently focused input field.

Note: This works best with ASCII text. For Chinese/Unicode text, use set_clipboard + input_keyevent(keycode='279') (paste) instead.

Args: text: Text to type (spaces are supported)

Input Chinese/Unicode text by copying to clipboard and pasting.

This is the reliable way to input non-ASCII text (Chinese, Japanese, emoji, etc.).

Args: text: The text to input (any language)

Send a key event to the phone.

Args: keycode: Android keycode name or number. Common ones: - '3' or 'KEYCODE_HOME' = Home button - '4' or 'KEYCODE_BACK' = Back button - '26' or 'KEYCODE_POWER' = Power button - '24' = Volume Up, '25' = Volume Down - '66' or 'KEYCODE_ENTER' = Enter/Confirm - '67' or 'KEYCODE_DEL' = Backspace/Delete - '61' or 'KEYCODE_TAB' = Tab - '82' or 'KEYCODE_MENU' = Menu - '187' or 'KEYCODE_APP_SWITCH' = Recent apps - '279' or 'KEYCODE_PASTE' = Paste - '84' or 'KEYCODE_SEARCH' = Search

Dump the current UI hierarchy (XML). Shows all visible UI elements with their text, content-desc, bounds (coordinates), class name, and clickable state.

Use this to find the right element/coordinates before tapping.

Args: output_path: Where to save the XML dump

Find a UI element by its text and tap on it.

This combines dump_ui + tap_screen: dumps the UI hierarchy, finds an element matching the given text, and taps its center.

Args: text: Text to search for in UI elements (partial match, case-insensitive)

Press the Home button to go to the home screen.

Press the Back button.

Open the recent apps / app switcher.

Get the currently focused app (package name and activity).

Take a photo using the phone camera.

Args: camera_id: Camera ID - '0' for back camera, '1' for front camera output_path: Where to save the photo

Get information about available cameras on the device.

List photo files in a directory.

Args: directory: Directory to list photos from (default: phone camera folder) limit: Maximum number of files to list

Read a photo file and return it as base64 encoded data for viewing.

Args: file_path: Path to the image file

List SMS messages.

Args: limit: Number of messages to retrieve (default: 10) type: Message type - 'inbox', 'sent', 'draft', 'all' (default: inbox)

Send an SMS message.

Args: number: Phone number to send to message: Message text

List all contacts from the phone.

Get the current clipboard content.

Set the clipboard content.

Args: text: Text to copy to clipboard

Send a notification to the phone.

Args: title: Notification title content: Notification body text id: Notification ID for updates/removal vibrate: Whether to vibrate (default: True)

Show a toast message on the phone screen.

Args: text: Text to show short: True for short display, False for long (default: True)

Set a volume level on the phone.

Args: stream: Volume stream - 'music', 'ring', 'alarm', 'notification', 'system', 'call' volume: Volume level (0-15 typical range, depends on device)

Get current volume levels for all audio streams.

Turn the flashlight (torch) on or off.

Args: enabled: True to turn on, False to turn off

Vibrate the phone.

Args: duration_ms: Vibration duration in milliseconds (default: 1000) force: Vibrate even in silent mode (default: False)

Speak text aloud using text-to-speech.

Args: text: Text to speak language: Language code (e.g. 'en', 'zh', 'ja') (default: zh) rate: Speech rate, 1.0 is normal (default: 1.0)

Prompt for fingerprint authentication on the device.

Control the media player.

Args: action: One of 'play', 'pause', 'stop', 'info'. Use 'play' with file_path to play a file. file_path: Path to media file (required for 'play' action)

Share a file using Android's share dialog.

Args: file_path: Path to the file to share

Download a file using Android's download manager.

Args: url: URL to download description: Download description shown in notification

List contents of a directory with file sizes.

Args: directory_path: Path to directory (default: current directory) show_hidden: Show hidden files (default: False)

Read the contents of a text file.

Args: file_path: Path to the file to read

Write content to a file.

Args: file_path: Path to the file content: Content to write

Execute a shell command on the phone.

Args: command: Shell command to execute working_directory: Working directory (default: current) timeout: Timeout in seconds (default: 30)

Get phone storage usage information (disk space).

Get comprehensive device information (model, Android version, etc.).

Get current screen brightness level.

Set screen brightness level.

Args: level: Brightness level 0-255

List all available sensors on the device.

Read data from a specific sensor.

Args: sensor_name: Name of the sensor (use get_sensor_list to see available sensors) count: Number of readings to take (default: 1)