Android Full-Stack-Gerätesteuerungsplattform: WebRTC/H.264-Remote-Desktop, UI/OCR/Bildabgleich-Automatisierung, Ein-Klick-MITM, integriertes Frida, Proxy/VPN/frp/P2P-Netzwerk, MCP/Agent, 160+ APIs, ausgelegt für Multi-Geräte-Cluster und technische Bereitstellungen.
Dokumentation | 使用文档 | TELEGRAM | QQ Group | SKILLS | llms-full.txt | 中文版本
FIRERPA ist eine All-in-One-Plattform zur Steuerung von Android-Geräten. Der Server läuft direkt auf dem Gerät, ohne zusätzliche Laufzeitabhängigkeiten; er unterstützt mehrere Android-Generationen und funktioniert mit oder ohne Root. Auf der PC-Seite orchestriert die Python-Client-Bibliothek UI-Automatisierung, Remote-Operationen, Traffic-Mitschnitt, Hook-basiertes Reverse Engineering, Netzwerk-Proxy, verteiltes Networking, KI-Agenten und MCP über einen einzigen Dienst und eine einzige API. Im Vergleich zum Zusammensetzen von Appium, mitmproxy, frida-server, adb, uiautomator2 und Ad-hoc-Skripten und Betriebswerkzeugen bietet FIRERPA eine Quelle an Fähigkeiten, einheitliche Konfiguration, verbundene Workflows und einen Stack, der für den Mehrgeräte-, Langzeit- und Produktionseinsatz ausgelegt ist.
FIRERPA bietet einen browserbasierten Remote-Desktop: Echtzeit-Ansicht und -Steuerung des Geräts ohne Installation eines dedizierten PC-Clients, über LAN oder über Netzwerke hinweg. Streaming unterstützt sowohl MJPEG als auch H.264, mit Software- und Hardware-Kodierungs-Backends. Bildrate (bis zu 60 fps), Auflösungsskalierung, Bitrate und Qualität können an die Gerätefähigkeiten und Netzwerkbedingungen angepasst werden – was die Bandbreite reduziert und die Laufruhe bei schwachen Verbindungen verbessert. WebRTC wird ebenfalls unterstützt, mit konfigurierbaren STUN/TURN-Servern für bessere NAT-Überwindung und geringere Ende-zu-Ende-Latenz in öffentlichen oder gebietsübergreifenden Konfigurationen.
Der Remote-Desktop unterstützt Mehrbenutzer-Gleichzeitzugriff für kollaboratives Debugging, Demos und Schulungen. Bidirektionale Zwischenablage und Live-Audio (Android 10+) sind enthalten, zusammen mit integrierter Terminal-, Drag-and-Drop-Upload- und browserbasierter Dateiansicht und -Download – alles über einen einzigen Port. Die integrierte visuelle Layout-Inspektion hebt Elemente hervor, unterstützt Tab-Navigation, zeigt Koordinaten und RGB-Werte an und exportiert den XML-Layoutbaum, sodass Sie Selektoren und Automatisierungslogik in derselben Benutzeroberfläche validieren können, was den Zyklus von Bildschirm zu Skript verkürzt.
Remote-Desktop und RPC unterstützen Ende-zu-Ende-TLS und dienstzertifikatsbasierte Zugriffskontrolle, mit optionalen benutzerdefinierten WebUI-Login-Passwörtern, um die Exposition in öffentlichen Netzwerken zu reduzieren. Remote-Desktop-Funktionen können auch über WebSocket (Live-Video, Touch, Terminal, Tasten usw.) in Ihre eigenen Web-Apps eingebettet werden, mit allow_origin für Cross-Origin-Integration – geeignet für die Produktisierung der Echtgerätesteuerung.
FIRERPA bietet ein vollständiges selektorbasiertes Automatisierungssystem: Text, resourceId, Beschreibung, scrollbar und andere gängige Matcher, plus Kind-/Geschwister-Verkettung für doppelte Elemente, tiefe Hierarchien oder Steuerelemente ohne eindeutige Attribute. Auf Elementebene: Screenshots, Warten auf Erscheinen/Verschwinden, Eck-/Mittelkoordinaten, Existenzprüfung, Unicode-Eingabe, gestufte Wischbewegungen, Fling-Scrolling, Scrollen bis zum Ende und mehr. Es kann mit anderen Barrierefreiheitsdiensten auf Android 8.0+ koexistieren und verbessert die WebView-Knotenerkennung für hybride Apps.
Der UI Watcher überwacht UI-Änderungen in Echtzeit und führt Klicks, Tasteneingaben oder Zähler aus, wenn Bedingungen zutreffen – nützlich zum automatischen Schließen von Zustimmungen, Update-Aufforderungen, Werbung und anderen Unterbrechungen. Mehrere Selektorbedingungen und Aktivieren/Deaktivieren pro Ereignis werden unterstützt; vorübergehende Bildschirme können gezählt werden.
Virtual Display ist ein Alleinstellungsmerkmal: Erstellen Sie isolierte Hintergrunddisplays auf dem Gerät und führen Sie dort Apps und Automatisierung aus, ohne den Hauptbildschirm zu beeinträchtigen – z. B. automatische Antwort auf einem virtuellen Display, während Sie das Telefon normal nutzen. Die Virtual-Display-API spiegelt die Hauptgeräte-API wider (d.xxx → vd.xxx); Watcher können auf ein virtuelles Display beschränkt werden. Das WebUI unterstützt Mehrdisplay-Ansicht und -Umschaltung im Remote-Desktop – ideal für Hintergrundaufgaben, parallele Arbeit und Mensch-in-der-Schleife plus Maschinenautomatisierung.
Für Szenen ohne Standard-View-Tree (Spiele, benutzerdefinierte UI) bietet FIRERPA OCR und Bildabgleich. OCR unterstützt paddleocr, easyocr und benutzerdefinierte HTTP-Backends; in Clustern kann die Erkennung zentral laufen, anstatt Modelle auf jedem PC zu laden, mit GPU-Beschleunigung und flexiblem Textabgleich. Der Bildabgleich läuft auf dem Gerät (Template oder SIFT), ohne PC-Ressourcen zu verbrauchen; SIFT ist robust gegenüber Rotation, Skalierung und Beleuchtung. Multi-Touch unterstützt Aufnahme, Wiedergabe, programmatischen Aufbau und binäre Persistenz für komplexe Gesten und Druck.
Architektonisch verwendet FIRERPA ein Client/Server-Modell – besser für zentralisierte Planung, Versionierung und Flottensteuerung als On-Device-Script-Runner wie AutoJS; leichter als Appium; stabiler als uiautomator2 in Mehrgeräteszenarien. Die Dokumentation positioniert es als funktionales Superset gängiger Android-Automatisierungsstacks – Automatisierung, Mitschnitt, Hook und Betrieb können in einem Code auf einer Plattform verknüpft werden, ohne Werkzeuge wechseln zu müssen.
FIRERPA bietet Ein-Klick-MITM-Mitschnitt: automatische Systemstammzertifikatsinstallation, Proxy-Einrichtung, Handhabung von Android-Versionsunterschieden und automatische Netzwerkwiederherstellung beim Beenden – kein manuelles Zertifikat oder Proxy-Umschalten. Globaler Mitschnitt, paketweiser Mitschnitt, Live-Anforderungs-/Antwortbearbeitung, gemeinsames mitmweb und vorgeschalteter HTTP-Proxy für internationalen Verkehr werden unterstützt. Der eingebaute QUIC-Downgrade reduziert QUIC-Interferenzen. Der Mitschnitt funktioniert auch dann, wenn PC und Gerät nur einen einzigen FIRERPA-Port gemeinsam nutzen (z. B. ADB-Connect oder frp-Weiterleitung).
Neben Ein-Klick-Skripten ist MITM vollständig API-gesteuert: Installieren/Deinstallieren von System-CAs, kompatibel mit mitmproxy, Fiddler, Charles usw.; Einbetten von Mitschnitt in Automatisierungspipelines zusammen mit UI-Schritten und Frida-Hooks. Ein Windows startmitm.exe ist ohne Python-Installation verfügbar.
