ADB / Android Debug Bridge
In Macro Deck enthaltenSteuere ein Android-Smartphone oder -Tablet per USB oder WLAN: aufwecken, Apps starten, tippen, Text eingeben und Screenshots aufnehmen.
Der Tab Übersicht der Integration ADB / Android Debug Bridge, mit dem Hinweis, ADB in den Einstellungen zu aktivieren
- Ein verbundenes Android-Gerät aufwecken, sperren und neu starten
- Apps starten oder erzwungen beenden und Links auf dem Gerät öffnen
- Tasten, Tippen, Wischen und Text senden
- Screenshots des Gerätebildschirms in einem Ordner speichern
- Geräteereignisse und Variablen für Akku, Bildschirm und Vordergrund-App
Die ADB-Integration steuert Android-Smartphones und -Tablets über die Android Debug Bridge (ADB), dasselbe Werkzeug, das Android-Entwickler verwenden. Macro Deck findet das Programm adb, betreibt den ADB-Server und behält die Geräte im Blick, die per USB angeschlossen oder per WLAN verbunden sind. Auf Wunsch lädt es auch die offiziellen Android Platform-Tools für dich herunter.
Jede Aktion wirkt auf das Gerät, das du in der Aktion auswählst, oder auf das Standardgerät, wenn du Gerät leer lässt. Das Standardgerät ist das, das du mit Als Standard festlegen unter Einstellungen > ADB gewählt hast, oder das einzige angeschlossene Gerät, wenn du keines gewählt hast.
Was du damit machen kannst
- Bildschirm und Energie: das Gerät aufwecken, den Bildschirm ausschalten (so sperrt Android das Gerät) oder es in Android, Recovery oder den Bootloader neu starten.
- Apps und Links: eine App über ihren Paketnamen starten oder erzwungen beenden, etwa
com.spotify.music, und einen Link mit der App öffnen, die das Gerät dafür wählt. - Eingabe: eine Taste wie Home, Back, Volume Up oder Media Play Pause senden, auf einen Punkt des Bildschirms tippen, von einem Punkt zu einem anderen wischen oder Text in das fokussierte Feld eingeben.
- Screenshots: den Bildschirm als PNG-Datei in einem Ordner auf deinem Computer speichern und auf Wunsch den Pfad der Datei in eine Variable schreiben.
Einige Beispiele:
- Eine Taste, die ein Tablet auf deinem Schreibtisch aufweckt und deine Musik-App startet.
- Eine Taste, die Media Play Pause an dein Smartphone sendet.
- Eine Automation auf Gerät verbunden, die auf einem Tablet eine Dashboard-Seite öffnet, sobald du es einsteckst.
Live-Status
Die Integration meldet, wenn ein Gerät verbunden, getrennt oder autorisiert wird, seine Autorisierung verliert, offline geht oder wieder online kommt, sodass Abläufe und Tasten darauf reagieren können. Variablen enthalten die Anzahl verbundener und autorisierter Geräte und für das Standardgerät Modell, Hersteller, Akkustand, ob der Bildschirm an ist, ob der Sperrbildschirm angezeigt wird und welche App im Vordergrund ist. Jedes autorisierte Gerät bekommt außerdem eigene Variablen, benannt nach seinem Modell. Solange die Integration aktiv ist, erscheint der Akku jedes Android-Geräts auch im Akku-Widget.
Die grundlegenden Aktionen (Tasten, Tippen, Wischen, Text, Apps, Links, Neustarts und Screenshots) funktionieren weiter, während Macro Deck gesperrt ist, sodass eine Taste mit einer davon auch an einem gesperrten Computer funktioniert.
Das brauchst du
- Macro Deck 3 unter Windows, macOS oder Linux
- Ein Android-Gerät mit aktiviertem USB-Debugging in den Entwickleroptionen
- Ein USB-Kabel, das Daten überträgt, oder kabelloses Debugging für eine Verbindung per WLAN
- Android Platform-Tools (adb); Macro Deck kann sie unter Einstellungen > ADB herunterladen
- Unter Linux die Berechtigung für deinen Benutzer, auf das USB-Gerät zuzugreifen, meist über eine udev-Regel
So richtest du sie ein
Schritt 1: ADB-Integration einschalten
Klicke in der Seitenleiste auf Integrationen und dann auf ADB / Android Debug Bridge. Die Integration ist aus, bis du den Schalter oben rechts einschaltest. Danach zeigt die Seite ADB ist ausgeschaltet, bis du im nächsten Schritt ADB aktivierst.
Schritt 2: ADB in Macro Deck aktivieren
Öffne Einstellungen > ADB und schalte ADB aktivieren ein. Zeigt ADB-Programm Nicht gefunden, klicke auf Platform-Tools herunterladen. Ein vorhandenes Android SDK oder ein
adbin deinemPATHwird automatisch gefunden, und mit Pfad zur ausführbaren Datei kannst du auf ein anderes verweisen.Schritt 3: USB-Debugging auf dem Gerät aktivieren
Öffne auf dem Smartphone oder Tablet Einstellungen > Über das Telefon und tippe siebenmal auf Build-Nummer, um die Entwickleroptionen freizuschalten. Aktiviere dann USB-Debugging unter Einstellungen > Entwickleroptionen. Wo genau das zu finden ist, unterscheidet sich je nach Hersteller etwas.
Schritt 4: Gerät verbinden und autorisieren
Verbinde das Gerät per USB-Kabel und bestätige USB-Debugging zulassen? auf seinem Bildschirm. Hake Von diesem Computer immer zulassen an, damit es nicht erneut fragt. Das Gerät erscheint dann unter Geräte in Einstellungen > ADB als Bereit. Um dich stattdessen per WLAN zu verbinden, gib unter Über WLAN verbinden IP-Adresse und Port des Geräts ein, zum Beispiel
192.168.1.20:5555.Schritt 5: Standardgerät wählen
Sind mehrere Geräte angeschlossen, klicke auf Als Standard festlegen neben dem Gerät, das deine Aktionen verwenden sollen, wenn du Gerät leer lässt. Ein einzelnes Gerät wird automatisch verwendet.
Schritt 6: ADB-Aktion zu einer Taste hinzufügen
Stelle auf der Seite Deck sicher, dass das Deck entsperrt ist (die Schaltfläche oben rechts zeigt Sperren), und klicke auf eine Taste. Der Editor öffnet sich mit ausgewähltem Kurzer Druck. Klicke auf + Aktion hinzufügen, wähle links im Dialog Aktion hinzufügen ADB / Android Debug Bridge und such dir eine Aktion aus, zum Beispiel Gerät aufwecken oder App starten. Fülle ihre Felder aus, etwa Paket bei App starten, und lass Gerät leer, um das Standardgerät zu verwenden. Die Kategorie erscheint nur, solange die Integration eingeschaltet ist.
Schritt 7: Taste drücken
Klicke auf Speichern und drücke die Taste auf deinem Deck. Passiert nichts, sieh unter Integrationen nach einem Hinweis, etwa Keine Geräte verbunden oder einem Gerät, das noch autorisiert werden muss.
Aktionen11
Lege sie auf eine Taste oder führe sie in einem Ablauf aus.
- Gerät aufwecken
- Weckt den Bildschirm des Geräts auf.
- Ruhezustand / Bildschirm sperren
- Schaltet den Bildschirm des Geräts aus; so sperrt Android ein Gerät.
- App starten
- Startet eine App über ihren Paketnamen oder holt sie in den Vordergrund.
- App erzwungen beenden
- Beendet eine App über ihren Paketnamen erzwungen.
- Link öffnen
- Öffnet eine URI auf dem Gerät, genau wie das Antippen eines Links.
- Text eingeben
- Gibt Text in das gerade fokussierte Feld auf dem Gerät ein.
- Taste senden
- Sendet ein einzelnes Android-Tastenereignis, etwa Home, Back, Volume Up oder Media Next.
- Tippen
- Tippt an den angegebenen X- und Y-Koordinaten auf den Bildschirm.
- Wischen
- Wischt über eine festgelegte Dauer von einem Punkt des Bildschirms zu einem anderen.
- Gerät neu starten
- Startet das Gerät im Modus Normal, Recovery oder Bootloader neu.
- Screenshot aufnehmen
- Nimmt den Bildschirm des Geräts auf und speichert ihn als PNG-Datei in einem Ordner, auf Wunsch mit dem Pfad in einer Variable.
Auslöser6
Eine Taste oder ein Ablauf kann auf diese Ereignisse reagieren.
- Gerät verbunden
- Ein Android-Gerät wurde eingesteckt, oder Macro Deck hat es zum ersten Mal erkannt.
- Gerät getrennt
- Ein Android-Gerät wurde abgesteckt, oder Macro Deck hat es aus den Augen verloren.
- Gerät autorisiert
- Die Autorisierungsabfrage wurde auf dem Gerät bestätigt.
- Gerät wurde nicht mehr autorisiert
- Bei einem zuvor autorisierten Gerät muss die Autorisierungsabfrage erneut bestätigt werden.
- Gerät wieder online
- Ein autorisiertes Gerät ist wieder erreichbar.
- Gerät offline gegangen
- Ein Gerät, das erreichbar war, ist nicht mehr erreichbar.
Variablen11
Zeige diese Werte auf Tasten und Widgets an oder nutze sie in Bedingungen.
adb_connected_device_count- Die Anzahl angeschlossener Android-Geräte.
adb_authorized_device_count- Die Anzahl der Geräte, die online und autorisiert sind.
adb_device_connected- Ob das Standardgerät verbunden ist.
adb_device_authorized- Ob das Standardgerät diesen Computer autorisiert hat.
adb_device_model- Das Modell des Standardgeräts.
adb_device_manufacturer- Der Hersteller des Standardgeräts.
adb_device_battery_level- Der Akkustand des Standardgeräts in Prozent.
adb_device_screen_on- Ob der Bildschirm des Standardgeräts an ist.
adb_device_locked- Ob das Standardgerät seinen Sperrbildschirm zeigt.
adb_device_foreground_app- Der Paketname der App im Vordergrund des Standardgeräts.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Verbunden, autorisiert, Modell und Akkustand jedes autorisierten Geräts.
<device>ist das Modell des Geräts in Kleinbuchstaben, Ziffern und Unterstrichen; für weitere Geräte desselben Modells wird_2,_3und so weiter angehängt.
Häufige Fragen
Brauche ich Android Studio oder das Android SDK?
Nein. Macro Deck braucht nur das Programm adb aus den Android Platform-Tools. Klicke unter Einstellungen > ADB auf Platform-Tools herunterladen, und Macro Deck lädt das offizielle Paket von Google herunter, etwa 15 MB, für den eigenen Gebrauch. Eine vorhandene Installation wird automatisch gefunden.
Kann ich ein Gerät per WLAN steuern?
Ja. Aktiviere kabelloses Debugging auf dem Gerät und gib seine IP-Adresse und seinen Port unter Über WLAN verbinden in Einstellungen > ADB ein. Macro Deck koppelt Geräte nicht selbst: Kopple das Gerät ab Android 11 zuerst mit diesem Computer, oder stelle es per USB mit adb tcpip auf Debugging über das Netzwerk um. Sonst lehnt das Gerät die Verbindung ab.
Warum schlägt eine Aktion fehl, weil kein Gerät gefunden wurde?
Lässt du Gerät leer, verwendet die Aktion das Standardgerät. Hast du keines gewählt und sind mehrere Geräte angeschlossen, gibt es kein Standardgerät; wähle dann ein Gerät in der Aktion oder klicke unter Einstellungen > ADB auf Als Standard festlegen. Prüfe außerdem, ob das Gerät Bereit zeigt und nicht Nicht autorisiert.
Gibt es eine eigene Aktion zum Sperren?
Nein. Android hat keinen eigenen Sperrbefehl. Ruhezustand / Bildschirm sperren schaltet den Bildschirm aus, was das Gerät genauso sperrt wie die Ein/Aus-Taste.
Beeinflusst die ADB-Integration andere Programme, die ADB nutzen?
Macro Deck nutzt den normalen ADB-Server, Programme wie Android Studio teilen ihn sich also. ADB-Server neu starten unter Einstellungen > ADB trennt kurz auch deren Geräte. Macro Deck lässt den Server beim Beenden weiterlaufen, außer du aktivierst ADB-Server beim Beenden von Macro Deck stoppen.
Warum zeigt das Gerät „Keine Berechtigung für den Zugriff auf dieses Gerät“?
Dem Computer fehlt die Berechtigung, per USB mit dem Gerät zu kommunizieren. Installiere unter Linux die udev-Regeln der Platform-Tools; installiere unter Windows den USB-Treiber des Herstellers für das Gerät.
Mehr in „Dein Computer“
System
In Macro Deck enthaltenSteuere deinen Computer von deinem Deck aus: Apps, Lautstärke, Befehle, Benachrichtigungen, Ruhemodus und Herunterfahren.
Tastatur
In Macro Deck enthaltenDrücke Tastenkürzel, tippe Text und führe Tastenfolgen auf deinem Computer per Taste aus.
Maus
In Macro Deck enthaltenKlicke, bewege den Zeiger, ziehe und scrolle auf deinem Computer per Taste.
Steam
In Macro Deck enthaltenStarte und beende Steam-Spiele und zeige, was du spielst, deine Freunde und deine Bibliothek auf deinem Deck.