音のプラグイン倉庫くんAudio Plugin Soko-kun - オープンソースのオーディオプラグインの倉庫
日本語

注意このプラットフォームは、プラグインの規格の策定元や DAW の開発元と無関係の、非公式で無料のサービスです。各プラグインの安全性を保証しないので、個人の責任にもとづき注意して利用してください。このプラットフォームは非公式で、各プラグインの安全性を保証しないので、注意して利用してください。 音のプラグイン倉庫くんとは？

プラグインを登録する

この翻訳は参考訳なので、正確な内容は英語版で確認してください。 英語版

登録できるプラグイン

このプラットフォームは、GitHub リポジトリの管理者である作者が登録した、オープンソースのオーディオプラグインを掲載します。

対象の規格: VST® 3 CLAP, LV2, Audio Unit

登録する前に、リポジトリと最新のリリースが掲載の条件を満たすことを確認してください: https://audio-soko-kun.allegromoltov.jp/policy

このプラットフォームは、プラグインの規格・OS・アーキテクチャ・カテゴリを、zip のアーカイブの中のバンドルから判定します。作者が入力する必要はありません。

プラグインとリポジトリの名前に VST の語を入れないでください。VST 3 SDK は製品名に VST を使うことを認めていません。このプラットフォームのレビューでも、VST を含む名前を推奨の指摘として返します。

リリースの前にリポジトリを確認する

リリースを公開する前に、AI エージェントに submit_plugin の確認のモードを使わせてください。確認のモードは、最新のリリースで掲載の条件を判定し、既定のブランチの最新のコミットをレビューします。このモードでは登録しません。確認のモードは 24 時間に 5 回まで使えます。確認のモードにも GitHub でのサインインが要ります。最初のリリースの前でも、確認のモードは、リリースを要る条件を未判定として満たし方とともに返し、既定のブランチの .audio-soko-kun/config.json の形を確かめます。掲載するリリースは不変のリリースで、公開の後は配布物を足せません。下書きのリリースにすべての配布物を添付してから公開してください。セキュリティの機能を切らせる案内と、取得したものを実行させるコマンドを探すルールは、「〜しないでください」のように禁じる文にも当たります。

レビューは、GitHub で公開している審査の基準にしたがいます: https://github.com/AllegroMoltoV/audio-plugin-soko-kun/blob/main/docs/design/review-criteria.md

アーカイブの中身の検査と macOS の署名の判定は、登録の後に GitHub Actions で配布物を取得して行うため、確認のモードでは行いません。AI エージェントは、これらの検査で求められることを示します。

登録の手順

MCP クライアントを https://audio-soko-kun.allegromoltov.jp/mcp に接続してください。Claude Code では次を実行してください:

claude mcp add --transport http audio-plugin-soko-kun https://audio-soko-kun.allegromoltov.jp/mcp

MCP クライアントから GitHub のアカウントでサインインしてください。Claude Code では /mcp を実行し、audio-plugin-soko-kun を選んでください。Codex では codex mcp add audio-plugin-soko-kun --url https://audio-soko-kun.allegromoltov.jp/mcp で接続してから、codex mcp login audio-plugin-soko-kun でサインインしてください。このプラットフォーム自体が GitHub リポジトリへの書き込みの権限を得ることはありません。

AI エージェントに登録を頼んでください。話しかけ方の例は「https://github.com/<owner>/<repository> のオーディオプラグインを登録して」です。

登録した後の流れ

このプラットフォームはプラグインを検査待ちで登録します。リリースが検査を通るまで、プラグインは検索とプラグインのページに表示されません。

検査は 15 分ごとに進み、ふつう数時間以内に終わります。

このプラットフォームは、検査を通った版だけを掲載します。GitHub で新しいリリースを公開すると、このプラットフォームは自動で取り込んで検査します。登録し直す必要はありません。

検査の結果は、AI エージェントに list_my_plugins で確かめさせてください。話しかけ方の例は「自分のプラグインの新しいリリースの掲載の状態を確かめて」です。AI エージェントは、版ごとの状態・版や配布物を掲載していない理由・レビューの指摘・直し方を示します。

管理者の確認待ちになる版もあります。その版の変更の意図を説明するときは、このプラットフォームのリポジトリの Issue に書いてください: https://github.com/AllegroMoltoV/audio-plugin-soko-kun/issues

登録が拒否されたとき

AI エージェントが理由のコードと直し方を表示するので、原因を直してから登録し直してください。

  • not_admin: リポジトリの管理権限がありません。リポジトリの管理者に登録を頼んでください。
  • private_repository、archived_repository: リポジトリを公開し、アーカイブを解除してください。
  • no_license: オープンソースのライセンスの LICENSE ファイルをリポジトリの直下に置き、新しいリリースを公開してください。
  • license_unrecognized: GitHub がライセンスを識別できません。LICENSE には標準の本文だけを置き、ほかの表示は NOTICE や README に移してから、新しいリリースを公開してください。
  • license_not_open: OSI の承認または FSF の認定を受けたライセンスにしてから、新しいリリースを公開してください。
  • no_release、no_verifiable_asset: 配布物を添付したリリースを公開してください。配布物は 30 件までです。
  • no_archive: プラグインのバンドルを zip のアーカイブにして、リリースに添付してください。
  • not_immutable: リポジトリの設定で不変のリリースを有効にしてから、新しいリリースを公開してください。
  • no_attestation: リリースのワークフローに actions/attest-build-provenance を加え、インストーラーを含むすべての配布物に証明を付けてください。そのうえで新しいリリースを公開してください。
  • duplicate: リポジトリは登録済みです。検索からプラグインのページを開いてください。
  • name_reserved: 掲載中のプラグインが、名前を変える前にこのリポジトリ名を使っていました。掲載中のプラグインが使ったことのない名前にリポジトリの名前を変えてください。
  • rate_limited: 登録は 24 時間に 10 回までです。時間をおいてから登録してください。
  • invalid_url: リポジトリの URL を https://github.com/<owner>/<repository> の形で指定してください。
  • not_found: リポジトリが見つかりません。URL と、リポジトリが公開されていることを確認してください。
  • unsupported_tag: リリースのタグは、英数字・「.」・「-」・「_」だけの 100 文字以内にしてください。
  • github_unavailable: GitHub が正常に応答しませんでした。時間をおいてから登録してください。

版や配布物が掲載されないとき

版や配布物を掲載しない理由は、list_my_plugins で確かめられます。作者が直す主な理由は次のとおりです。

  • vst2_detected: アーカイブに VST 2 のバンドルかエントリーポイントがあります。すべてのアーカイブから VST 2 を外し、新しいリリースを公開してください。
  • no_plugin_detected、no_plugin_in_archive: アーカイブに対象の規格のバンドルが見つかりません。ビルドしたバンドルを zip のアーカイブに入れてください。ソースコードのアーカイブは直す必要はありません。
  • content_undetermined: インストーラーや入れ子のアーカイブなど、中を調べられないファイルがアーカイブにあります。プラグインのバンドルを zip のアーカイブに直接入れてください。
  • macos_not_signed、macos_adhoc、macos_not_developer_id、macos_not_notarized: macOS 向けのバンドルを Developer ID の証明書で署名し、Apple の公証を受けてください。
  • declaration_mismatch、not_declared: .audio-soko-kun/config.json の宣言と、検査したアーカイブの中身が食い違います。宣言を直して、新しいリリースを公開してください。
  • installer_not_guided: インストーラーは案内しません。利用者は zip のアーカイブからプラグインを導入します。
  • macos_lv2_not_guided: アーカイブに macOS 向けの LV2 のバンドルしかありません。macOS 向けの LV2 は案内しません。Developer ID の証明書で署名して公証を受けた、macOS 向けの VST 3・CLAP・Audio Unit のバンドルを足してください。

ロゴと説明の画像

作者は、ロゴと説明の画像を 1 枚ずつ掲載できます。リポジトリの .audio-soko-kun フォルダーに画像を置いてください。

.audio-soko-kun/logo.png
.audio-soko-kun/image.gif
  • ロゴ: ファイル名を logo にしてください。大きさは 256 KB 以内、縦と横は 1,024 px 以内にしてください。
  • 説明の画像: ファイル名を image にしてください。大きさは 1.5 MB 以内、縦と横は 4,096 px 以内にしてください。GIF はアニメーションとして再生されます。

このプラットフォームはスクリプトを含められる SVG を受け付けないので、拡張子は png・jpg・jpeg・gif・webp のいずれかにしてください。

このプラットフォームは最新リリースのタグの時点の画像を取得するので、画像を変えたときは新しいリリースを公開してください。

このプラットフォームは条件に合わない画像を掲載しないので、画像が表示されないときは条件を確認してください。

.audio-soko-kun/config.json

作者は .audio-soko-kun/config.json で、表示名とカテゴリと、アーカイブごとの OS・アーキテクチャ・規格を宣言できます。画像と同じ .audio-soko-kun フォルダーにファイルを置いてください。

{
  "name": "Simple Pitch Shift",
  "category": "effect",
  "assets": [
    {
      "pattern": "simple-pitchshift-*-windows-x64.zip",
      "os": "windows",
      "arch": ["x86_64"],
      "formats": ["vst3", "clap"]
    }
  ]
}
  • name: 表示名です。1〜60 文字で書いてください。書かないときは、リポジトリ名を表示します。
  • category: instrument・effect・analyzer・midi・utility のいずれかです。バンドルからカテゴリを推定できないときだけ使います。
  • assets: アーカイブの宣言を 20 件まで書けます。pattern はアーカイブの名前の型で、* だけが任意の文字列に一致します。os は windows・macos・linux のいずれか、arch は x86_64・x86・arm64 の配列、formats は vst3・clap・lv2・au の配列です。

どの項目も任意です。このプラットフォームは、規格・OS・アーキテクチャを検査したバンドルから決め、宣言は照合と案内するアーカイブの絞り込みにだけ使います。

assets を書くと、pattern に一致したアーカイブだけを案内します。ファイルの内容が条件に合わないリリース、どのアーカイブも pattern に一致しないリリース、検査したアーカイブの中身が宣言と食い違うリリースは掲載しません。

このプラットフォームは新しいリリースのタグの時点のファイルを読むので、ファイルを変えたときは新しいリリースを公開してください。

最小の正しい宣言は、表示名だけを書いたものです。

{
  "name": "Simple Pitch Shift"
}

カテゴリは次の順に決めます。まず、検査したバンドルから推定します。手がかりは、Audio Unit のコンポーネントの type (aumu・aufx・aumf・aumi) と、VST 3 のバンドルの moduleinfo.json の Sub Categories です。手がかりが複数のカテゴリを示すときは、instrument・midi・analyzer・effect の順に先のものを採ります。推定できなければこのファイルの category を使い、それも無ければ utility にします。推定したカテゴリは、宣言したカテゴリより優先します。

CLAP の features は、このプラットフォームがプラグインのバイナリを実行しないため、カテゴリに使いません。clap-wrapper で作った VST 3 のように moduleinfo.json の無いバンドルも、手がかりになりません。CLAP だけで配るプラグインは、このファイルで category を宣言してください。

更新と掲載の取り下げ

掲載を更新するときは、GitHub で新しいリリースを公開してください。このプラットフォームは新しいリリースを自動で取り込み、検査を通ったら掲載します。リポジトリの説明から概要も更新します。

新しいリリースが掲載されないときは、AI エージェントに list_my_plugins で理由を確かめさせてください。AI エージェントは理由と直し方を示します。

掲載を取り下げるときは、リポジトリを非公開にする、あるいは削除してください。通報ページの方法で取り下げを依頼することもできます。

リリースを守る設定

リリースのタグは、既定のブランチのコミットに付けてください。既定のブランチに無いコミットにタグを付けたリリースは、管理者の確認を待ちます。

リリースは、リポジトリへの書き込みの権限を持つ人なら誰でも作れます。このプラットフォームは、既定のブランチを ruleset で守り、削除と強制 push を禁じて承認 1 名以上の PR を必須にすること、リリースのタグをタグの ruleset で守り、作成・更新・削除をリポジトリの管理者だけに許すことを勧めます。これらの設定は掲載の条件ではありません。1 人で開発する作者は、ブランチの ruleset の bypass の一覧に、リポジトリの管理者 (Repository admin) を「For pull requests only」で足してください。自分の PR を承認なしでマージでき、強制 push と削除の禁止は残ります。「Always allow」は強制 push と削除も通すため使わないでください。

リポジトリの名前の変更と移管

このプラットフォームは GitHub のリポジトリの ID でリポジトリを追うので、リポジトリの名前を変えても作業は要りません。掲載は 15 分以内に新しい名前へ移り、旧い名前へのリンクは新しい名前へ転送されます。

旧い名前で別のリポジトリを作らないでください。旧い名前は、名前を変えたプラグインのためにこのプラットフォームが取っておき、その名前では別のリポジトリを登録しません。

リポジトリを別のアカウントや組織へ移管すると、掲載中のリリースはそのまま掲載し、次のリリースは管理者が確かめてから掲載します。

表示名を変えるときは、.audio-soko-kun/config.json の name を変えて新しいリリースを公開してください。