BUtler（バトラーと発音します）はAviUtl用のコマンドラインパッケージマネージャーです。
-
apt風の簡単操作：Debian系のLinuxディストリビューションで採用されているパッケージマネージャー、aptに似た雰囲気を持つコマンド体系を採用。迷うことなく使い始めることができます。
-
豊富なパッケージ：200を超えるパッケージがBUtlerのコミュニティリポジトリに登録済み。あらゆるプラグインやスクリプトを簡単にインストールできます。
-
依存関係も自動で解決：必要なパッケージは自動でインストール。バージョンの相違などによる不具合に悩むこともありません。
-
シンプル・イズ・ベスト：全てのファイルをBUtlerの管理フォルダー内に展開。動作に必要なファイルはシンボリックリンク、設定ファイルはコピーがあるべき場所に配置されます。
-
PowerShellのインストール方法についてはMicrosoftの記事をご参照ください。
-
もしくは、以下のコマンドで最新のPowerShellをインストールできます。
winget install --id Microsoft.Powershell --source winget
- BUtlerでシンボリックリンクを使用したパッケージの管理を行うためには、開発者モードを有効にして標準ユーザー権限でシンボリックリンクを作成可能にする必要があります。
Tip
開発者モードを有効にできない、もしくはNTFS以外のファイルシステムを利用していてシンボリックリンクを利用できない場合は常にコピーを使用するように設定を変更できます。
-
Win + Rを押して「ファイル名を指定して実行」を開き、以下のURIを貼り付けて開きます。
ms-settings:developers -
「開発者モード」をオンにします。プロンプトが表示されたら「はい」を選択します。
-
AviUtlをセットアップするフォルダーを作成し、そのフォルダーに移動します。
- セットアップ済みの環境への追加はサポートされていません。
-
以下のコマンドをコピーし、アドレスバーに貼り付けてEnterキーを押します。
pwsh -ExecutionPolicy Bypass -Command "[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/Per-Terra/butler/main/installer.ps1'))"
-
BUtlerという名称のショートカットをダブルクリックして、プロンプトが起動すればインストールは成功です。
- 最新のパッケージマニフェストを取得したら、まずはAviUtlと拡張編集をインストールしてみましょう。
- BUtlerを起動して、以下のコマンドを実行します。
install aviutl exedit=0.92installはパッケージをインストールするコマンドです。- パッケージはそれぞれ固有の識別子を持ちます。大文字と小文字は区別されません。
- バージョンを指定するときは、識別子とバージョンを
=で結びます。- バージョンを指定するとそのバージョンに固定されます。バージョンが固定されたパッケージが自動的にアップグレード（ダウングレード）されることはありません。
- バージョンの固定を解除するときは、バージョンを指定せずに再度
installコマンドを実行します。
removeコマンドとpurgeコマンドは、どちらもパッケージを削除するコマンドですが、動作が少しだけ異なります。- 例として、先程インストールしたAviUtlと拡張編集を削除してみましょう。
- 必ずAviUtlを終了してから実行してください。
- もしまだ一度も起動していないのなら、違いが分かりやすいようにいったん起動して、終了しましょう。
remove aviutl exeditremoveコマンドは、設定ファイルを保ったままパッケージを削除します。- フォルダー内には
aviutl.ini、aviutl.sav、デフォルト.cfgが依然として残っているはずです。
- フォルダー内には
- 「
exedit.iniは？」と思いましたか？ 流石です。removeコマンドでもユーザーによって変更されていないファイルは自動的に削除されます。- もしあなたが
exedit.iniに変更を加えていたのなら削除されずに残っているはずです。
- では、さらに
purgeコマンドも実行してみましょう。
purge aviutl- これで、先程の3つのファイルも削除されました。
purgeコマンドは、設定ファイルも含めてパッケージのすべてのファイルを削除します。- 設定ファイルには（パッケージマニフェストに登録されていれば）パッケージによって自動生成されるファイルも含みます。
removeコマンド実行後も、設定ファイルが残っているパッケージはBUtlerの管理下に保たれます。- 任意のタイミングで
purgeコマンドを実行して、残っているファイルを削除することができます。
- 任意のタイミングで
searchコマンドを使用して、インストール可能なパッケージを検索することができます。- 例として、「エンコード」を指定して検索してみましょう。
search エンコード実行結果
Identifier Version ReleaseDate Developer Section DisplayName Description
---------- ------- ----------- --------- ------- ----------- -----------
cmpwnd 0.1 2016-02-07 aoytsk Plugin/Other 比較ウィンドウ 2つの動画を比較するためのプラグイン…
easymp4 0.1.1-fix 2020-04-23 aoytsk Plugin/Output かんたんMP4出力 MP4でエンコードする出力プラグイン
ffmpegOut 1.09 2023-10-25 rigaya Plugin/Output ffmpegを使用してエンコードを行う出力プラグイン
NVEnc 7.40 2023-12-10 rigaya Plugin/Output NVIDIAのNVEncを使用してエンコードを行う出力プラグイン…
QSVEnc 7.58 2024-01-04 rigaya Plugin/Output Intel Media SDK を使用してエンコードを行う出力プラグイン…
svtAV1guiEx 1.23 2023-10-22 rigaya Plugin/Output 拡張 SVT-AV1 出力(GUI) Ex SVT-AV1を使用してエンコードを行う出力プラグイン
VCEEnc 8.21 2023-12-10 rigaya Plugin/Output AMDのVCE(VideoCodecEngine)を使用してエンコードを行う出力プラグイン…
VVenCguiEx 0.00-beta4 2023-05-09 rigaya Plugin/Output 拡張 VVenC 出力(GUI) Ex VVenCを使用してエンコードを行う出力プラグイン
x264guiEx 3.27 2023-12-06 rigaya Plugin/Output 拡張 x264 出力(GUI) Ex x264を使用してエンコードを行う出力プラグイン…
x265guiEx 4.16 2023-10-12 rigaya Plugin/Output 拡張 x265 出力(GUI) Ex x265を使用してエンコードを行う出力プラグイン…
- Identifier（識別子）、DisplayName（表示名）またはDescription（説明）のいずれかに「エンコード」を含むパッケージが表示されました。
- パッケージの操作（インストール、削除など）にはここに表示された識別子を使用します。
- 全てのパッケージをアップグレード（更新）したいときは以下のコマンドを実行します。
upgrade- 指定したパッケージのみをアップグレードすることもできます。
- この場合の動作は
installコマンドと同様です。
- この場合の動作は
- バージョンを固定したパッケージはアップグレードされません。
- パッケージを構成するファイルの一部を削除してしまったなどの理由により、パッケージを再インストールしたいときは以下のコマンドを実行します。
reinstall- インストールされているすべてのパッケージに対して
removeとinstallを自動的に行いますが、remove時の依存関係チェックがスキップされます。 - 指定したパッケージのみを再インストールすることもできます。
- BUtlerは起動時に自動的にパッケージマニフェストを更新しますが、手動で更新したいときは以下のコマンドを実行します。
update- デフォルトでは、BUtlerのコミュニティリポジトリから情報を取得します。
- 利用可能なコマンドを表示します。
- インストール済みのパッケージを一覧表示します。
- 利用可能なパッケージを検索して、一覧表示します。
- 指定されたパッケージの詳細な情報を表示します。
-
指定されたパッケージをインストールします。
-
バージョンを指定するとそのバージョンで固定され、アップグレードされることはありません。
-
例：/AviUtlの推奨構成をインストールする
install aviutl exedit=0.92 L-SMASH-Works InputPipePlugin easymp4 patch.aul
- 指定されたパッケージを再インストールします。
- 何も指定しなければ全てのパッケージを再インストールします。
- 指定されたパッケージを削除します。
- 設定ファイルは残ります。
- 指定されたパッケージを設定ファイルを含めて完全に削除します。
- remove後でも実行できます。
- 自動でインストールされたが、もはや必要でないパッケージを削除、または完全に削除します。
- パッケージマニフェストを更新します。
- パッケージ識別子を指定した場合の動作は
installと同じです。 - パッケージ識別子を指定しなかった場合はインストールされた全てのパッケージをアップグレードします。
- BUtler自体の更新を確認、または適用します。
- 対話型シェルを起動します。(コマンドを何も指定せず起動したときの既定値)
- デフォルトでは起動時に
selfupdateとupdateを自動で実行します。- 設定で変更可能です。
.butler/config.yaml を編集することでBUtlerの動作を変更することができます。
UseSymbolicLinks：シンボリックリンクを使用するかどうかfalseにセットした場合、ファイルは常にコピーされます。- 開発者モードを有効にしない場合、またはNTFS以外のファイルシステムを利用している場合は
falseにセットします。
Interactive.AutoSelfUpdate：対話型シェル起動時に自動でselfupdateコマンドを実行するかどうかInteractive.AutoUpdate：対話型シェル起動時に自動でupdateコマンドを実行するかどうか
.butler/cacheはキャッシュフォルダーです。このフォルダーはいつ削除しても動作に問題はありません。容量を圧迫している際にお試しください。- Windowsではジャンクションを作成することで別のフォルダーにキャッシュを保存することができます。
- 複数のフォルダにBUtlerをインストールしていて、キャッシュを共通化したい場合に有効です。並列実行は考慮されていませんのでお気をつけください。
.butler/packagesフォルダー以下にはファイルの実体が含まれています。このフォルダーを削除してしまってもreinstallコマンドで復旧することができます。- この仕様を利用して、
.butler/cacheフォルダーと.butler/packagesフォルダーを削除し、ZIP圧縮することで設定ファイルのみを持ったアーカイブを作成することができます。- この際、シンボリックリンクはZIPファイルの仕様上保持されません。
- アーカイブを展開したら、BUtlerを起動し
updateコマンドとreinstallコマンドを順に実行することで元の環境を復元することができます。
MIT Licenseに基づく