AutoZWJ
概要
音MAD/YTPMV制作をAviUtl2のタイムラインへ同期。
詳細説明
AutoZWJ AviUtl2のプラグイン
音MAD/YTPMV向けのトラック同期支援プラグイン。RPP/MIDIなど複数のプロジェクト形式に対応しています。 English | 简体中文 | 日本語
REAPERプロジェクトファイル(.rpp)、標準MIDIファイル(.mid)、UTAU/OpenUTAUプロジェクト(.ust / .ustx)、またはLRC歌詞ファイル(.lrc)内の素材を、AviUtl2のタイムライン上に既存のオブジェクトをテンプレートとして一括生成するプラグインです。
機能概要
- REAPER
.rpp/ 標準MIDI.mid/ UTAU.ust/ OpenUTAU.ustx/ LRC.lrcファイルを解析 - タイムライン上の既存オブジェクトをスタイルテンプレートとして使用し、エフェクトチェーンとパラメータ設定を継承
- マルチソースマッピング:複数のテンプレートオブジェクトを選択し、順次ローテーション / ランダム抽選 / コードマッピング / アニメーションシーケンス [beta] で割り当て
- エフェクトチェーンエディタ:テンプレートのエフェクトチェーンを読み取り専用で表示し、固定値 / 変数マッピング / 式評価によるパラメータbakeを設定
- スクリプト変数システム:
$note.velocity$ / 127 * 200などの式でbake値を生成 - BPMグリッド同期:MIDI/RPPのテンポマップをAviUtl2のBPMグリッドに適用
- 多言語対応:簡体字中国語 / English / 日本語に対応し、ホストUIの言語を自動検出
- テンプレート下層に自動レイヤー割り当て、コンパクトに整列
- 交互反転、オブジェクト長制御、マルチノート戦略、偶数行替え
- オブジェクトとノートの同期:次の音符までの伸長、固定フレーム、ギャップ生成、最終フレーム固定(次の音符までの伸長を選択可能)
- 現シーンのFPS・解像度を自動取得、セッション間で設定を永続化
インストール
AviUtl2 Catalogからインストール
AviUtl2 CatalogからAutoZWJをダウンロードしてインストールする方法を推奨します。プラグインの管理と更新が容易になります。
ドラッグ&ドロップでインストール
AutoZWJ.aux2 ファイルをAviUtl2のプレビューウィンドウへ直接ドラッグ&ドロップすると、自動的にインストールされます。
手動インストール
AutoZWJ.aux2 を AviUtl2 の Plugin フォルダに配置し、AviUtl2 を起動してください。
クイックスタート
-
開始
タイムライン上の任意のオブジェクトを選択し、右クリック → インポート設定...。タイムラインにオブジェクトがない場合は、まず任意の素材を1つ配置してテンプレートにするか、手順2に進んでプロジェクトファイルをドロップしてください -
プロジェクト読込
プロジェクト未読込の場合、プラグインウィンドウは自動的にインポートページを開きます:.rpp/.mid/.ust/.ustxファイルを AviUtl2 ウィンドウにドロップするか、インポートページで最近のプロジェクト / 参照... を選択します。続いて生成するトラックをチェックし、インポート実行 をクリック -
設定・生成
設定ページでパラメータを調整 → OK または 適用 をクリック
詳細なチュートリアル・機能説明はドキュメントをご参照ください。
ビルド
MinGW-w64 (g++ 15.2+)、CMake 3.20+ が必要です。AviUtl2 SDK は git サブモジュールで管理されており、Dear ImGui は src/thirdparty/imgui に固定バージョンで同梱されています。初回クローン後にサブモジュールを初期化してください:
git submodule update --init
cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug -G "MinGW Makefiles"
cmake --build build
生成物: build/AutoZWJ.aux2
正式リリースは GitHub Actions が v* タグのプッシュ時に Release ビルドを実行し、GitHub Release として公開します。詳細は ビルドガイド を参照してください。
参考
- AviUtl2 / AviUtl ExEdit2 Plugin SDK
- Dear ImGui
- RPPtoEXO ver2.0
- OtomadHelper
- om_midi
- import_midi_tempos.aux2
- UltraPaste
コントリビューション
バグ修正、機能改善、ドキュメント更新、翻訳など、AutoZWJへのコントリビューションを歓迎します。以下の手順を推奨します:
- 本リポジトリをForkし、作業用のブランチを作成する
- 変更を行い、コミット前に必要なビルドとテストを実施する
- 変更の目的、主な変更点、検証結果を記載してPull Requestを作成する
大規模な機能追加やアーキテクチャ変更については、実装を始める前にIssueで方針をご相談ください。
Issueの報告
問題や機能提案がある場合は、Issuesから報告してください。可能な範囲で以下の情報を添えてください:
- AutoZWJ、AviUtl2、Windowsの各バージョン
- 使用したプロジェクト形式(RPP、MIDI、UST/USTX、LRC)と再現手順
- 期待される結果と実際の結果
- 関連するログ、スクリーンショット、必要に応じて機密情報を除いた最小構成のサンプルファイル
重複を避けるため、投稿前に既存のIssueをご確認ください。
寄付
AutoZWJがお役に立ちましたら、以下のプラットフォームから継続的な開発をご支援いただけます。
ライセンス
MIT License