shaperbox-importer

shaperbox-importerは、macOS上のCableguys ShaperBox 3にプリセットパック（.vstpresetまたは.fst形式）を一括インポートできるようにするPythonツールです。プラグインのUIを通じて個別にプリセットを読み込むという退屈な手動プロセスを回避します。このツールはSpotifyのPedalboardを使用してShaperBox 3をプラグインとしてホストし、レガシーなプリセットデータをShaperBox 3が現在使用している形式に内部的に移行させます。移行後、変換されたプリセットはShaperBoxのローカルSQLiteデータベースとコンテンツアドレス方式の.datファイルストアに直接書き込まれ、次回の起動時に「MY PRESETS」タブに表示されるようになります。 主な機能には、書き込み操作前のShaperBoxデータフォルダの自動バックアップ、データベースのロックを防ぐためのDAW起動中の実行拒否、およびインポート内容をプレビューするためのドライランモードが含まれます。一度に数百のプリセットをサポートし、VST3プリセットファイルとFL Studioステートファイルの両方から埋め込まれたデータを抽出して再ラップすることで処理します。 本ツールには、macOS、Python 3.9以降、およびライセンス済みのShaperBox 3のインストールが必要です。インストールはpipまたはuv経由で可能です。ユーザーはツールを実行する前にDAWを閉じることが推奨されます。強制モードも利用可能ですが、リスクが伴います。問題が発生した場合は、自動生成されたバックアップから復元できます。 内部的に、このツールはShaperBoxのストレージ形式をリバースエンジニアリングしています。ユーザープリセットはSQLiteデータベース（presets.db）と、コンテンツアドレス構造で整理された.datファイルに保存されています。各.datファイルには、「#zip#\0」でラップされzlib圧縮されたJUCE ValueTreeが含まれています。ツールは、インポートされたプリセットの「author」フィールドを空にすることで、「MY PRESETS」に表示されるようにします。 制限事項：Windows/Linuxはサポートされていません。ShaperBox 3でのみ動作し（他のCableguysプラグインは不可）、プリセットを特定のパックに割り当てることはまだできません。クラウド同期の動作は文書化されていませんが、ローカルでは可視化されます。Cableguysがスキーマを変更した場合、今後のアップデートでDBバージョン定数の調整が必要になる可能性があります。本プロジェクトはClaude (Anthropic) のAI支援を受けて開発されました。MITライセンスです。