Об этом проекте

shaperbox-importer — это инструмент на Python, который позволяет массово импортировать пакеты пресетов (в форматах .vstpreset или .fst) в Cableguys ShaperBox 3 на macOS. Он избавляет от утомительного ручного процесса загрузки каждого пресета через интерфейс плагина. Инструмент использует Spotify Pedalboard для хостинга ShaperBox 3 в качестве плагина, что позволяет внутренне переносить устаревшие данные пресетов в текущий формат, используемый ShaperBox 3. После миграции конвертированные пресеты записываются непосредственно в локальную базу данных SQLite и хранилище файлов .dat с адресацией по содержимому, благодаря чему они появляются во вкладке «MY PRESETS» при следующем запуске. Ключевые особенности включают автоматическое резервное копирование папки данных ShaperBox перед любой операцией записи, отказ от запуска при активной DAW (для предотвращения блокировки базы данных) и режим dry-run для предварительного просмотра импорта. Инструмент поддерживает одновременный импорт сотен пресетов и обрабатывает как файлы пресетов VST3, так и файлы состояния FL Studio, извлекая и переупаковывая встроенные в них данные. Для работы инструмента требуются macOS, Python 3.9+ и лицензионная установка ShaperBox 3. Установка доступна через pip или uv. Пользователям рекомендуется закрыть DAW перед запуском инструмента; доступен принудительный режим (force mode), но он рискован. В случае возникновения проблем пользователи могут восстановить данные из автоматически созданной резервной копии. Внутренне инструмент использует реверс-инжиниринг формата хранения ShaperBox: пользовательские пресеты хранятся в базе данных SQLite (presets.db) вместе с файлами .dat, организованными по структуре адресации по содержимому. Каждый файл .dat содержит сжатое с помощью zlib дерево JUCE ValueTree, обернутое в '#zip#\0'. Инструмент гарантирует, что импортированные пресеты имеют пустое поле «author», чтобы они отображались в разделе «MY PRESETS». Ограничения: Windows/Linux не поддерживаются; работает только с ShaperBox 3 (не с другими плагинами Cableguys); пока невозможно назначить пресеты в конкретные пакеты; поведение облачной синхронизации не задокументировано, но локально пресеты видны. Будущие обновления могут потребовать корректировки константы версии БД, если Cableguys изменит схему. Проект был разработан с помощью ИИ Claude (Anthropic). Лицензия MIT.