Inicia el servidor local, abre el panel web en tu navegador y descubre automáticamente todos los simuladores, emuladores y dispositivos físicos conectados por USB.

## Instalación

**Instalación global:**```bash
npm install -g simvyn

**Requisitos:**

- Node.js >= 22.12.0
- macOS (soporte completo para iOS + Android) o Linux (solo Android)

## Características

- **Gestión de dispositivos** — Descubrir, iniciar, apagar, borrar, crear y clonar simuladores, emuladores y dispositivos físicos con fijación de favoritos
- **Gestión de aplicaciones** — Instalar, lanzar, terminar, desinstalar aplicaciones mediante arrastrar y soltar o CLI
- **Visor de registros** — Transmisión en tiempo real con filtrado por nivel, búsqueda en página (Cmd+F), búsqueda regex, paginación y exportación
- **Simulación de ubicación** — Establecer coordenadas GPS, reproducir rutas GPX/KML con control de velocidad, guardar favoritos
- **Configuración del dispositivo** — Modo oscuro, configuración regional, orientación, permisos, anulaciones de la barra de estado, ajustes preestablecidos de accesibilidad
- **Capturas de pantalla y grabación** — Tomar capturas de pantalla y grabar video de la pantalla con historial
- **Enlaces profundos** — Abrir URL y esquemas personalizados, guardar favoritos por aplicación
- **Inspector de bases de datos** — Explorar tablas SQLite, ejecutar consultas SQL, ver SharedPreferences y NSUserDefaults
- **Explorador de archivos** — Navegar por los entornos limitados de las aplicaciones, cargar/descargar archivos, editar texto en línea
- **Notificaciones push** — Redactar cargas JSON, enviar a simuladores iOS, biblioteca de plantillas
- **Colecciones** — Agrupar acciones del dispositivo en secuencias reutilizables, aplicar a múltiples dispositivos a la vez
- **Registros de fallos** — Informes de diagnóstico iOS y fallos de logcat/tombstone de Android
- **Portapapeles** — Leer y escribir el contenido del portapapeles del dispositivo
- **Medios** — Enviar fotos y videos al carrete de la cámara y galerías del dispositivo
- **Configuración de la herramienta** — Configuración del servidor, gestión de almacenamiento, diagnósticos e informes de depuración
- **Soporte para dispositivos reales** — Conectar dispositivos Android e iOS físicos mediante USB con descubrimiento automático
- **Panel web** — Diseño Apple Liquid Glass con paleta de comandos, navegación por teclado
- **CLI completo** — Cada función funciona sin interfaz gráfica mediante `simvyn <comando>`

## Demostraciones de módulos

### Gestión de dispositivos

Descubra todos los simuladores iOS, emuladores Android y dispositivos físicos conectados por USB en una lista unificada. Inicie, apague y borre dispositivos sin tocar Xcode ni Android Studio. Cree nuevos simuladores iOS eligiendo un tipo de dispositivo y tiempo de ejecución, o clone uno existente para crear rápidamente duplicados. Los dispositivos físicos aparecen automáticamente cuando se conectan y se agrupan por separado en el selector de dispositivos.

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

- Listar todos los simuladores, emuladores y dispositivos físicos disponibles en todas las plataformas
- Iniciar, apagar y borrar dispositivos con un clic o comando CLI
- Crear nuevos simuladores iOS con selección de tipo de dispositivo y tiempo de ejecución
- Clonar y renombrar simuladores existentes
- Fijar dispositivos favoritos en la parte superior del selector de dispositivos
- Actualizaciones de estado del dispositivo en tiempo real mediante WebSocket

### Gestión de aplicaciones

Instale, lance, termine y desinstale aplicaciones en cualquier dispositivo conectado. Arrastre y suelte paquetes IPA, APK o .app de simulador iOS directamente en el panel. Vea información detallada de la aplicación y borre datos de la aplicación sin comandos manuales de adb o simctl.

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

- Instalación mediante arrastrar y soltar de IPA, APK y .app de simulador iOS
- Lanzar, terminar y desinstalar aplicaciones por ID de paquete
- Ver detalles de la aplicación, incluidos versión, tamaño y permisos
- Borrar datos de la aplicación en dispositivos Android
- Listar todas las aplicaciones instaladas con filtro de búsqueda

### Visor de registros

Transmita registros del dispositivo en tiempo real con potentes filtros. Filtre por nivel de registro, busque con patrones regex y filtre por nombre de proceso. Use la búsqueda en página (Cmd+F) para resaltar entradas específicas sin ocultar el contexto circundante. Exporte registros filtrados para compartir o archivar. El historial paginado le permite desplazarse hacia atrás a través de miles de entradas sin problemas de rendimiento.

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

- Transmisión de registros en tiempo real mediante WebSocket
- Filtrar por nivel: depuración, información, advertencia, error, fatal
- Búsqueda en página (Cmd+F) con resaltado de coincidencias, navegación y contador
- Búsqueda regex y filtrado por nombre de proceso
- Historial paginado con desplazamiento virtual
- Exportar registros filtrados a un archivo
- Pausar/reanudar la transmisión de registros manteniendo el estado entre limpiezas

### Ubicación

Establezca coordenadas GPS precisas en cualquier dispositivo mediante un mapa interactivo o entrada manual. Reproduzca archivos de ruta GPX y KML con control de velocidad ajustable. Guarde ubicaciones utilizadas con frecuencia como favoritas para acceso rápido.

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

- Mapa interactivo con clic para establecer coordenadas
- Reproducción de archivos de ruta GPX y KML con control de velocidad
- Ubicaciones favoritas guardadas por dispositivo
- Transmisión de ubicación a múltiples dispositivos
- Geocodificación inversa para direcciones legibles por humanos

### Configuración del dispositivo

Active o desactive el modo oscuro, cambie la configuración regional, gire la orientación del dispositivo (Android), gestione los permisos de las aplicaciones y anule la apariencia de la barra de estado. Aplique ajustes preestablecidos de accesibilidad para probar su aplicación en diferentes condiciones. Todos los cambios de configuración surten efecto inmediatamente en el dispositivo de destino.

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

- Activar/desactivar modo oscuro/claro
- Cambiar la configuración regional del dispositivo
- Gestionar permisos de aplicaciones
- Anular la barra de estado (hora, batería, señal)
- Ajustes preestablecidos de accesibilidad (texto en negrita, aumentar contraste, tamaño de contenido)

### Capturas de pantalla y grabación

Capture capturas de pantalla y grabe video de la pantalla en cualquier dispositivo. Todas las capturas se guardan con marcas de tiempo y se organizan en un historial navegable. Descargue o elimine capturas directamente desde el panel.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/58ed8f25d148ed53f39066e42be730f255235dbec47539bbec826c455cba7936.png" alt="Screenshots and Recording" width="700" /></p>

- Captura de pantalla con un clic
- Grabación de pantalla con controles de inicio/parada
- Historial de capturas con marca de tiempo
- Descargar y eliminar capturas desde el panel

### Enlaces profundos

Abra URL y esquemas URI personalizados en cualquier dispositivo. Guarde enlaces profundos utilizados con frecuencia como favoritos organizados por aplicación. Pruebe el manejo de enlaces profundos de su aplicación sin tener que escribir URL manualmente en una terminal.

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

- Abrir cualquier URL o esquema personalizado en un dispositivo
- Guardar enlaces profundos favoritos por aplicación
- Historial de enlaces con orden de más reciente primero
- Funciona tanto con iOS como con Android

### Inspector de bases de datos

Explore bases de datos SQLite dentro del entorno limitado de cualquier aplicación. Vea esquemas de tablas, ejecute consultas SQL arbitrarias e inspeccione SharedPreferences (Android) o NSUserDefaults (iOS). Edite valores en línea sin escribir scripts.

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

- Explorar tablas SQLite con columnas ordenables
- Ejecutar consultas SQL arbitrarias
- Ver y editar SharedPreferences y NSUserDefaults
- Edición de celdas en línea con detección de tipos

### Explorador de archivos

Navegue por el sistema de archivos del entorno limitado de cualquier aplicación instalada. Recorra directorios, cargue y descargue archivos, y edite archivos de texto en línea. Transfiera archivos entre su máquina y el dispositivo sin comandos manuales de adb pull/push.

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

- Explorar directorios del entorno limitado de la aplicación
- Cargar y descargar archivos
- Edición de archivos de texto en línea
- Funciona con contenedores de aplicaciones iOS y Android

### Notificaciones push

Redacte cargas JSON de notificaciones push y envíelas a simuladores iOS. Use la biblioteca de plantillas incorporada como punto de partida o escriba cargas desde cero. La validación JSON en tiempo real resalta errores antes de enviar.

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

- Redactar y enviar cargas push a simuladores iOS
- Biblioteca de plantillas de carga incorporada
- Validación JSON en tiempo real
- Apuntar a aplicaciones específicas por ID de paquete

### Colecciones

Cree conjuntos reutilizables de acciones del dispositivo y aplíquelos a múltiples dispositivos a la vez. Las colecciones agrupan pasos como establecer la ubicación, activar el modo oscuro e instalar una aplicación en un solo flujo de trabajo repetible. Se incluyen tres ajustes preestablecidos iniciales con simvyn para comenzar.

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

- Crear, duplicar y gestionar colecciones con nombre
- Explorar el catálogo de acciones categorizadas de todos los módulos
- Reordenar pasos mediante arrastrar y soltar
- Aplicar a múltiples dispositivos con verificación de compatibilidad
- Tres ajustes preestablecidos iniciales incorporados

### Registros de fallos

Vea informes de diagnóstico de iOS (archivos .ips) y registros de fallos de Android de volcados de logcat y tombstone. Explore las entradas de fallos con marcas de tiempo e información del proceso. Inspeccione los detalles completos del fallo sin tener que examinar los sistemas de archivos del dispositivo.

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

- Análisis de informes de diagnóstico de iOS (.ips)
- Agrupación de fallos de logcat de Android por PID y etiqueta
- Recuperación de volcados de tombstone de Android
- Lista de fallos con marca de tiempo y vista de detalle

### Portapapeles

Lea y escriba el portapapeles del dispositivo desde el panel o la CLI. Útil para pegar rápidamente datos de prueba en aplicaciones o inspeccionar lo que una aplicación copió.

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

- Leer el contenido actual del portapapeles
- Escribir texto en el portapapeles del dispositivo
- Funciona con simuladores iOS y emuladores Android

### Medios

Envíe fotos y videos directamente al carrete de la cámara o galería de un dispositivo. Arrastre archivos al panel para inyectarlos sin cables, correo electrónico ni transferencias en la nube.

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

- Agregar fotos y videos a la galería del dispositivo mediante arrastrar y soltar
- Soporta archivos grandes de hasta 500 MB
- Funciona con simuladores iOS y emuladores Android

### Configuración de la herramienta

Configure el servidor de simvyn, gestione el almacenamiento y vea diagnósticos. Incluye un generador de informes de depuración para reportar problemas.

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

- Configuración del puerto del servidor, apertura automática e intervalo de sondeo
- Resumen del uso de almacenamiento con opción de borrar datos
- Diagnósticos: versión de Xcode, disponibilidad de devicectl, versión de adb
- Informe de depuración con un clic para reportar errores

## Guía de colecciones

Las colecciones le permiten agrupar múltiples acciones del dispositivo en una secuencia reutilizable y aplicarlas a cualquier combinación de dispositivos con un solo clic.

### Crear una colección

Abra el panel de Colecciones desde la barra lateral. Haga clic en **Nueva colección** y asígnele un nombre. La colección comienza vacía; agregará pasos desde el catálogo de acciones.

### Agregar pasos

Haga clic en **Agregar paso** para explorar el catálogo de acciones categorizadas. Las acciones están organizadas por módulo: Configuración del dispositivo, Ubicación, Gestión de aplicaciones y más. Seleccione una acción, configure sus parámetros en línea (coordenadas, ID de paquete, valores de alternancia) y aparecerá en su colección. Arrastre los pasos para reordenarlos.

### Aplicar una colección

Haga clic en **Aplicar** para abrir el modal de aplicación. Seleccione uno o más dispositivos de destino de la lista de dispositivos. Un resumen de compatibilidad muestra qué pasos se omitirán en plataformas incompatibles (por ejemplo, acciones solo para iOS en un dispositivo Android). Presione **Cmd+Enter** para ejecutar. Una matriz de estado en vivo muestra el progreso por paso y por dispositivo en tiempo real.

### Integración con la paleta de comandos

Las colecciones guardadas aparecen en la paleta de comandos (**Cmd+K**). Busque una colección por nombre y aplíquela directamente con el selector de dispositivos; no es necesario navegar al panel de Colecciones.

### Colecciones iniciales

Se incluyen tres ajustes preestablecidos incorporados con simvyn:

- **Modo oscuro + configuración regional japonesa** — Activa el modo oscuro y establece la configuración regional en japonés
- **Configuración de captura de pantalla** — Configura anulaciones de la barra de estado para capturas de pantalla limpias de la App Store
- **Restablecer estado del dispositivo** — Borra la ubicación, restablece la configuración y elimina los datos de la aplicación

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