Démarre le serveur local, ouvre le tableau de bord web dans votre navigateur et découvre automatiquement tous les simulateurs, émulateurs et appareils physiques connectés par USB.

## Installation

**Installation globale :**```bash
npm install -g simvyn

**Prérequis :**

- Node.js >= 22.12.0
- macOS (support complet iOS + Android) ou Linux (Android uniquement)

## Fonctionnalités

- **Gestion des appareils** — Découvrir, démarrer, éteindre, effacer, créer et cloner des simulateurs, émulateurs et appareils physiques avec mise en favoris
- **Gestion des applications** — Installer, lancer, terminer, désinstaller des applications par glisser-déposer ou via CLI
- **Visionneuse de logs** — Flux en temps réel avec filtrage par niveau, recherche dans la page (Cmd+F), recherche par regex, pagination et exportation
- **Simulation de localisation** — Définir des coordonnées GPS, lire des itinéraires GPX/KML avec contrôle de vitesse, enregistrer des favoris
- **Paramètres de l'appareil** — Mode sombre, locale, orientation, autorisations, surcharges de la barre d'état, préréglages d'accessibilité
- **Captures d'écran et enregistrement** — Capturer des écrans et enregistrer la vidéo de l'écran avec historique
- **Liens profonds** — Ouvrir des URL et des schémas personnalisés, enregistrer des favoris par application
- **Inspecteur de base de données** — Parcourir les tables SQLite, exécuter des requêtes SQL, consulter SharedPreferences et NSUserDefaults
- **Explorateur de fichiers** — Parcourir les sandbox des applications, télécharger/téléverser des fichiers, éditer du texte en ligne
- **Notifications push** — Composer des charges utiles JSON, les envoyer aux simulateurs iOS, bibliothèque de modèles
- **Collections** — Regrouper des actions sur l'appareil en séquences réutilisables, les appliquer à plusieurs appareils à la fois
- **Rapports de crash** — Rapports de diagnostic iOS et crashes Android logcat/tombstone
- **Presse-papiers** — Lire et écrire le contenu du presse-papiers de l'appareil
- **Médias** — Envoyer des photos et vidéos dans les pellicules et galeries de l'appareil
- **Paramètres de l'outil** — Configuration du serveur, gestion du stockage, diagnostics et rapports de débogage
- **Support des appareils réels** — Connecter des appareils Android et iOS physiques via USB avec découverte automatique
- **Tableau de bord Web** — Design Apple Liquid Glass avec palette de commandes, navigation au clavier
- **CLI complète** — Chaque fonctionnalité fonctionne sans interface graphique via `simvyn <commande>`

## Aperçus des modules

### Gestion des appareils

Découvrez tous les simulateurs iOS, émulateurs Android et appareils physiques connectés via USB dans une liste unifiée. Démarrez, éteignez et effacez des appareils sans toucher à Xcode ni Android Studio. Créez de nouveaux simulateurs iOS en choisissant un type d'appareil et un runtime, ou clonez-en un existant pour dupliquer rapidement. Les appareils physiques apparaissent automatiquement lorsqu'ils sont branchés et sont regroupés séparément dans le sélecteur d'appareils.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/2b85641878f6015c248311700a1a87a20476ade6c930273a3e47f288a82d6d2e.png" alt="Gestion des appareils" width="700" /></p>

- Lister tous les simulateurs, émulateurs et appareils physiques disponibles toutes plateformes confondues
- Démarrer, éteindre et effacer des appareils en un clic ou par commande CLI
- Créer de nouveaux simulateurs iOS avec sélection du type d'appareil et du runtime
- Cloner et renommer des simulateurs existants
- Épingler les appareils favoris en haut du sélecteur
- Mises à jour en temps réel de l'état des appareils via WebSocket

### Gestion des applications

Installer, lancer, terminer et désinstaller des applications sur n'importe quel appareil connecté. Glisser-déposer des bundles IPA, APK ou .app de simulateur iOS directement sur le tableau de bord. Voir les informations détaillées de l'application et effacer les données de l'application sans commandes adb ou simctl manuelles.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/17757b1ca8ddd41d43ac3a159260598308da6c3f759e1c9d730f61498e18ce8a.png" alt="Gestion des applications" width="700" /></p>

- Installation par glisser-déposer d'IPA, APK et .app de simulateur iOS
- Lancer, terminer et désinstaller des applications par ID de bundle
- Voir les détails de l'application (version, taille, autorisations)
- Effacer les données de l'application sur les appareils Android
- Lister toutes les applications installées avec recherche filtrée

### Visionneuse de logs

Diffusez les logs de l'appareil en temps réel avec un filtrage puissant. Filtrez par niveau de log, recherchez avec des motifs regex, et filtrez par nom de processus. Utilisez la recherche dans la page (Cmd+F) pour mettre en évidence des entrées spécifiques sans masquer le contexte environnant. Exportez les logs filtrés pour les partager ou les archiver. L'historique paginé permet de remonter dans des milliers d'entrées sans problème de performance.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/b909b3515637b4059ebf210c56599f2f022506f09ee35a11e812bd8368d3750e.png" alt="Visionneuse de logs" width="700" /></p>

- Diffusion en continu des logs en temps réel via WebSocket
- Filtrer par niveau : debug, info, avertissement, erreur, fatal
- Recherche dans la page (Cmd+F) avec surbrillance des correspondances, navigation et compteur
- Recherche regex et filtrage par nom de processus
- Historique paginé avec défilement virtuel
- Exporter les logs filtrés vers un fichier
- Mettre en pause/reprendre le flux de logs tout en conservant l'état entre les vidages

### Localisation

Définissez des coordonnées GPS précises sur n'importe quel appareil à l'aide d'une carte interactive ou d'une saisie manuelle. Lisez des fichiers d'itinéraires GPX et KML avec contrôle de vitesse réglable. Enregistrez les lieux fréquemment utilisés comme favoris pour un accès rapide.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/47842dfa878ffbc80bd5bb32d83e820e7ed7dd56a4d63368ca6e823ef72889d4.png" alt="Localisation" width="700" /></p>

- Carte interactive avec coordonnées définies par clic
- Lecture de fichiers d'itinéraires GPX et KML avec contrôle de vitesse
- Lieux favoris enregistrés par appareil
- Diffusion de la localisation multi-appareils
- Géocodage inversé pour des adresses lisibles

### Paramètres de l'appareil

Activez/désactivez le mode sombre, changez la locale, faites pivoter l'orientation de l'appareil (Android), gérez les autorisations des applications et surchargez l'apparence de la barre d'état. Appliquez des préréglages d'accessibilité pour tester votre application dans différentes conditions. Toutes les modifications de paramètres prennent effet immédiatement sur l'appareil cible.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/d3f6a33c17b773560072f7b94b71abd5ebc82786c073bdeb6d25f828c3f214fa.png" alt="Paramètres de l'appareil" width="700" /></p>

- Activer/désactiver le mode sombre/clair
- Changer la locale de l'appareil
- Gérer les autorisations des applications
- Surcharger la barre d'état (heure, batterie, signal)
- Préréglages d'accessibilité (texte en gras, contraste accru, taille du contenu)

### Captures d'écran et enregistrement

Capturez des écrans et enregistrez la vidéo de l'écran sur n'importe quel appareil. Toutes les captures sont horodatées et organisées dans un historique consultable. Téléchargez ou supprimez les captures directement depuis le tableau de bord.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/58ed8f25d148ed53f39066e42be730f255235dbec47539bbec826c455cba7936.png" alt="Captures d'écran et enregistrement" width="700" /></p>

- Capture d'écran en un clic
- Enregistrement d'écran avec contrôles de démarrage/arrêt
- Historique des captures horodatées
- Téléchargement et suppression des captures depuis le tableau de bord

### Liens profonds

Ouvrez des URL et des schémas URI personnalisés sur n'importe quel appareil. Enregistrez les liens profonds fréquemment utilisés comme favoris organisés par application. Testez la gestion des liens profonds de votre application sans taper manuellement des URL dans un terminal.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/3a990ef7c74f83c93b63c1654f74b3fa952b0b41abd31fe688cdaf2e29570f62.png" alt="Liens profonds" width="700" /></p>

- Ouvrir n'importe quelle URL ou schéma personnalisé sur un appareil
- Enregistrer des liens profonds favoris par application
- Historique des liens avec ordre du plus récent au plus ancien
- Fonctionne avec iOS et Android

### Inspecteur de base de données

Parcourez les bases de données SQLite dans le sandbox de n'importe quelle application. Visualisez les schémas de tables, exécutez des requêtes SQL arbitraires et inspectez SharedPreferences (Android) ou NSUserDefaults (iOS). Modifiez les valeurs en ligne sans écrire de scripts.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/4884b688dbbee5f1a34b0454950f4d6562e74efdbbb3b84ca5c626835b4b7d37.png" alt="Inspecteur de base de données" width="700" /></p>

- Parcourir les tables SQLite avec colonnes triables
- Exécuter des requêtes SQL arbitraires
- Visualiser et modifier SharedPreferences et NSUserDefaults
- Édition en ligne des cellules avec détection de type

### Explorateur de fichiers

Parcourez le système de fichiers sandbox de n'importe quelle application installée. Naviguez dans les répertoires, téléversez et téléchargez des fichiers, et éditez les fichiers texte en ligne. Transférez des fichiers entre votre machine et l'appareil sans commandes adb pull/push manuelles.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/7b7ba540ad5de8b575da4f9bb28694dc68f5ffce51225a388788b8ef2f4767a0.png" alt="Explorateur de fichiers" width="700" /></p>

- Parcourir les répertoires sandbox des applications
- Télécharger et téléverser des fichiers
- Édition en ligne de fichiers texte
- Fonctionne avec les conteneurs d'applications iOS et Android

### Notifications push

Composez des charges utiles JSON de notification push et envoyez-les aux simulateurs iOS. Utilisez la bibliothèque de modèles intégrée comme point de départ ou écrivez des charges utiles à partir de zéro. La validation JSON en temps réel met en évidence les erreurs avant l'envoi.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/f640654be67c24c7248806987e62908316407c18648fc145109118f260443f7d.png" alt="Notifications push" width="700" /></p>

- Composer et envoyer des charges utiles push aux simulateurs iOS
- Bibliothèque de modèles de charge utile intégrée
- Validation JSON en temps réel
- Cibler des applications spécifiques par ID de bundle

### Collections

Créez des ensembles réutilisables d'actions sur l'appareil et appliquez-les à plusieurs appareils à la fois. Les collections regroupent des étapes telles que le réglage de la localisation, l'activation du mode sombre et l'installation d'une application en un seul flux de travail répétable. Trois préréglages de démarrage sont fournis avec simvyn pour vous lancer.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/fbf2ddbba1d3725321c80a914bf5b71ea6a2fc605fddbb73abd0b28385488af6.png" alt="Collections" width="700" /></p>

- Créer, dupliquer et gérer des collections nommées
- Parcourir le catalogue d'actions classées par catégorie dans tous les modules
- Réorganiser les étapes par glisser-déposer
- Appliquer à plusieurs appareils avec vérification de compatibilité
- Trois préréglages de démarrage intégrés

### Rapports de crash

Consultez les rapports de diagnostic iOS (fichiers .ips) et les crash logs Android provenant de logcat et des vidages tombstone. Parcourez les entrées de crash avec horodatage et informations sur le processus. Inspectez les détails complets du crash sans fouiller dans les systèmes de fichiers de l'appareil.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/8f74a799448050bc37eace1d43865b13f3f47a0997c01dba650fd21e94f09ebf.png" alt="Rapports de crash" width="700" /></p>

- Analyse des rapports de diagnostic iOS (.ips)
- Regroupement des crashes logcat Android par PID et tag
- Récupération des vidages tombstone Android
- Liste des crashes horodatés avec vue détaillée

### Presse-papiers

Lisez et écrivez le presse-papiers de l'appareil depuis le tableau de bord ou la CLI. Utile pour coller rapidement des données de test dans des applications ou inspecter ce qu'une application a copié.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/db889032abeb5f1d511dcfeb8c06c215bda851436f198a63db97f595b50853d6.png" alt="Presse-papiers" width="700" /></p>

- Lire le contenu actuel du presse-papiers
- Écrire du texte dans le presse-papiers de l'appareil
- Fonctionne avec les simulateurs iOS et les émulateurs Android

### Médias

Envoyez des photos et vidéos directement dans la pellicule ou la galerie d'un appareil. Déposez des fichiers sur le tableau de bord pour les injecter sans câble, email ou transfert cloud.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/c63ce5411dc17b5d329c2af381c035d86164f5544928b0c76fe7d05346473561.png" alt="Médias" width="700" /></p>

- Ajouter des photos et vidéos à la galerie de l'appareil par glisser-déposer
- Prend en charge les fichiers volumineux jusqu'à 500 Mo
- Fonctionne avec les simulateurs iOS et les émulateurs Android

### Paramètres de l'outil

Configurez le serveur simvyn, gérez le stockage et consultez les diagnostics. Inclut un générateur de rapport de débogage pour soumettre des problèmes.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/7ba043d473d21d4bb5477582539ffd9a4c57600ec20c22ee9d7e63146cbbfbb2.png" alt="Paramètres de l'outil" width="700" /></p>

- Configuration du port du serveur, de l'ouverture automatique et de l'intervalle d'interrogation
- Aperçu de l'utilisation du stockage avec option d'effacement des données
- Diagnostics : version de Xcode, disponibilité de devicectl, version d'adb
- Rapport de débogage en un clic pour le signalement de bugs

## Guide des collections

Les collections vous permettent de regrouper plusieurs actions sur l'appareil en une séquence réutilisable et de les appliquer à toute combinaison d'appareils en un clic.

### Créer une collection

Ouvrez le panneau Collections depuis la barre latérale. Cliquez sur **Nouvelle collection** et donnez-lui un nom. La collection commence vide — vous ajouterez des étapes depuis le catalogue d'actions.

### Ajouter des étapes

Cliquez sur **Ajouter une étape** pour parcourir le catalogue d'actions classées par catégorie. Les actions sont organisées par module — Paramètres de l'appareil, Localisation, Gestion des applications, etc. Sélectionnez une action, configurez ses paramètres en ligne (coordonnées, ID de bundle, valeurs de bascule), et elle apparaît dans votre collection. Faites glisser les étapes pour les réorganiser.

### Appliquer une collection

Cliquez sur **Appliquer** pour ouvrir la fenêtre d'application. Sélectionnez un ou plusieurs appareils cibles dans la liste des appareils. Un résumé de compatibilité indique quelles étapes seront ignorées sur les plateformes incompatibles (par exemple, actions iOS uniquement sur un appareil Android). Appuyez sur **Cmd+Entrée** pour exécuter. Une matrice d'état en direct montre la progression par étape et par appareil en temps réel.

### Intégration de la palette de commandes

Les collections enregistrées apparaissent dans la palette de commandes (**Cmd+K**). Recherchez une collection par son nom et appliquez-la directement avec le sélecteur d'appareils — pas besoin de naviguer vers le panneau Collections.

### Collections de démarrage

Trois préréglages intégrés sont fournis avec simvyn :

- **Mode sombre + Locale japonaise** — Active le mode sombre et définit la locale sur le japonais
- **Configuration de capture d'écran** — Configure les surcharges de la barre d'état pour des captures d'écran propres pour l'App Store
- **Réinitialiser l'état de l'appareil** — Efface la localisation, réinitialise les paramètres et efface les données de l'application

### Utilisation en CLI```bash
simvyn collections list                         # List all collections
simvyn collections apply <name> <devices...>    # Apply a collection to devices