Sobre el proyecto

shaperbox-importer es una herramienta de Python que permite la importación masiva de paquetes de presets (en formatos .vstpreset o .fst) en Cableguys ShaperBox 3 en macOS. Evita el tedioso proceso manual de cargar cada preset individualmente a través de la interfaz de usuario del plugin. La herramienta utiliza Pedalboard de Spotify para alojar ShaperBox 3 como un plugin, lo que le permite migrar internamente los datos de presets heredados al formato actual utilizado por ShaperBox 3. Después de la migración, escribe los presets convertidos directamente en la base de datos SQLite local de ShaperBox y en el almacén de archivos .dat direccionables por contenido, haciendo que aparezcan bajo la pestaña 'MY PRESETS' en el siguiente inicio. Las características clave incluyen el respaldo automático de la carpeta de datos de ShaperBox antes de cualquier operación de escritura, la negativa a ejecutarse mientras un DAW esté activo (para evitar el bloqueo de la base de datos) y un modo de prueba (dry-run) para previsualizar las importaciones. Admite cientos de presets a la vez y gestiona tanto archivos de presets VST3 como archivos de estado de FL Studio, extrayendo y reempaquetando sus datos integrados. La herramienta requiere macOS, Python 3.9+ y una instalación con licencia de ShaperBox 3. La instalación está disponible a través de pip o uv. Se recomienda a los usuarios cerrar su DAW antes de ejecutar la herramienta; existe un modo forzado, pero es riesgoso. Si surgen problemas, los usuarios pueden restaurar desde la copia de seguridad generada automáticamente. Internamente, la herramienta realiza ingeniería inversa al formato de almacenamiento de ShaperBox: los presets de usuario se almacenan en una base de datos SQLite (presets.db) junto con archivos .dat organizados en una estructura direccionable por contenido. Cada archivo .dat contiene un JUCE ValueTree comprimido con zlib y envuelto con '#zip#\0'. La herramienta asegura que los presets importados tengan un campo 'author' vacío para que aparezcan en 'MY PRESETS'. Limitaciones: Windows/Linux no son compatibles; solo funciona con ShaperBox 3 (no con otros plugins de Cableguys); aún no puede asignar presets a paquetes específicos; el comportamiento de la sincronización en la nube no está documentado pero es visible localmente. Las actualizaciones futuras pueden requerir el ajuste de la constante de versión de la DB si Cableguys cambia el esquema. El proyecto fue desarrollado con asistencia de IA de Claude (Anthropic). Licencia MIT.