Deno JUCE Project Generator

URL一行でJUCEオーディオプラグインプロジェクトを生成

Quick Start GitHub

Overview

このツールは、DenoのURL実行機能を活用したJUCEオーディオプラグインプロジェクトジェネレータです。 URLを指定してdeno runするだけで、すぐに使えるJUCEプラグインプロジェクトが生成されます。 JUCEフレームワークはプロジェクト生成時にGitHubから自動的にクローンされます。

🎹

JUCEオーディオプラグイン

VST3、AU、StandaloneプラグインプロジェクトをモダンなCMakeセットアップで生成します。

🚀

インストール不要

Denoさえあれば、URLから直接実行できます。ツールのインストールは不要です。

🔧

型安全なビルドシステム

TypeScriptで書かれたビルドスクリプトにより、型安全なビルド自動化を実現します。

🌍

クロスプラットフォーム

Windows、macOS、Linuxで同じスクリプトが動作します。

生成されるプラグインフォーマット

🎛️

VST3

Windows, macOS, Linux

🍎

AU (Audio Unit)

macOSのみ

🖥️

Standalone

全プラットフォーム

JUCEライセンスに関する注意

重要: JUCE は Raw Material Software Limited が所有する商用/オープンソースフレームワークです。

このジェネレータを使用する際は、JUCEのライセンス条項を遵守する必要があります：

  • 個人/小規模商用利用: JUCE Starter license の下で無料で使用可能（年間収益$20,000まで、商用製品のリリース可）
  • 教育利用: JUCE Educational license の下で無料で使用可能（大学・学校・認定オンラインコースでの教育目的に限定、商用利用不可）
  • 商用利用: 年間収益$20,000超の場合、JUCEの商用ライセンス（Indie: $300,000まで / Pro: 無制限）が必要
  • オープンソース: AGPLv3の下で利用可能

このジェネレータで作成したプラグインを配布する前に、JUCEライセンス を確認してください。

このジェネレータはプロジェクト生成時に https://github.com/juce-framework/JUCE からJUCEをクローンします。JUCEフレームワーク自体はこのリポジトリには含まれていません。

Quick Start

Step 1: Denoをインストール

まだDenoをインストールしていない場合：

curl -fsSL https://deno.land/install.sh | sh
irm https://deno.land/install.ps1 | iex

Step 2: プラグインプロジェクトを生成

deno run --allow-read --allow-write --allow-run --allow-net --allow-env https://raw.githubusercontent.com/cocotone/deno-juce-project-generator/main/generator/generate.ts --name "MyAudioPlugin" --author "Your Name" --output ./my-audio-plugin --with-git

Step 3: ビルド & 実行

cd my-audio-plugin
deno task build        # プラグインをビルド
deno task run          # Standaloneアプリを実行

コマンドオプション

オプション 短縮形 デフォルト 説明
--name -n MyPlugin プラグイン名
--author -a Your Name 作者/会社名
--version -v 0.0.1 プラグインバージョン
--output -o (プラグイン名) 出力ディレクトリ
--manufacturer-code Manu 4文字のメーカーコード
--plugin-code Plug 4文字のプラグインコード
--juce-tag master JUCEのgitタグ/ブランチ
--vs-version (自動検出) Visual Studioバージョン: 2019, 2022, または 2026（Windowsのみ）
--with-git false Gitリポジトリを初期化

生成されるプロジェクト構造

<plugin-name>/
├── CMakeLists.txt          # JUCEプラグイン用CMake設定
├── deno.json               # Denoタスク設定
├── build.ts                # ビルドスクリプト (TypeScript/Deno)
├── build.config.ts         # ビルド設定
├── cmake-file-api.ts       # CMake File API統合
├── cmake-types.ts          # TypeScript型定義
├── .gitignore
├── External/
│   └── JUCE/               # JUCEフレームワーク (git clone)
└── Source/
    ├── PluginProcessor.h   # オーディオプロセッサヘッダー
    ├── PluginProcessor.cpp # オーディオプロセッサ実装
    ├── PluginEditor.h      # プラグインエディタ (GUI) ヘッダー
    └── PluginEditor.cpp    # プラグインエディタ実装

利用可能なビルドタスク

タスク 説明
deno task build Releaseモードでビルド
deno task build:debug Debugモードでビルド
deno task clean ビルドディレクトリを削除
deno task rebuild クリーンして再ビルド
deno task run ビルドしてStandaloneを実行
deno task run:debug DebugビルドしてStandaloneを実行

必要条件

使用技術