From 17a32f13a6a3a55443923ea4462c237ad60361b6 Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Fri, 27 Feb 2026 16:52:49 +0100 Subject: [PATCH 01/15] Fix #828: Add accessibility API --- app/src/main/AndroidManifest.xml | 13 ++ .../api/TermuxAccessibilityService.java | 26 ++++ .../com/termux/api/TermuxApiReceiver.java | 4 + .../com/termux/api/apis/AccessibilityAPI.java | 145 ++++++++++++++++++ .../res/xml/accessibility_service_config.xml | 6 + 5 files changed, 194 insertions(+) create mode 100644 app/src/main/java/com/termux/api/TermuxAccessibilityService.java create mode 100644 app/src/main/java/com/termux/api/apis/AccessibilityAPI.java create mode 100644 app/src/main/res/xml/accessibility_service_config.xml diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml index f9d371212..4de1ed59d 100644 --- a/app/src/main/AndroidManifest.xml +++ b/app/src/main/AndroidManifest.xml @@ -176,6 +176,19 @@ android:enabled="true" android:exported="false" /> + + + + + + + { + final ContentResolver contentResolver = context.getContentResolver(); + if (intent.hasExtra("dump")) { + out.print(dump()); + } + else if (intent.hasExtra("click")) { + click(intent.getIntExtra("x", 0), intent.getIntExtra("y", 0)); + } + }); + } + + private static void click(int x, int y) { + Path swipePath = new Path(); + swipePath.moveTo(x, y); + GestureDescription.Builder gestureBuilder = new GestureDescription.Builder(); + gestureBuilder.addStroke(new GestureDescription.StrokeDescription(swipePath, 0, 1)); + TermuxAccessibilityService.instance.dispatchGesture(gestureBuilder.build(), null, null); + } + + // The aim of this function is to give a compatible output with `adb` `uiautomator dump`. + private static String dump() throws TransformerException, ParserConfigurationException { + // Create a DocumentBuilder + DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); + DocumentBuilder builder = factory.newDocumentBuilder(); + + // Create a new Document + Document document = builder.newDocument(); + + // Create root element + Element root = document.createElement("hierarchy"); + document.appendChild(root); + + AccessibilityNodeInfo node = TermuxAccessibilityService.instance.getRootInActiveWindow(); + + dumpNodeAuxiliary(document, root, node); + + // Write as XML + TransformerFactory transformerFactory = TransformerFactory.newInstance(); + Transformer transformer = transformerFactory.newTransformer(); + transformer.setOutputProperty(OutputKeys.INDENT, "yes"); + transformer.setOutputProperty("{http://xml.apache.org/xslt}indent-amount", "2"); + DOMSource source = new DOMSource(document); + + StringWriter sw = new StringWriter(); + StreamResult result = new StreamResult(sw); + transformer.transform(source, result); + + return sw.toString(); + } + + private static void dumpNodeAuxiliary(Document document, Element element, AccessibilityNodeInfo node) { + for (int i = 0; i < node.getChildCount(); i++) { + AccessibilityNodeInfo nodeChild = node.getChild(i); + Element elementChild = document.createElement("node"); + + elementChild.setAttribute("index", String.valueOf(i)); + + elementChild.setAttribute("text", getCharSequenceAsString(nodeChild.getText())); + + String nodeChildViewIdResourceName = nodeChild.getViewIdResourceName(); + elementChild.setAttribute("resource-id", nodeChildViewIdResourceName != null ? nodeChildViewIdResourceName : ""); + + elementChild.setAttribute("class", nodeChild.getClassName().toString()); + + elementChild.setAttribute("package", nodeChild.getPackageName().toString()); + + elementChild.setAttribute("content-desc", getCharSequenceAsString(nodeChild.getContentDescription())); + + elementChild.setAttribute("checkable", String.valueOf(nodeChild.isCheckable())); + + elementChild.setAttribute("checked", String.valueOf(nodeChild.isChecked())); + + elementChild.setAttribute("clickable", String.valueOf(nodeChild.isClickable())); + + elementChild.setAttribute("enabled", String.valueOf(nodeChild.isEnabled())); + + elementChild.setAttribute("focusable", String.valueOf(nodeChild.isFocusable())); + + elementChild.setAttribute("focused", String.valueOf(nodeChild.isFocused())); + + elementChild.setAttribute("scrollable", String.valueOf(nodeChild.isScrollable())); + + elementChild.setAttribute("long-clickable", String.valueOf(nodeChild.isLongClickable())); + + elementChild.setAttribute("password", String.valueOf(nodeChild.isPassword())); + + elementChild.setAttribute("selected", String.valueOf(nodeChild.isSelected())); + + Rect nodeChildBounds = new Rect(); + nodeChild.getBoundsInScreen(nodeChildBounds); + elementChild.setAttribute("bounds", nodeChildBounds.toShortString()); + + elementChild.setAttribute("drawing-order", String.valueOf(nodeChild.getDrawingOrder())); + + elementChild.setAttribute("hint", getCharSequenceAsString(nodeChild.getHintText())); + + element.appendChild(elementChild); + dumpNodeAuxiliary(document, elementChild, nodeChild); + } + } + + private static String getCharSequenceAsString(CharSequence charSequence) { + return charSequence != null ? charSequence.toString() : ""; + } +} diff --git a/app/src/main/res/xml/accessibility_service_config.xml b/app/src/main/res/xml/accessibility_service_config.xml new file mode 100644 index 000000000..b9b2e0de8 --- /dev/null +++ b/app/src/main/res/xml/accessibility_service_config.xml @@ -0,0 +1,6 @@ + + From d948b26e227e5e215c25efc5b6d8fe2a17c48106 Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Fri, 27 Feb 2026 20:55:52 +0100 Subject: [PATCH 02/15] Prompt the user to enable accessibility to Termux API if not already done --- .../com/termux/api/apis/AccessibilityAPI.java | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java index 616175137..74685f409 100644 --- a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java +++ b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java @@ -31,6 +31,14 @@ import android.content.ContentResolver; +import android.provider.Settings; + +import android.view.accessibility.AccessibilityManager; +import android.accessibilityservice.AccessibilityServiceInfo; +import android.content.pm.ServiceInfo; +import java.util.List; +import android.accessibilityservice.AccessibilityService; + public class AccessibilityAPI { private static final String LOG_TAG = "AccessibilityAPI"; @@ -38,6 +46,13 @@ public class AccessibilityAPI { public static void onReceive(TermuxApiReceiver apiReceiver, final Context context, Intent intent) { Logger.logDebug(LOG_TAG, "onReceive"); + boolean isAccessibilityEnabled = isAccessibilityServiceEnabled(context, TermuxAccessibilityService.class); + if (!isAccessibilityEnabled) { + Intent accessibilityIntent = new Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS); + accessibilityIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); + context.startActivity(accessibilityIntent); + } + ResultReturner.returnData(apiReceiver, intent, out -> { final ContentResolver contentResolver = context.getContentResolver(); if (intent.hasExtra("dump")) { @@ -49,6 +64,20 @@ else if (intent.hasExtra("click")) { }); } + // [The Stack Overflow answer 14923144](https://stackoverflow.com/a/14923144) + public static boolean isAccessibilityServiceEnabled(Context context, Class service) { + AccessibilityManager am = (AccessibilityManager) context.getSystemService(Context.ACCESSIBILITY_SERVICE); + List enabledServices = am.getEnabledAccessibilityServiceList(AccessibilityServiceInfo.FEEDBACK_ALL_MASK); + + for (AccessibilityServiceInfo enabledService : enabledServices) { + ServiceInfo enabledServiceInfo = enabledService.getResolveInfo().serviceInfo; + if (enabledServiceInfo.packageName.equals(context.getPackageName()) && enabledServiceInfo.name.equals(service.getName())) + return true; + } + + return false; + } + private static void click(int x, int y) { Path swipePath = new Path(); swipePath.moveTo(x, y); From f20f6af9f1603a3a220392be01f105d3e9883a99 Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Fri, 27 Feb 2026 21:21:53 +0100 Subject: [PATCH 03/15] Add `type` ability --- .../java/com/termux/api/apis/AccessibilityAPI.java | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java index 74685f409..badd70efe 100644 --- a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java +++ b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java @@ -38,6 +38,7 @@ import android.content.pm.ServiceInfo; import java.util.List; import android.accessibilityservice.AccessibilityService; +import android.os.Bundle; public class AccessibilityAPI { @@ -57,9 +58,10 @@ public static void onReceive(TermuxApiReceiver apiReceiver, final Context contex final ContentResolver contentResolver = context.getContentResolver(); if (intent.hasExtra("dump")) { out.print(dump()); - } - else if (intent.hasExtra("click")) { + } else if (intent.hasExtra("click")) { click(intent.getIntExtra("x", 0), intent.getIntExtra("y", 0)); + } else if (intent.hasExtra("type")) { + type(intent.getStringExtra("type")); } }); } @@ -171,4 +173,11 @@ private static void dumpNodeAuxiliary(Document document, Element element, Access private static String getCharSequenceAsString(CharSequence charSequence) { return charSequence != null ? charSequence.toString() : ""; } + + private static void type(String toType) { + AccessibilityNodeInfo focusedNode = TermuxAccessibilityService.instance.getRootInActiveWindow().findFocus(AccessibilityNodeInfo.FOCUS_INPUT); + Bundle arguments = new Bundle(); + arguments.putCharSequence(AccessibilityNodeInfo.ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE, toType); + focusedNode.performAction(AccessibilityNodeInfo.ACTION_SET_TEXT, arguments); + } } From 8dcd6890f38bb74cf38229c69b7c1973706ae5db Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Fri, 27 Feb 2026 22:30:53 +0100 Subject: [PATCH 04/15] Add `performGlobalAction` --- app/src/main/java/com/termux/api/apis/AccessibilityAPI.java | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java index badd70efe..4aa1dd219 100644 --- a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java +++ b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java @@ -62,6 +62,8 @@ public static void onReceive(TermuxApiReceiver apiReceiver, final Context contex click(intent.getIntExtra("x", 0), intent.getIntExtra("y", 0)); } else if (intent.hasExtra("type")) { type(intent.getStringExtra("type")); + } else if (intent.hasExtra("global-action")) { + performGlobalAction(intent.getStringExtra("global-action")); } }); } @@ -180,4 +182,8 @@ private static void type(String toType) { arguments.putCharSequence(AccessibilityNodeInfo.ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE, toType); focusedNode.performAction(AccessibilityNodeInfo.ACTION_SET_TEXT, arguments); } + + private static void performGlobalAction(String globalAction) throws NoSuchFieldException, IllegalAccessException { + TermuxAccessibilityService.instance.performGlobalAction((int)AccessibilityService.class.getDeclaredField("GLOBAL_ACTION_" + globalAction).get(null)); + } } From c093de428facbf86e7d630342345c9935033d3ce Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Sat, 28 Feb 2026 03:29:12 +0100 Subject: [PATCH 05/15] Prevent random `NullPointerException` --- app/src/main/java/com/termux/api/apis/AccessibilityAPI.java | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java index 4aa1dd219..75772fe7c 100644 --- a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java +++ b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java @@ -124,6 +124,11 @@ private static String dump() throws TransformerException, ParserConfigurationExc private static void dumpNodeAuxiliary(Document document, Element element, AccessibilityNodeInfo node) { for (int i = 0; i < node.getChildCount(); i++) { AccessibilityNodeInfo nodeChild = node.getChild(i); + // May be faced randomly, see [Benjamin-Loison/android/issues/28#issuecomment-3975714760](https://github.com/Benjamin-Loison/android/issues/28#issuecomment-3975714760) + if (nodeChild == null) + { + continue; + } Element elementChild = document.createElement("node"); elementChild.setAttribute("index", String.valueOf(i)); From f9bc7ff5b519c8b80161704f86abef350d6cec0f Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Sat, 28 Feb 2026 03:49:59 +0100 Subject: [PATCH 06/15] Prevent random crash due to UI root being `null` --- .../com/termux/api/apis/AccessibilityAPI.java | 235 +++++++++--------- 1 file changed, 120 insertions(+), 115 deletions(-) diff --git a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java index 75772fe7c..1db5b294b 100644 --- a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java +++ b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java @@ -47,52 +47,52 @@ public class AccessibilityAPI { public static void onReceive(TermuxApiReceiver apiReceiver, final Context context, Intent intent) { Logger.logDebug(LOG_TAG, "onReceive"); - boolean isAccessibilityEnabled = isAccessibilityServiceEnabled(context, TermuxAccessibilityService.class); - if (!isAccessibilityEnabled) { - Intent accessibilityIntent = new Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS); - accessibilityIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); - context.startActivity(accessibilityIntent); - } - - ResultReturner.returnData(apiReceiver, intent, out -> { - final ContentResolver contentResolver = context.getContentResolver(); - if (intent.hasExtra("dump")) { - out.print(dump()); - } else if (intent.hasExtra("click")) { - click(intent.getIntExtra("x", 0), intent.getIntExtra("y", 0)); - } else if (intent.hasExtra("type")) { - type(intent.getStringExtra("type")); - } else if (intent.hasExtra("global-action")) { + boolean isAccessibilityEnabled = isAccessibilityServiceEnabled(context, TermuxAccessibilityService.class); + if (!isAccessibilityEnabled) { + Intent accessibilityIntent = new Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS); + accessibilityIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); + context.startActivity(accessibilityIntent); + } + + ResultReturner.returnData(apiReceiver, intent, out -> { + final ContentResolver contentResolver = context.getContentResolver(); + if (intent.hasExtra("dump")) { + out.print(dump()); + } else if (intent.hasExtra("click")) { + click(intent.getIntExtra("x", 0), intent.getIntExtra("y", 0)); + } else if (intent.hasExtra("type")) { + type(intent.getStringExtra("type")); + } else if (intent.hasExtra("global-action")) { performGlobalAction(intent.getStringExtra("global-action")); - } - }); - } - - // [The Stack Overflow answer 14923144](https://stackoverflow.com/a/14923144) - public static boolean isAccessibilityServiceEnabled(Context context, Class service) { - AccessibilityManager am = (AccessibilityManager) context.getSystemService(Context.ACCESSIBILITY_SERVICE); - List enabledServices = am.getEnabledAccessibilityServiceList(AccessibilityServiceInfo.FEEDBACK_ALL_MASK); - - for (AccessibilityServiceInfo enabledService : enabledServices) { - ServiceInfo enabledServiceInfo = enabledService.getResolveInfo().serviceInfo; - if (enabledServiceInfo.packageName.equals(context.getPackageName()) && enabledServiceInfo.name.equals(service.getName())) - return true; - } - - return false; - } - - private static void click(int x, int y) { - Path swipePath = new Path(); - swipePath.moveTo(x, y); - GestureDescription.Builder gestureBuilder = new GestureDescription.Builder(); - gestureBuilder.addStroke(new GestureDescription.StrokeDescription(swipePath, 0, 1)); - TermuxAccessibilityService.instance.dispatchGesture(gestureBuilder.build(), null, null); - } - - // The aim of this function is to give a compatible output with `adb` `uiautomator dump`. - private static String dump() throws TransformerException, ParserConfigurationException { - // Create a DocumentBuilder + } + }); + } + + // [The Stack Overflow answer 14923144](https://stackoverflow.com/a/14923144) + public static boolean isAccessibilityServiceEnabled(Context context, Class service) { + AccessibilityManager am = (AccessibilityManager) context.getSystemService(Context.ACCESSIBILITY_SERVICE); + List enabledServices = am.getEnabledAccessibilityServiceList(AccessibilityServiceInfo.FEEDBACK_ALL_MASK); + + for (AccessibilityServiceInfo enabledService : enabledServices) { + ServiceInfo enabledServiceInfo = enabledService.getResolveInfo().serviceInfo; + if (enabledServiceInfo.packageName.equals(context.getPackageName()) && enabledServiceInfo.name.equals(service.getName())) + return true; + } + + return false; + } + + private static void click(int x, int y) { + Path swipePath = new Path(); + swipePath.moveTo(x, y); + GestureDescription.Builder gestureBuilder = new GestureDescription.Builder(); + gestureBuilder.addStroke(new GestureDescription.StrokeDescription(swipePath, 0, 1)); + TermuxAccessibilityService.instance.dispatchGesture(gestureBuilder.build(), null, null); + } + + // The aim of this function is to give a compatible output with `adb` `uiautomator dump`. + private static String dump() throws TransformerException, ParserConfigurationException { + // Create a DocumentBuilder DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); DocumentBuilder builder = factory.newDocumentBuilder(); @@ -103,92 +103,97 @@ private static String dump() throws TransformerException, ParserConfigurationExc Element root = document.createElement("hierarchy"); document.appendChild(root); - AccessibilityNodeInfo node = TermuxAccessibilityService.instance.getRootInActiveWindow(); + AccessibilityNodeInfo node = TermuxAccessibilityService.instance.getRootInActiveWindow(); + // Randomly faced [Benjamin_Loison/Voice_assistant/issues/84#issue-3661682](https://codeberg.org/Benjamin_Loison/Voice_assistant/issues/84#issue-3661682) + if (node == null) { + return ""; + } - dumpNodeAuxiliary(document, root, node); + dumpNodeAuxiliary(document, root, node); // Write as XML TransformerFactory transformerFactory = TransformerFactory.newInstance(); Transformer transformer = transformerFactory.newTransformer(); - transformer.setOutputProperty(OutputKeys.INDENT, "yes"); - transformer.setOutputProperty("{http://xml.apache.org/xslt}indent-amount", "2"); + transformer.setOutputProperty(OutputKeys.INDENT, "yes"); + transformer.setOutputProperty("{http://xml.apache.org/xslt}indent-amount", "2"); DOMSource source = new DOMSource(document); - StringWriter sw = new StringWriter(); + StringWriter sw = new StringWriter(); StreamResult result = new StreamResult(sw); transformer.transform(source, result); - return sw.toString(); - } - - private static void dumpNodeAuxiliary(Document document, Element element, AccessibilityNodeInfo node) { - for (int i = 0; i < node.getChildCount(); i++) { - AccessibilityNodeInfo nodeChild = node.getChild(i); - // May be faced randomly, see [Benjamin-Loison/android/issues/28#issuecomment-3975714760](https://github.com/Benjamin-Loison/android/issues/28#issuecomment-3975714760) - if (nodeChild == null) - { - continue; - } - Element elementChild = document.createElement("node"); - - elementChild.setAttribute("index", String.valueOf(i)); - - elementChild.setAttribute("text", getCharSequenceAsString(nodeChild.getText())); - - String nodeChildViewIdResourceName = nodeChild.getViewIdResourceName(); - elementChild.setAttribute("resource-id", nodeChildViewIdResourceName != null ? nodeChildViewIdResourceName : ""); - - elementChild.setAttribute("class", nodeChild.getClassName().toString()); - - elementChild.setAttribute("package", nodeChild.getPackageName().toString()); - - elementChild.setAttribute("content-desc", getCharSequenceAsString(nodeChild.getContentDescription())); - - elementChild.setAttribute("checkable", String.valueOf(nodeChild.isCheckable())); - - elementChild.setAttribute("checked", String.valueOf(nodeChild.isChecked())); - - elementChild.setAttribute("clickable", String.valueOf(nodeChild.isClickable())); - - elementChild.setAttribute("enabled", String.valueOf(nodeChild.isEnabled())); - - elementChild.setAttribute("focusable", String.valueOf(nodeChild.isFocusable())); - - elementChild.setAttribute("focused", String.valueOf(nodeChild.isFocused())); - - elementChild.setAttribute("scrollable", String.valueOf(nodeChild.isScrollable())); - - elementChild.setAttribute("long-clickable", String.valueOf(nodeChild.isLongClickable())); - - elementChild.setAttribute("password", String.valueOf(nodeChild.isPassword())); - - elementChild.setAttribute("selected", String.valueOf(nodeChild.isSelected())); - - Rect nodeChildBounds = new Rect(); - nodeChild.getBoundsInScreen(nodeChildBounds); - elementChild.setAttribute("bounds", nodeChildBounds.toShortString()); - - elementChild.setAttribute("drawing-order", String.valueOf(nodeChild.getDrawingOrder())); - - elementChild.setAttribute("hint", getCharSequenceAsString(nodeChild.getHintText())); - - element.appendChild(elementChild); + return sw.toString(); + } + + private static void dumpNodeAuxiliary(Document document, Element element, AccessibilityNodeInfo node) { + for (int i = 0; i < node.getChildCount(); i++) { + AccessibilityNodeInfo nodeChild = node.getChild(i); + // May be faced randomly, see [Benjamin-Loison/android/issues/28#issuecomment-3975714760](https://github.com/Benjamin-Loison/android/issues/28#issuecomment-3975714760) + if (nodeChild == null) + { + continue; + } + Element elementChild = document.createElement("node"); + + elementChild.setAttribute("index", String.valueOf(i)); + + elementChild.setAttribute("text", getCharSequenceAsString(nodeChild.getText())); + Logger.logInfo(LOG_TAG, getCharSequenceAsString(nodeChild.getText())); + + String nodeChildViewIdResourceName = nodeChild.getViewIdResourceName(); + elementChild.setAttribute("resource-id", nodeChildViewIdResourceName != null ? nodeChildViewIdResourceName : ""); + + elementChild.setAttribute("class", nodeChild.getClassName().toString()); + + elementChild.setAttribute("package", nodeChild.getPackageName().toString()); + + elementChild.setAttribute("content-desc", getCharSequenceAsString(nodeChild.getContentDescription())); + + elementChild.setAttribute("checkable", String.valueOf(nodeChild.isCheckable())); + + elementChild.setAttribute("checked", String.valueOf(nodeChild.isChecked())); + + elementChild.setAttribute("clickable", String.valueOf(nodeChild.isClickable())); + + elementChild.setAttribute("enabled", String.valueOf(nodeChild.isEnabled())); + + elementChild.setAttribute("focusable", String.valueOf(nodeChild.isFocusable())); + + elementChild.setAttribute("focused", String.valueOf(nodeChild.isFocused())); + + elementChild.setAttribute("scrollable", String.valueOf(nodeChild.isScrollable())); + + elementChild.setAttribute("long-clickable", String.valueOf(nodeChild.isLongClickable())); + + elementChild.setAttribute("password", String.valueOf(nodeChild.isPassword())); + + elementChild.setAttribute("selected", String.valueOf(nodeChild.isSelected())); + + Rect nodeChildBounds = new Rect(); + nodeChild.getBoundsInScreen(nodeChildBounds); + elementChild.setAttribute("bounds", nodeChildBounds.toShortString()); + + elementChild.setAttribute("drawing-order", String.valueOf(nodeChild.getDrawingOrder())); + + elementChild.setAttribute("hint", getCharSequenceAsString(nodeChild.getHintText())); + + element.appendChild(elementChild); dumpNodeAuxiliary(document, elementChild, nodeChild); } - } + } - private static String getCharSequenceAsString(CharSequence charSequence) { - return charSequence != null ? charSequence.toString() : ""; - } + private static String getCharSequenceAsString(CharSequence charSequence) { + return charSequence != null ? charSequence.toString() : ""; + } - private static void type(String toType) { - AccessibilityNodeInfo focusedNode = TermuxAccessibilityService.instance.getRootInActiveWindow().findFocus(AccessibilityNodeInfo.FOCUS_INPUT); + private static void type(String toType) { + AccessibilityNodeInfo focusedNode = TermuxAccessibilityService.instance.getRootInActiveWindow().findFocus(AccessibilityNodeInfo.FOCUS_INPUT); Bundle arguments = new Bundle(); arguments.putCharSequence(AccessibilityNodeInfo.ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE, toType); focusedNode.performAction(AccessibilityNodeInfo.ACTION_SET_TEXT, arguments); - } + } - private static void performGlobalAction(String globalAction) throws NoSuchFieldException, IllegalAccessException { - TermuxAccessibilityService.instance.performGlobalAction((int)AccessibilityService.class.getDeclaredField("GLOBAL_ACTION_" + globalAction).get(null)); - } + private static void performGlobalAction(String globalAction) throws NoSuchFieldException, IllegalAccessException { + TermuxAccessibilityService.instance.performGlobalAction((int)AccessibilityService.class.getDeclaredField("GLOBAL_ACTION_" + globalAction).get(null)); + } } From 23c5fa4a1d56d2db54be8ce7e5aa974d5aa83d04 Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Sat, 28 Feb 2026 17:13:05 +0100 Subject: [PATCH 07/15] Dump UI as UTF-16 for emojis --- app/src/main/java/com/termux/api/apis/AccessibilityAPI.java | 2 ++ 1 file changed, 2 insertions(+) diff --git a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java index 1db5b294b..7968c4239 100644 --- a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java +++ b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java @@ -116,6 +116,8 @@ private static String dump() throws TransformerException, ParserConfigurationExc Transformer transformer = transformerFactory.newTransformer(); transformer.setOutputProperty(OutputKeys.INDENT, "yes"); transformer.setOutputProperty("{http://xml.apache.org/xslt}indent-amount", "2"); + // Necessary to not have surrogate pairs for emojis, see [Benjamin_Loison/Voice_assistant/issues/83#issue-3661619](https://codeberg.org/Benjamin_Loison/Voice_assistant/issues/83#issue-3661619) + transformer.setOutputProperty(OutputKeys.ENCODING, "UTF-16"); DOMSource source = new DOMSource(document); StringWriter sw = new StringWriter(); From a86a997b5d183213c6bf05aacb73ac5a8cdb4866 Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Sat, 28 Feb 2026 17:13:19 +0100 Subject: [PATCH 08/15] Let the ability to use `global-action` with lowercases --- app/src/main/java/com/termux/api/apis/AccessibilityAPI.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java index 7968c4239..ef1be76bd 100644 --- a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java +++ b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java @@ -196,6 +196,6 @@ private static void type(String toType) { } private static void performGlobalAction(String globalAction) throws NoSuchFieldException, IllegalAccessException { - TermuxAccessibilityService.instance.performGlobalAction((int)AccessibilityService.class.getDeclaredField("GLOBAL_ACTION_" + globalAction).get(null)); + TermuxAccessibilityService.instance.performGlobalAction((int)AccessibilityService.class.getDeclaredField("GLOBAL_ACTION_" + globalAction.toUpperCase()).get(null)); } } From 0287008510ffefc1045f04bcea7b868c9ce95132 Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Sat, 28 Feb 2026 17:56:22 +0100 Subject: [PATCH 09/15] Correct speech to text progressive output --- app/src/main/java/com/termux/api/apis/SpeechToTextAPI.java | 1 + 1 file changed, 1 insertion(+) diff --git a/app/src/main/java/com/termux/api/apis/SpeechToTextAPI.java b/app/src/main/java/com/termux/api/apis/SpeechToTextAPI.java index c33d7a31a..a2f5adc22 100644 --- a/app/src/main/java/com/termux/api/apis/SpeechToTextAPI.java +++ b/app/src/main/java/com/termux/api/apis/SpeechToTextAPI.java @@ -171,6 +171,7 @@ public void writeResult(PrintWriter out) throws Exception { return; } else { out.println(s); + out.flush(); } } } From 94c12a214217d126ec6d1fbb5325420c7eb1cf32 Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Sun, 1 Mar 2026 01:42:15 +0100 Subject: [PATCH 10/15] Make TTS write to stdout when one line is said --- .../java/com/termux/api/apis/TextToSpeechAPI.java | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/app/src/main/java/com/termux/api/apis/TextToSpeechAPI.java b/app/src/main/java/com/termux/api/apis/TextToSpeechAPI.java index 2dae2dd1c..653fa56e2 100644 --- a/app/src/main/java/com/termux/api/apis/TextToSpeechAPI.java +++ b/app/src/main/java/com/termux/api/apis/TextToSpeechAPI.java @@ -188,15 +188,16 @@ public void onDone(String utteranceId) { if (!line.isEmpty()) { submittedUtterances++; mTts.speak(line, TextToSpeech.QUEUE_ADD, params, utteranceId); + synchronized (ttsDoneUtterancesCount) { + while (ttsDoneUtterancesCount.get() != submittedUtterances) { + ttsDoneUtterancesCount.wait(); + } + } + out.println("spoken"); + out.flush(); } } } - - synchronized (ttsDoneUtterancesCount) { - while (ttsDoneUtterancesCount.get() != submittedUtterances) { - ttsDoneUtterancesCount.wait(); - } - } } catch (Exception e) { Logger.logStackTraceWithMessage(LOG_TAG, "TTS error", e); } From 0bc2565962f932a935d0584953e07473a380f027 Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Sun, 1 Mar 2026 03:52:15 +0100 Subject: [PATCH 11/15] Add click duration --- app/src/main/java/com/termux/api/apis/AccessibilityAPI.java | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java index ef1be76bd..12120b903 100644 --- a/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java +++ b/app/src/main/java/com/termux/api/apis/AccessibilityAPI.java @@ -59,7 +59,7 @@ public static void onReceive(TermuxApiReceiver apiReceiver, final Context contex if (intent.hasExtra("dump")) { out.print(dump()); } else if (intent.hasExtra("click")) { - click(intent.getIntExtra("x", 0), intent.getIntExtra("y", 0)); + click(intent.getIntExtra("x", 0), intent.getIntExtra("y", 0), intent.getIntExtra("duration", 1)); } else if (intent.hasExtra("type")) { type(intent.getStringExtra("type")); } else if (intent.hasExtra("global-action")) { @@ -82,11 +82,11 @@ public static boolean isAccessibilityServiceEnabled(Context context, Class Date: Wed, 4 Mar 2026 00:18:47 +0100 Subject: [PATCH 12/15] Add `SpeechToTextAPI` `language` string extra --- .../com/termux/api/apis/SpeechToTextAPI.java | 24 ++++++++++++------- 1 file changed, 16 insertions(+), 8 deletions(-) diff --git a/app/src/main/java/com/termux/api/apis/SpeechToTextAPI.java b/app/src/main/java/com/termux/api/apis/SpeechToTextAPI.java index a2f5adc22..71576eef5 100644 --- a/app/src/main/java/com/termux/api/apis/SpeechToTextAPI.java +++ b/app/src/main/java/com/termux/api/apis/SpeechToTextAPI.java @@ -140,14 +140,6 @@ public void onBeginningOfSpeech() { }).setNegativeButton("Cancel", null) // cancel button .create().show(); } - - Intent recognizerIntent = new Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH); - recognizerIntent.putExtra(RecognizerIntent.EXTRA_PROMPT, "Enter shell command"); - recognizerIntent.putExtra(RecognizerIntent.EXTRA_LANGUAGE_MODEL, RecognizerIntent.LANGUAGE_MODEL_FREE_FORM); - recognizerIntent.putExtra(RecognizerIntent.EXTRA_MAX_RESULTS, 10); - recognizerIntent.putExtra(RecognizerIntent.EXTRA_LANGUAGE, "en-US"); - recognizerIntent.putExtra(RecognizerIntent.EXTRA_PARTIAL_RESULTS, true); - mSpeechRecognizer.startListening(recognizerIntent); } @Override @@ -158,6 +150,22 @@ public void onDestroy() { mSpeechRecognizer.destroy(); } + @Override + public int onStartCommand(Intent intent, int flags, int startId) { + Logger.logDebug(LOG_TAG, "onStartCommand"); + + Intent recognizerIntent = new Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH); + recognizerIntent.putExtra(RecognizerIntent.EXTRA_PROMPT, "Enter shell command"); + recognizerIntent.putExtra(RecognizerIntent.EXTRA_LANGUAGE_MODEL, RecognizerIntent.LANGUAGE_MODEL_FREE_FORM); + recognizerIntent.putExtra(RecognizerIntent.EXTRA_MAX_RESULTS, 10); + String language = intent.hasExtra("language") ? intent.getStringExtra("language") : "en-US"; + recognizerIntent.putExtra(RecognizerIntent.EXTRA_LANGUAGE, language); + recognizerIntent.putExtra(RecognizerIntent.EXTRA_PARTIAL_RESULTS, true); + mSpeechRecognizer.startListening(recognizerIntent); + + return super.onStartCommand(intent, flags, startId); + } + @Override protected void onHandleIntent(final Intent intent) { Logger.logDebug(LOG_TAG, "onHandleIntent:\n" + IntentUtils.getIntentString(intent)); From a58e3e14b7a00bd92ff1c582fc5c27dfbff88adf Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Fri, 6 Mar 2026 16:01:14 +0100 Subject: [PATCH 13/15] Correct boolean JSON output type and add `TelephonyManager.SIM_STATE` values --- .../java/com/termux/api/apis/TelephonyAPI.java | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/app/src/main/java/com/termux/api/apis/TelephonyAPI.java b/app/src/main/java/com/termux/api/apis/TelephonyAPI.java index 6a751e6c8..e8df2a0df 100644 --- a/app/src/main/java/com/termux/api/apis/TelephonyAPI.java +++ b/app/src/main/java/com/termux/api/apis/TelephonyAPI.java @@ -198,7 +198,7 @@ public void writeJson(JsonWriter out) throws Exception { { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { - out.name("data_enabled").value(Boolean.toString(manager.isDataEnabled())); + out.name("data_enabled").value(manager.isDataEnabled()); } int dataActivity = manager.getDataActivity(); @@ -383,6 +383,18 @@ public void writeJson(JsonWriter out) throws Exception { break; case TelephonyManager.SIM_STATE_UNKNOWN: simStateString = "unknown"; + break; + case TelephonyManager.SIM_STATE_NOT_READY: + simStateString = "not_ready"; + break; + case TelephonyManager.SIM_STATE_PERM_DISABLED: + simStateString = "perm_disabled"; + break; + case TelephonyManager.SIM_STATE_CARD_IO_ERROR: + simStateString = "card_io_error"; + break; + case TelephonyManager.SIM_STATE_CARD_RESTRICTED: + simStateString = "card_restricted"; break; default: simStateString = Integer.toString(simState); From f38b5ce06e6aff6e2b6476c7732a8b6642c86cd3 Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Fri, 6 Mar 2026 20:40:38 +0100 Subject: [PATCH 14/15] Add NotificationListAPI medias --- .../termux/api/apis/NotificationListAPI.java | 39 ++++++++++++++++++- 1 file changed, 38 insertions(+), 1 deletion(-) diff --git a/app/src/main/java/com/termux/api/apis/NotificationListAPI.java b/app/src/main/java/com/termux/api/apis/NotificationListAPI.java index 388e3520a..d0d5d4e15 100644 --- a/app/src/main/java/com/termux/api/apis/NotificationListAPI.java +++ b/app/src/main/java/com/termux/api/apis/NotificationListAPI.java @@ -15,6 +15,12 @@ import com.termux.api.util.ResultReturner.ResultJsonWriter; import com.termux.shared.logger.Logger; +import android.media.session.MediaSessionManager; +import android.media.MediaMetadata; +import android.media.session.PlaybackState; +import android.media.session.MediaController; +import java.util.List; +import android.content.ComponentName; public class NotificationListAPI { @@ -26,7 +32,11 @@ public static void onReceive(TermuxApiReceiver apiReceiver, final Context contex ResultReturner.returnData(apiReceiver, intent, new ResultJsonWriter() { @Override public void writeJson(JsonWriter out) throws Exception { - listNotifications(context, out); + if (!intent.hasExtra("media")) { + listNotifications(context, out); + } else { + listMedias(context, out); + } } }); } @@ -93,7 +103,34 @@ static void listNotifications(Context context, JsonWriter out) throws Exception out.endArray(); } + static void listMedias(Context context, JsonWriter out) throws Exception { + MediaSessionManager mediaSessionManager = (MediaSessionManager)context.getSystemService(Context.MEDIA_SESSION_SERVICE); + + ComponentName listenerComponent = new ComponentName(NotificationService.get(), NotificationService.class); + List controllers = mediaSessionManager.getActiveSessions(listenerComponent); + + out.beginArray(); + for (MediaController controller : controllers) { + MediaMetadata metadata = controller.getMetadata(); + PlaybackState state = controller.getPlaybackState(); + + if (metadata != null) { + out.beginObject() + .name("packageName").value(controller.getPackageName()) + .name("state").value(state.getState()) + .name("title").value(metadata.getString(MediaMetadata.METADATA_KEY_TITLE)) + .name("artist").value(metadata.getString(MediaMetadata.METADATA_KEY_ARTIST)) + .name("duration").value(metadata.getLong(MediaMetadata.METADATA_KEY_DURATION)) + .name("bufferedPosition").value(state.getBufferedPosition()) + .name("lastPositionUpdateTime").value(state.getLastPositionUpdateTime()) + .name("playbackSpeed").value(state.getPlaybackSpeed()) + .name("position").value(state.getPosition()); + out.endObject(); + } + } + out.endArray(); + } public static class NotificationService extends NotificationListenerService { static NotificationService _this; From 96ff731a7184c29d6f07687af0084dc1e86b3463 Mon Sep 17 00:00:00 2001 From: Benjamin Loison Date: Fri, 6 Mar 2026 22:39:43 +0100 Subject: [PATCH 15/15] Return TermuxNotificationList media state as String --- .../termux/api/apis/NotificationListAPI.java | 33 ++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/app/src/main/java/com/termux/api/apis/NotificationListAPI.java b/app/src/main/java/com/termux/api/apis/NotificationListAPI.java index d0d5d4e15..4428efab4 100644 --- a/app/src/main/java/com/termux/api/apis/NotificationListAPI.java +++ b/app/src/main/java/com/termux/api/apis/NotificationListAPI.java @@ -118,7 +118,7 @@ static void listMedias(Context context, JsonWriter out) throws Exception { if (metadata != null) { out.beginObject() .name("packageName").value(controller.getPackageName()) - .name("state").value(state.getState()) + .name("state").value(getStateString(state.getState())) .name("title").value(metadata.getString(MediaMetadata.METADATA_KEY_TITLE)) .name("artist").value(metadata.getString(MediaMetadata.METADATA_KEY_ARTIST)) .name("duration").value(metadata.getLong(MediaMetadata.METADATA_KEY_DURATION)) @@ -132,6 +132,37 @@ static void listMedias(Context context, JsonWriter out) throws Exception { out.endArray(); } + static String getStateString(int state) { + switch(state) { + case PlaybackState.STATE_BUFFERING: + return "buffering"; + case PlaybackState.STATE_CONNECTING: + return "connecting"; + case PlaybackState.STATE_ERROR: + return "error"; + case PlaybackState.STATE_FAST_FORWARDING: + return "fast_forwarding"; + case PlaybackState.STATE_NONE: + return "none"; + case PlaybackState.STATE_PAUSED: + return "paused"; + case PlaybackState.STATE_PLAYING: + return "playing"; + case PlaybackState.STATE_REWINDING: + return "rewinding"; + case PlaybackState.STATE_SKIPPING_TO_NEXT: + return "skipping_to_next"; + case PlaybackState.STATE_SKIPPING_TO_PREVIOUS: + return "skipping_to_previous"; + case PlaybackState.STATE_SKIPPING_TO_QUEUE_ITEM: + return "skipping_to_queue_item"; + case PlaybackState.STATE_STOPPED: + return "stopped"; + default: + return "unknown"; + } + } + public static class NotificationService extends NotificationListenerService { static NotificationService _this;