pranshuchittora/simvynUniversal mobile devtool für Agents & Humans – steuern Sie iOS-Simulatoren, Android-Emulatoren und echte Geräte von einem einzigen Dashboard und CLI aus
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12264/e081fb1d4bcaa6556ff10e722d1ff25449288b68ce1aad9ac3b5ecc047ccf5fb.png" width="180" alt="simvyn" /> </p> <h1 align="center">simvyn</h1> <p align="center"> Universelles Mobile-Devtool — steuere iOS-Simulatoren, Android-Emulatoren und echte Geräte über ein einziges Dashboard und eine CLI </p> <p align="center"> <a href="https://www.npmjs.com/package/simvyn"><img src="https://img.shields.io/npm/v/simvyn?color=cb3837&logo=npm" alt="npm version" /></a> <a href="https://www.npmjs.com/package/simvyn"><img src="https://img.shields.io/npm/dm/simvyn?color=cb3837&logo=npm" alt="npm downloads" /></a> <a href="https://github.com/pranshuchittora/simvyn/actions/workflows/ci.yml"><img src="https://github.com/pranshuchittora/simvyn/actions/workflows/ci.yml/badge.svg" alt="CI status" /></a> <a href="https://github.com/pranshuchittora/simvyn/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/simvyn?color=blue" alt="MIT License" /></a> <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/simvyn?color=5FA04E&logo=node.js&logoColor=white" alt="Node version" /></a> </p> <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12264/bff45a80ced8a6cba77f5bab23f21607fb310862cbc838179d9ce714a1d4d6b6.png" alt="simvyn dashboard" /> </p> <p align="center"> <img src="https://raw.githubusercontent.com/pranshuchittora/simvyn/main/assets/demo.gif" alt="simvyn demo" /> </p> ## Inhaltsverzeichnis - [Schnellstart](#quick-start) - [Installation](#installation) - [KI-Coding-Agents](#ai-coding-agents) - [Funktionen](#features) - [Modul-Präsentationen](#module-showcases) - [Sammlungsanleitung](#collections-guide) - [CLI-Referenz](#cli-reference) - [Funktionsweise](#how-it-works) - [Unterstützte Plattformen](#supported-platforms) - [Mitwirken](#contributing) - [Sicherheit](#security) - [Lizenz](#license) ## Schnellstart```bash npx simvyn ``` Startet den lokalen Server, öffnet das Web-Dashboard in deinem Browser und erkennt automatisch alle verbundenen Simulatoren, Emulatoren und per USB angeschlossenen physischen Geräte. ## Installation **Globale Installation:**```bash npm install -g simvyn ``` **Einmalige Verwendung (keine Installation):**```bash npx simvyn ``` **Voraussetzungen:** - Node.js 22 (22.14.0+) oder 24+ - macOS (vollständige iOS- + Android-Unterstützung) oder Linux (nur Android) ## KI-Coding-Agents simvyn enthält einen portablen [Agent Skill](https://github.com/pranshuchittora/simvyn/blob/main/skills/simvyn/SKILL.md) zum Entdecken von Geräten, Ausführen unterstützter CLI-Befehle, Erfassen von Screenshots, Inspizieren von App-Daten und Sammeln begrenzter Logs. Er lehrt einen Agenten, die CLI mit expliziten Geräte-IDs und Plattformgrenzen zu verwenden. Der Skill nutzt das vorhandene Terminal-Tool des Agenten; er registriert keinen MCP-Server oder neue Agent-Tools. **Pi:** Das npm-Paket ist ein [Pi-Paket](https://pi.dev/packages/simvyn). Zusammen mit dem Skill fügt es die Tools `simvyn`, `simvyn_screenshot`, `simvyn_logs` und `simvyn_record` hinzu, einen `/simvyn`-Befehl, der das Dashboard ausführt, sowie die Prompt-Vorlagen `/simvyn-repro`, `/simvyn-screen` und `/simvyn-logs`. Es erfordert Pi 0.74 oder neuer:```bash pi install npm:simvyn ``` **Andere kompatible Agents:** Installiere den portablen Skill von GitHub, wähle deinen Agent aus und installiere die simvyn CLI separat:```bash npm install -g simvyn npx skills add pranshuchittora/simvyn --skill simvyn --agent codex --yes ``` Der GitHub-Befehl erfordert, dass diese Skill-Dateien im Standard-Branch vorhanden sind; der Pi-Befehl erfordert die Pi-Ressourcen im veröffentlichten npm-Release. Für unveröffentlichte Änderungen verwende die [Anweisungen zum lokalen Checkout](https://github.com/pranshuchittora/simvyn/blob/main/docs/agents.md#test-an-unreleased-checkout). Siehe den [Leitfaden zur Agent-Einrichtung und zum Workflow](https://github.com/pranshuchittora/simvyn/blob/main/docs/agents.md) für den mitgelieferten Launcher, unterstützte Ausgaben, nichtinteraktiven Betrieb und aktuelle Einschränkungen. Ein kompakter [Dokumentationsindex](https://github.com/pranshuchittora/simvyn/blob/main/llms.txt) ist ebenfalls für Tools verfügbar, die Dokumentations-URLs akzeptieren. ## Funktionen - **Geräteverwaltung** — Simulatoren, Emulatoren und physische Geräte entdecken, starten, herunterfahren, löschen, erstellen und klonen mit Favoriten-Pinning - **App-Verwaltung** — Apps installieren, starten, beenden, deinstallieren per Drag-and-Drop oder CLI - **Log-Viewer** — Echtzeit-Streaming mit Level-Filterung, Suchen-in-Seite (Cmd+F), Regex-Suche, Paginierung und Export - **Standortsimulation** — GPS-Koordinaten festlegen, GPX/KML-Routen mit Geschwindigkeitssteuerung abspielen, Favoriten speichern - **Geräteeinstellungen** — Dunkelmodus, Locale, Ausrichtung, Berechtigungen, Statusleisten-Overrides, Barrierefreiheits-Presets - **Screenshots und Aufzeichnung** — Screenshots aufnehmen und Bildschirmvideos mit Verlauf aufzeichnen - **Deep Links** — URLs und benutzerdefinierte Schemata öffnen, Favoriten pro App speichern - **Datenbank-Inspektor** — SQLite-Tabellen durchsuchen, SQL-Abfragen ausführen, SharedPreferences und NSUserDefaults anzeigen - **Datei-Browser** — App-Sandboxes durchsuchen, Dateien hoch- und herunterladen, Text inline bearbeiten - **Push-Benachrichtigungen** — JSON-Payloads verfassen, an iOS-Simulatoren senden, Vorlagenbibliothek - **Sammlungen** — Geräteaktionen in wiederverwendbare Sequenzen bündeln, auf mehrere Geräte gleichzeitig anwenden - **Absturzprotokolle** — iOS-Diagnoseberichte und Android logcat/tombstone-Abstürze - **Zwischenablage** — Geräte-Zwischenablageinhalte lesen und schreiben - **Medien** — Fotos und Videos in Kamera-Rollen und Galerien von Geräten übertragen - **Tool-Einstellungen** — Serverkonfiguration, Speicherverwaltung, Diagnose und Debug-Berichte - **Unterstützung für echte Geräte** — Physische Android- und iOS-Geräte per USB mit automatischer Erkennung verbinden - **Web-Dashboard** — Apple Liquid Glass Design mit Befehlspalette, Tastaturnavigation - **Vollständige CLI** — Jede Funktion funktioniert headless über `simvyn <command>` ## Modul-Showcases ### Geräteverwaltung Entdecke alle verbundenen iOS-Simulatoren, Android-Emulatoren und USB-verbundenen physischen Geräte in einer einheitlichen Liste. Starte, fahre herunter und lösche Geräte, ohne Xcode oder Android Studio zu berühren. Erstelle neue iOS-Simulatoren durch Auswahl eines Gerätetyps und einer Runtime oder klone einen vorhandenen, um schnell Duplikate zu erstellen. Physische Geräte erscheinen automatisch beim Anschließen und werden im Geräteauswahl separat gruppiert. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/2b85641878f6015c248311700a1a87a20476ade6c930273a3e47f288a82d6d2e.png" alt="Device Management" width="700" /></p> - Alle verfügbaren Simulatoren, Emulatoren und physischen Geräte plattformübergreifend auflisten - Geräte mit einem Klick oder CLI-Befehl starten, herunterfahren und löschen - Neue iOS-Simulatoren mit Gerätetyp- und Runtime-Auswahl erstellen - Vorhandene Simulatoren klonen und umbenennen - Favorisierte Geräte oben in der Geräteauswahl anheften - Echtzeit-Gerätestatus-Updates über WebSocket ### App-Verwaltung Installiere, starte, beende und deinstalliere Apps auf jedem verbundenen Gerät. Ziehe IPA-, APK- oder iOS-Simulator-.app-Bundles direkt per Drag-and-Drop auf das Dashboard. Zeige detaillierte App-Informationen an und lösche App-Daten ohne manuelle adb- oder simctl-Befehle. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/17757b1ca8ddd41d43ac3a159260598308da6c3f759e1c9d730f61498e18ce8a.png" alt="App Management" width="700" /></p> - Drag-and-Drop-Installation von IPA, APK und iOS-Simulator-.app - Apps per Bundle-ID starten, beenden und deinstallieren - App-Details einschließlich Version, Größe und Berechtigungen anzeigen - App-Daten auf Android-Geräten löschen - Alle installierten Apps mit Suchfilter auflisten ### Log-Viewer Streame Geräteprotokolle in Echtzeit mit leistungsstarker Filterung. Filtere nach Log-Level, suche mit Regex-Mustern und filtere nach Prozessname. Verwende Suchen-in-Seite (Cmd+F), um bestimmte Einträge hervorzuheben, ohne den umgebenden Kontext auszublenden. Exportiere gefilterte Protokolle zum Teilen oder Archivieren. Paginierter Verlauf ermöglicht das Zurückscrollen durch Tausende von Einträgen ohne Leistungsprobleme. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/b909b3515637b4059ebf210c56599f2f022506f09ee35a11e812bd8368d3750e.png" alt="Log Viewer" width="700" /></p> - Echtzeit-Log-Streaming über WebSocket - Filter nach Level: debug, info, warning, error, fatal - Suchen-in-Seite (Cmd+F) mit Trefferhervorhebung, Navigation und Zähler - Regex-Suche und Filterung nach Prozessname - Paginierter Verlauf mit virtuellem Scrolling - Gefilterte Protokolle in Datei exportieren - Log-Streaming pausieren/fortsetzen unter Beibehaltung des Zustands über Löschvorgänge hinweg ### Standort Lege präzise GPS-Koordinaten auf jedem Gerät über eine interaktive Karte oder manuelle Eingabe fest. Spiele GPX- und KML-Routendateien mit anpassbarer Geschwindigkeitssteuerung ab. Speichere häufig verwendete Standorte als Favoriten für schnellen Zugriff. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/47842dfa878ffbc80bd5bb32d83e820e7ed7dd56a4d63368ca6e823ef72889d4.png" alt="Location" width="700" /></p> - Interaktive Karte mit Klick-zum-Festlegen von Koordinaten - GPX- und KML-Routendatei-Wiedergabe mit Geschwindigkeitssteuerung - Favoriten-Standorte pro Gerät gespeichert - Standortübertragung auf mehrere Geräte - Reverse-Geocoding für menschenlesbare Adressen ### Geräteeinstellungen Schalte den Dunkelmodus um, ändere die Locale, drehe die Geräteausrichtung (Android), verwalte App-Berechtigungen und überschreibe das Erscheinungsbild der Statusleiste. Wende Barrierefreiheits-Presets an, um deine App unter verschiedenen Bedingungen zu testen. Alle Einstellungsänderungen werden sofort auf dem Zielgerät wirksam. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/d3f6a33c17b773560072f7b94b71abd5ebc82786c073bdeb6d25f828c3f214fa.png" alt="Device Settings" width="700" /></p> - Dunkel-/Hellmodus umschalten - Geräte-Locale ändern - App-Berechtigungen verwalten - Statusleiste überschreiben (Uhrzeit, Batterie, Signal) - Barrierefreiheits-Presets (Fettdruck, Kontrast erhöhen, Inhaltsgröße) ### Screenshots und Aufzeichnung Nimm Screenshots auf und zeichne Bildschirmvideos auf jedem Gerät auf. Alle Aufnahmen werden mit Zeitstempeln gespeichert und in einem durchsuchbaren Verlauf organisiert. Lade Aufnahmen direkt vom Dashboard herunter oder lösche sie. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/58ed8f25d148ed53f39066e42be730f255235dbec47539bbec826c455cba7936.png" alt="Screenshots and Recording" width="700" /></p> - Screenshot-Aufnahme mit einem Klick - Bildschirmaufzeichnung mit Start-/Stopp-Steuerung - Zeitgestempelte Aufnahmehistorie - Aufnahmen vom Dashboard herunterladen und löschen ### Deep Links Öffne URLs und benutzerdefinierte URI-Schemata auf jedem Gerät. Speichere häufig verwendete Deep Links als Favoriten, organisiert nach App. Teste die Deep-Link-Verarbeitung deiner App, ohne URLs manuell in ein Terminal einzutippen. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/3a990ef7c74f83c93b63c1654f74b3fa952b0b41abd31fe688cdaf2e29570f62.png" alt="Deep Links" width="700" /></p> - Beliebige URL oder benutzerdefiniertes Schema auf einem Gerät öffnen - Favoriten-Deep-Links pro App speichern - Link-Verlauf mit Sortierung nach Neueste zuerst - Funktioniert mit iOS und Android ### Datenbank-Inspektor Durchsuche SQLite-Datenbanken innerhalb der Sandbox jeder App. Zeige Tabellenschemata an, führe beliebige SQL-Abfragen aus und inspiziere SharedPreferences (Android) oder NSUserDefaults (iOS). Bearbeite Werte inline, ohne Skripte zu schreiben. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/4884b688dbbee5f1a34b0454950f4d6562e74efdbbb3b84ca5c626835b4b7d37.png" alt="Database Inspector" width="700" /></p> - SQLite-Tabellen mit sortierbaren Spalten durchsuchen - Beliebige SQL-Abfragen ausführen - SharedPreferences und NSUserDefaults anzeigen und bearbeiten - Inline-Zellenbearbeitung mit Typerkennung ### Datei-Browser Durchsuche das Sandbox-Dateisystem jeder installierten App. Navigiere durch Verzeichnisse, lade Dateien hoch und herunter und bearbeite Textdateien inline. Übertrage Dateien zwischen deinem Rechner und dem Gerät ohne manuelle adb pull/push-Befehle. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/7b7ba540ad5de8b575da4f9bb28694dc68f5ffce51225a388788b8ef2f4767a0.png" alt="File Browser" width="700" /></p> - App-Sandbox-Verzeichnisse durchsuchen - Dateien hoch- und herunterladen - Inline-Bearbeitung von Textdateien - Funktioniert mit iOS- und Android-App-Containern ### Push-Benachrichtigungen Verfasse JSON-Push-Benachrichtigungs-Payloads und sende sie an iOS-Simulatoren. Verwende die integrierte Vorlagenbibliothek als Ausgangspunkt oder schreibe Payloads von Grund auf neu. Echtzeit-JSON-Validierung hebt Fehler vor dem Senden hervor. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/f640654be67c24c7248806987e62908316407c18648fc145109118f260443f7d.png" alt="Push Notifications" width="700" /></p> - Push-Payloads verfassen und an iOS-Simulatoren senden - Integrierte Payload-Vorlagenbibliothek - Echtzeit-JSON-Validierung - Bestimmte Apps per Bundle-ID ansprechen ### Sammlungen Erstelle wiederverwendbare Sets von Geräteaktionen und wende sie gleichzeitig auf mehrere Geräte an. Sammlungen bündeln Schritte wie das Festlegen des Standorts, das Umschalten des Dunkelmodus und das Installieren einer App in einen einzigen wiederholbaren Workflow. Drei Starter-Presets werden mit simvyn mitgeliefert, um dir den Einstieg zu erleichtern. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/fbf2ddbba1d3725321c80a914bf5b71ea6a2fc605fddbb73abd0b28385488af6.png" alt="Collections" width="700" /></p> - Benannte Sammlungen erstellen, duplizieren und verwalten - Kategorisierten Aktionskatalog über alle Module durchsuchen - Drag-and-Drop-Neuanordnung von Schritten - Auf mehrere Geräte mit Kompatibilitätsprüfung anwenden - Drei integrierte Starter-Presets ### Absturzprotokolle Zeige iOS-Diagnoseberichte (.ips-Dateien) und Android-Absturzprotokolle aus logcat- und tombstone-Dumps an. Durchsuche Absturzeinträge mit Zeitstempeln und Prozessinformationen. Inspiziere vollständige Absturzdetails, ohne dich durch Gerätedateisysteme zu graben. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/8f74a799448050bc37eace1d43865b13f3f47a0997c01dba650fd21e94f09ebf.png" alt="Crash Logs" width="700" /></p> - Parsing von iOS-Diagnoseberichten (.ips) - Android-logcat-Absturzgruppierung nach PID und Tag - Abruf von Android-tombstone-Dumps - Zeitgestempelte Absturzliste mit Detailansicht ### Zwischenablage Lies und schreibe die Geräte-Zwischenablage vom Dashboard oder CLI aus. Nützlich, um schnell Testdaten in Apps einzufügen oder zu inspizieren, was eine App kopiert hat. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/db889032abeb5f1d511dcfeb8c06c215bda851436f198a63db97f595b50853d6.png" alt="Clipboard" width="700" /></p> - Aktuelle Zwischenablageinhalte lesen - Text in die Geräte-Zwischenablage schreiben - Funktioniert mit iOS-Simulatoren und Android-Emulatoren ### Medien Übertrage Fotos und Videos direkt in die Kamera-Rolle oder Galerie eines Geräts. Ziehe Dateien auf das Dashboard, um sie ohne Kabel, E-Mail oder Cloud-Übertragungen einzufügen. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/c63ce5411dc17b5d329c2af381c035d86164f5544928b0c76fe7d05346473561.png" alt="Media" width="700" /></p> - Fotos und Videos per Drag-and-Drop zur Gerätegalerie hinzufügen - Unterstützt große Dateien bis zu 500 MB - Funktioniert mit iOS-Simulatoren und Android-Emulatoren ### Tool-Einstellungen Konfiguriere den simvyn-Server, verwalte den Speicher und zeige Diagnosen an. Enthält einen Debug-Berichtsgenerator zum Einreichen von Problemen. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/7ba043d473d21d4bb5477582539ffd9a4c57600ec20c22ee9d7e63146cbbfbb2.png" alt="Tool Settings" width="700" /></p> - Konfiguration von Server-Port, Auto-Öffnen und Abfrageintervall - Speichernutzungsübersicht mit Datenlöschoption - Diagnose: Xcode-Version, devicectl-Verfügbarkeit, adb-Version - Debug-Bericht mit einem Klick zum Melden von Fehlern ## Sammlungs-Leitfaden Sammlungen ermöglichen es dir, mehrere Geräteaktionen in eine wiederverwendbare Sequenz zu bündeln und sie mit einem Klick auf jede Kombination von Geräten anzuwenden. ### Eine Sammlung erstellen Öffne das Sammlungen-Panel über die Seitenleiste. Klicke auf **Neue Sammlung** und gib ihr einen Namen. Die Sammlung startet leer — du fügst Schritte aus dem Aktionskatalog hinzu. ### Schritte hinzufügen Klicke auf **Schritt hinzufügen**, um den kategorisierten Aktionskatalog zu durchsuchen. Aktionen sind nach Modul organisiert — Geräteeinstellungen, Standort, App-Verwaltung und mehr. Wähle eine Aktion aus, konfiguriere ihre Parameter inline (Koordinaten, Bundle-IDs, Umschaltwerte), und sie erscheint in deiner Sammlung. Ziehe Schritte, um sie neu anzuordnen. ### Eine Sammlung anwenden Klicke auf **Anwenden**, um das Anwenden-Modal zu öffnen. Wähle ein oder mehrere Zielgeräte aus der Geräteliste. Eine Kompatibilitätsübersicht zeigt an, welche Schritte auf inkompatiblen Plattformen übersprungen werden (zum Beispiel iOS-only-Aktionen auf einem Android-Gerät). Drücke **Cmd+Enter**, um auszuführen. Eine Live-Statusmatrix zeigt den Fortschritt pro Schritt und pro Gerät in Echtzeit an. ### Integration in die Befehlspalette Gespeicherte Sammlungen erscheinen in der Befehlspalette (**Cmd+K**). Suche eine Sammlung nach Namen und wende sie direkt mit dem Geräteauswähler an — kein Navigieren zum Sammlungen-Panel erforderlich. ### Starter-Sammlungen Drei integrierte Presets werden mit simvyn mitgeliefert: - **Dunkelmodus + Japanische Locale** — Aktiviert den Dunkelmodus und setzt die Locale auf Japanisch - **Screenshot-Einrichtung** — Konfiguriert Statusleisten-Overrides für saubere App-Store-Screenshots - **Gerätezustand zurücksetzen** — Löscht den Standort, setzt Einstellungen zurück und löscht App-Daten ### CLI-Nutzung```bash simvyn collections list # List all collections simvyn collections apply <name> <devices...> # Apply a collection to devices ``` ## CLI-Referenz Jede Funktion ist über die Kommandozeile zugänglich. Führe `simvyn` ohne Argumente aus, um das Dashboard zu starten, oder verwende einen der unten aufgeführten Befehle für den Headless-Betrieb. | Befehl | Beschreibung | | ------------------------------------------------- | ------------------------------------------ | | `simvyn` | Dashboard starten (Standard) | | `simvyn device list` | Alle Geräte auflisten | | `simvyn device boot <device>` | Ein Gerät booten | | `simvyn device shutdown <device>` | Ein Gerät herunterfahren | | `simvyn device erase <device>` | Geräteinhalt und -einstellungen löschen | | `simvyn device create <name> <type> <runtime>` | Einen neuen iOS-Simulator erstellen | | `simvyn device clone <device> <name>` | Einen iOS-Simulator klonen | | `simvyn device rename <device> <name>` | Einen iOS-Simulator umbenennen | | `simvyn device delete <device>` | Einen iOS-Simulator löschen | | `simvyn location set <device> <lat> <lng>` | GPS-Koordinaten festlegen | | `simvyn location route <device> <file>` | Eine GPX/KML-Route abspielen | | `simvyn location clear <device>` | Simulierten Standort löschen | | `simvyn app list <device>` | Installierte Apps auflisten | | `simvyn app install <device> <path>` | Eine IPA, APK oder iOS-Simulator-.app installieren | | `simvyn app uninstall <device> <bundle-id>` | Eine App deinstallieren | | `simvyn app launch <device> <bundle-id>` | Eine App starten | | `simvyn app terminate <device> <bundle-id>` | Eine App beenden | | `simvyn app info <device> <bundle-id>` | App-Details anzeigen | | `simvyn app clear-data <device> <bundle-id>` | App-Daten löschen (Android) | | `simvyn logs <device>` | Gerätelogs streamen | | `simvyn screenshot <device>` | Einen Screenshot aufnehmen | | `simvyn record <device>` | Den Bildschirm aufzeichnen | | `simvyn link <device> <url>` | Einen Deep Link öffnen | | `simvyn push <device>` | Eine Push-Benachrichtigung senden | | `simvyn fs ls <device> <bundle-id> [path]` | Dateien in der App-Sandbox auflisten | | `simvyn fs pull <device> <bundle-id> <path>` | Eine Datei herunterladen | | `simvyn fs push <device> <bundle-id> <src> <dst>` | Eine Datei hochladen | | `simvyn db list <device> <bundle-id>` | Datenbanken auflisten | | `simvyn db query <device> <bundle-id> <db> <sql>` | Eine SQL-Abfrage ausführen | | `simvyn db prefs <device> <bundle-id>` | SharedPreferences / NSUserDefaults anzeigen | | `simvyn keychain add <device> <cert>` | Ein Root-Zertifikat hinzufügen | | `simvyn keychain reset <device>` | Den Keychain zurücksetzen | | `simvyn collections list` | Alle Sammlungen auflisten | | `simvyn collections show <id>` | Sammlungsdetails anzeigen | | `simvyn collections create <name>` | Eine neue Sammlung erstellen | | `simvyn collections delete <id>` | Eine Sammlung löschen | | `simvyn collections duplicate <id>` | Eine Sammlung duplizieren | | `simvyn collections apply <name> <devices...>` | Eine Sammlung auf Geräte anwenden | | `simvyn settings orientation <device> <orient>` | Geräteausrichtung festlegen (Android) | ## Funktionsweise simvyn kapselt `xcrun simctl` (iOS-Simulatoren), `xcrun devicectl` (physische iOS-Geräte) und `adb` (Android) hinter einer einheitlichen Schnittstelle. Kein SDK erforderlich — funktioniert mit jeder App, keine Codeänderungen nötig. Die Architektur basiert auf einem Modulsystem, bei dem jede Funktion (Standort, Logs, App-Verwaltung usw.) ein eigenständiges Plugin ist, das seine eigenen API-Routen, CLI-Befehle und WebSocket-Handler registriert. Das Web-Dashboard kommuniziert mit einem lokalen Fastify-Server über eine einzige multiplexte WebSocket-Verbindung für Echtzeit-Gerätezustand und Log-Streaming. Funktionen, die auf einem bestimmten Gerätetyp nicht verfügbar sind, werden automatisch mit klaren Indikatoren in der UI deaktiviert. ## Unterstützte Plattformen | Plattform | iOS-Simulatoren | iOS-Geräte | Android-Emulatoren | Android-Geräte | | --------- | --------------- | ---------- | ------------------ | -------------- | | macOS | Ja | Eingeschränkt | Ja | Ja | | Linux | Nein | Nein | Ja | Ja | ### Unterstützung für echte Geräte Physische Geräte, die über USB verbunden sind, werden automatisch neben Simulatoren und Emulatoren erkannt. Das Dashboard gruppiert sie in separate Abschnitte (Physisch / Simulatoren / Emulatoren) und zeigt einen Toast an, wenn ein Gerät die Verbindung trennt. **Physische Android-Geräte** unterstützen nahezu alle Funktionen — App-Verwaltung, Deep Links, Logs, Screenshots, Datenbank-Inspektor, Dateibrowser und mehr. Einige Funktionen, die nur für Emulatoren verfügbar sind (Standortsimulation über `adb emu geo`, Batteriesimulation), sind nicht verfügbar und in der UI klar gekennzeichnet. **Physische iOS-Geräte** erfordern Xcode 15+ und verwenden `xcrun devicectl` im Hintergrund. Zu den unterstützten Funktionen gehören Geräteerkennung, App-Installation/-Deinstallation/-Start/-Beendigung, App-Auflistung, Deep Links und Dateikopieren. Viele Funktionen, die auf `simctl` angewiesen sind (Screenshots, Bildschirmaufzeichnung, Standortsimulation, Zwischenablage, Erscheinungsbild, Statusleiste, Push-Benachrichtigungen), sind auf physischen iOS-Geräten nicht verfügbar. Nicht unterstützte Steuerelemente sind deaktiviert, mit Tooltips, die erklären, warum. Sammlungen überspringen automatisch Schritte, die nicht auf physische Geräte zutreffen. ## Mitwirken Beiträge sind willkommen — Fehlerbehebungen, neue Module, Plattformabdeckung und Dokumentation gleichermaßen. Beginne mit dem **[Contributing Guide](https://github.com/pranshuchittora/simvyn/blob/main/CONTRIBUTING.md)**, der die Entwicklungsumgebung, das Projektlayout, das Hinzufügen eines Moduls und die von CI ausgeführten Prüfungen abdeckt. - [Einen Fehler melden](https://github.com/pranshuchittora/simvyn/issues/new?template=bug_report.yml) - [Eine Funktion anfordern](https://github.com/pranshuchittora/simvyn/issues/new?template=feature_request.yml) - [Verhaltenskodex](https://github.com/pranshuchittora/simvyn/blob/main/CODE_OF_CONDUCT.md) - [Changelog](https://github.com/pranshuchittora/simvyn/blob/main/CHANGELOG.md)```bash git clone https://github.com/pranshuchittora/simvyn.git cd simvyn npm install npm run dev ``` ## Sicherheit simvyn ist ein lokales Entwicklerwerkzeug und ist nicht dafür ausgelegt, unvertrauenswürdigen Netzwerken ausgesetzt zu werden. Bitte melde Schwachstellen privat über [GitHub Security Advisories](https://github.com/pranshuchittora/simvyn/security/advisories/new) und nicht als öffentliches Issue. Siehe die [Security Policy](https://github.com/pranshuchittora/simvyn/blob/main/SECURITY.md) für den Geltungsbereich und dazu, was enthalten sein sollte. Jede Veröffentlichung wird mit [Provenienz](https://docs.npmjs.com/generating-provenance-statements) über Trusted Publishing auf npm veröffentlicht, sodass du ein Tarball bis zum Commit zurückverfolgen kannst, der es erstellt hat:```bash npm audit signatures ``` ## Lizenz [MIT](https://github.com/pranshuchittora/simvyn/blob/main/LICENSE) © [Pranshu Chittora](https://github.com/pranshuchittora)
