Sobre o projeto

O shaperbox-importer é uma ferramenta em Python que permite a importação em massa de pacotes de presets (nos formatos .vstpreset ou .fst) para o Cableguys ShaperBox 3 no macOS. Ele evita o processo manual tedioso de carregar cada preset individualmente através da interface do plugin. A ferramenta utiliza o Pedalboard do Spotify para hospedar o ShaperBox 3 como um plugin, permitindo que ele migre internamente dados de presets legados para o formato atual usado pelo ShaperBox 3. Após a migração, ele grava os presets convertidos diretamente no banco de dados SQLite local do ShaperBox e no armazenamento de arquivos .dat endereçados por conteúdo, fazendo com que apareçam na aba 'MY PRESETS' no próximo lançamento. Os principais recursos incluem backup automático da pasta de dados do ShaperBox antes de qualquer operação de gravação, recusa de execução enquanto uma DAW estiver ativa (para evitar o bloqueio do banco de dados) e um modo dry-run para pré-visualizar as importações. Suporta centenas de presets de uma só vez e lida tanto com arquivos de preset VST3 quanto com arquivos de estado do FL Studio, extraindo e reembalando seus dados incorporados. A ferramenta requer macOS, Python 3.9+ e uma instalação licenciada do ShaperBox 3. A instalação está disponível via pip ou uv. Recomenda-se que os usuários fechem sua DAW antes de executar a ferramenta; o modo de força está disponível, mas é arriscado. Se surgirem problemas, os usuários podem restaurar a partir do backup gerado automaticamente. Internamente, a ferramenta faz a engenharia reversa do formato de armazenamento do ShaperBox: os presets do usuário são armazenados em um banco de dados SQLite (presets.db) junto com arquivos .dat organizados em uma estrutura endereçada por conteúdo. Cada arquivo .dat contém uma JUCE ValueTree compactada com zlib e envolvida por '#zip#\0'. A ferramenta garante que os presets importados tenham um campo 'author' vazio para que apareçam em 'MY PRESETS'. Limitações: Windows/Linux não são suportados; funciona apenas com o ShaperBox 3 (não com outros plugins da Cableguys); ainda não é possível atribuir presets a pacotes específicos; o comportamento da sincronização em nuvem não está documentado, mas é visível localmente. Atualizações futuras podem exigir o ajuste da constante de versão do DB se a Cableguys alterar o esquema. O projeto foi desenvolvido com assistência de IA do Claude (Anthropic). Licença MIT.