AviUtl2 Catalog Web
汎用プラグイン

aviutl2-alias-inserter

スクリーンショット

aviutl2-alias-inserterのスクリーンショット 1aviutl2-alias-inserterのスクリーンショット 2

概要

Steam Deck などの外部デバイスから挿入できるようにする

詳細説明

aviutl2-alias-inserter

standard-readme compliantLicense: MIT

Steam Deck などの外部デバイスからワンボタンで AviUtl2（ExEdit2）タイムラインに .object エイリアスファイルを挿入する Rust 製プラグインと CLI クライアント。

AviUtl2 の汎用プラグイン（.aux2）が Named Pipe サーバーとして常駐し、CLI クライアントからのパス文字列を受け取って EDIT_SECTION::create_object_from_alias() SDK API 経由でオブジェクトを挿入します。Steam Input のプロファイルと組み合わせることで、コントローラーの1ボタン操作でエイリアスを挿入できます。

背景

AviUtl2（ExEdit2、KENくん氏による 64bit 対応版）で映像編集を行う際、同じエイリアスオブジェクトを繰り返しタイムラインに配置する作業が発生します。本プロジェクトはこの手順を自動化し、Steam Deck 等のコントローラーのボタン1つで挿入できるようにすることを目的としています。

公式 Plugin SDK が提供する EDIT_SECTION::create_object_from_alias() および EDIT_HANDLE::call_edit_section_param() API を使用しているため、リバースエンジニアリングは不要であり、SDK 更新への追従も容易です。

対象: 旧 AviUtl（32bit）ではなく AviUtl2（ExEdit2、64bit） のみを対象とします。旧形式（.exo）は非対応です。

インストール

前提条件

  • Windows 10 または Windows 11（64bit）
  • AviUtl2（ExEdit2）がインストール済みであること

動作確認は AviUtl2（ExEdit2）開発時点の最新版で行っています。AviUtl2 のバージョンアップ後に動作しない場合はリリースページで対応状況を確認してください。

リリースからインストール（推奨）

  1. GitHub Releases から最新版の zip をダウンロードする。
  2. zip を展開する。
  3. aviutl2_alias_inserter.aux2 を C:\ProgramData\AviUtl2\plugins\ にコピーする。
  4. alias_inserter_cli.exe を任意の場所（例: C:\ProgramData\AviUtl2\）にコピーする。
  5. AviUtl2 を起動するとプラグインが自動的に読み込まれ、Named Pipe サーバーが起動します。

ソースからビルド

ビルドには追加で以下が必要です。

  • Rust toolchain — x86_64-pc-windows-msvc ターゲット
  • aviutl2-cli — ビルド・デプロイ・パッケージング用 CLI ツール（au2 コマンド）
  • aviutl2-rs（Cargo.toml で自動取得）

aviutl2-rs は開発中の crate であり、API の破壊的変更が発生する可能性があります。

aviutl2-cli は Releases からダウンロードするか、cargo-binstall でインストールできます。

cargo binstall aviutl2-cli

リポジトリをクローンし、初回セットアップを実行します。

git clone https://github.com/beive60/aviutl2-alias-inserter.git
cd aviutl2-alias-inserter
au2 prepare

au2 prepare は AviUtl2 本体のダウンロード・展開と、設定ファイルの JSON Schema 出力、成果物へのシンボリックリンク作成を一括で行います。

開発ビルド

au2 develop

プラグイン（.aux2）と CLI（.exe）をビルドし、開発用 AviUtl2 ディレクトリに自動で配置します。

リリースパッケージの作成

au2 release

リリース用にビルドしたパッケージ（zip）を生成します。生成された zip には以下のファイルが含まれます。

ファイル 説明
aviutl2_alias_inserter.aux2 AviUtl2 プラグイン本体
alias_inserter_cli.exe CLI クライアント

使い方

CLI

AviUtl2 が起動した状態で、挿入したい .object ファイルの絶対パスを引数に指定して実行します。

alias_inserter_cli.exe "C:\path\to\your\alias.object"

成功すると現在のタイムラインカーソル位置にオブジェクトが挿入されます。エラー時は標準エラー出力にメッセージが表示され、非ゼロの終了コードで終了します。

Steam Deck 統合

Steam Input のプロファイルで特定ボタンの「コマンドの実行」アクションに以下のように設定します。

alias_inserter_cli.exe "C:\エイリアス\テキスト.object"

アーキテクチャ

[Steam Deck ボタンなど]
       |
       v
[alias_inserter_cli.exe] --UTF-16LE(path)--> [Named Pipe]
                                                  |
                                    [aviutl2_alias_inserter.aux2]
                                         (ワーカースレッド)
                                                  |
                                   call_edit_section_param()
                                                  |
                                         (メインスレッド)
                                                  |
                                   create_object_from_alias()
                                                  |
                                         [AviUtl2 タイムライン]

IPC プロトコル

項目 仕様
通信方式 Named Pipe（\\.\pipe\aviutl2_alias_inserter）
方向 CLI クライアント → プラグイン（単方向）
エンコーディング UTF-16LE（BOM なし）
ペイロード .object ファイルの絶対パス
最大ペイロード長 32,768 バイト

クレジット

  • sevenc-nanashi/aviutl2-rs — AviUtl2 Plugin SDK の Rust バインディング。本プロジェクトのプラグイン実装はこの crate に依存しています。
  • aviutl2-cli - AviUtl2のプラグイン・スクリプト開発用コマンドラインツール。本プロジェクトのプラグインの開発はこのツールを使用して行われています。

コントリビューション

Issue や Pull Request を歓迎します。GitHub Issues で質問・提案を受け付けています。

詳細は CONTRIBUTING.md を参照してください。

ライセンス

MIT © 2026 べいぶ