After Effectsで.jsxや.jsxbinを使うときは、ファイルの種類と、呼び出したい場所に合わせて実行方法を選びます。
最初の1回を試す通常のスクリプトは「スクリプトファイルを実行」から呼び出せるため、インストール先へコピーする前に動作を確認できます。
ドッキングできるパネルとして作られたスクリプトは、配布元の手順に従ってScriptUI Panelsへ配置し、「ウィンドウ」メニューから開きます。
2026年10月3日、WindowsのAE 26.5×89・日本語版で、自作の読取スクリプトの実行と、ScriptUIパネルの配置・起動・ドッキング・解除を確認しました。
エクスプレッション、スクリプト、パネルを区別する
エクスプレッションはプロパティへ入力して値を計算する式で、.jsxファイルを実行するスクリプトとは入力する場所が異なります。
スクリプトは一連の処理を実行し、レイヤーやプロジェクト内のアイテムなどを変更できるプログラムです。
ScriptUIパネルはスクリプトに操作画面を付けた形式で、配置するフォルダだけ変えても、通常のスクリプトがドッキング可能なパネルへ変わるわけではありません。
エフェクトのプラグインや拡張機能のインストーラーは、それぞれの作者が指定する方法で導入します。
まずは1回だけ実行する
作者の配布ページで、対応するAEのバージョン、OS、必要なファイル、処理対象を確認します。
実行前に作業プロジェクトを別名で保存し、配布物に付属するフォルダやファイルの構成を保ったまま、テスト用のコピーを開きます。
通常のスクリプトは「ファイル」→「スクリプト」→「スクリプトファイルを実行」から対象ファイルを選びます。
コンポジションやレイヤーの選択が必要なスクリプトは、作者の指定した範囲を選んでから実行してください。
この方法は、Scriptsフォルダへ追加したあとにメニューへ表示されるのを待たず、ファイルを指定して試すときにも使えます。
最初の練習：バージョンと言語を表示する
次の2行は、AEのバージョンと言語を読み取ってダイアログへ表示するための自作サンプルです。
レイヤーの作成や変更、ファイルの保存、ネットワーク通信、環境設定の書換えを含めていません。
// Read-only practice: display AE version and UI language.
alert("After Effects: " + app.version + "\nUI language: " + app.isoLanguage);
テキストエディタでUTF-8のread-ae-version.jsxとして保存し、「スクリプトファイルを実行」からこのファイルを選びます。
保存名がread-ae-version.jsx.txtになっていないか、ファイルの拡張子も確認します。
完成条件は、バージョンとUI languageの2行を確認し、OKで閉じたあとにプロジェクトのレイヤーや素材が増えていないことです。
日本語版の言語識別子としてja_JPが使われますが、バージョン文字列は環境ごとに異なります。
実機では「After Effects: 26.5×89」「UI language: ja_JP」と表示され、閉じた後も練習用プロジェクトの一覧と保存状態の表示に変化はありませんでした。
ScriptsとScriptUI Panelsの配置先
通常のスクリプトを「ファイル」→「スクリプト」の一覧から使う場合は、AEのScriptsフォルダへ配置します。
起動中に追加したものをその一覧へ表示するには、AEを再起動します。
ドッキング対応のパネルはScripts内のScriptUI Panelsへ配置し、再起動後に「ウィンドウ」メニューで探します。
Windowsの標準配置の例はC:\Program Files\Adobe\Adobe After Effects <version>\Support Files\Scriptsで、<version>は実際に使っているAEのバージョンへ読み替えます。
macOSの例はApplications/Adobe After Effects <version>/Scriptsで、パネルの場合はその中のScriptUI Panelsを使います。
複数のAEを入れている場合は、起動中のバージョンと配置先が一致しているか確認してください。
書込み権限がないフォルダへの配置に困った場合は、通常のスクリプトならファイル指定で実行できるか、パネルなら作者の導入方法に別の手順があるか確認します。
Windowsのユーザーフォルダで自作パネルを試す
今回の環境では、Program Files配下へコピーすると書込み権限のエラーになったため、ユーザー用のScriptUI Panelsフォルダで自作パネルを試しました。
配置先は%APPDATA%\Adobe\After Effects\26.5\Scripts\ScriptUI Panelsで、エクスプローラーのアドレス欄へ入力して開けます。
ここでの26.5は実行したAEのバージョンで、アプリのインストールフォルダ名「Adobe After Effects 2026」と表記が異なります。
異なるバージョンでは実際のフォルダを確認し、配布ツールは作者の指定した導入先と付属ファイルの構成を優先してください。
練習用ZIPを展開し、CGM Script Intro Practice 20261003.jsxだけをこのScriptUI PanelsへコピーしてAEを再起動します。
「ウィンドウ」メニューの下部から同名の項目を開き、「Show AE version」を押すと、先ほどと同じバージョンと言語のダイアログが出ます。
ダイアログを閉じ、パネルのタブをほかのパネルグループへドラッグするとドッキングできます。
今回の自作パネルはバージョンと言語の表示だけを行い、プロジェクトや外部ファイルを書き換えません。
外すときはパネルを閉じてAEを終了し、自分でコピーした同名ファイルだけを別の場所へ移動してから再起動します。
実機でも、配置したファイルを移動して再起動した後に「ウィンドウ」メニューから項目が消えることを確認しました。
この確認はWindowsのAE 26.5と自作.jsxパネルに限り、macOS、別バージョン、第三者の.jsxbinやインストーラーの動作確認は含めていません。
AE 26.5のメニューには「スクリプトファイルをインストール」「ScriptUIパネルをインストール」も表示されましたが、今回の手順では使用していません。
.jsxと.jsxbin、付属ファイルの扱い
.jsxと.jsxbinは、AdobeがAfter EffectsのExtendScriptファイルの拡張子として案内している形式です。
jsxbinをテキストエディタへ貼り直したり、拡張子だけjsxへ変えたりする導入方法は使いません。
付属するアイコン・設定・ライブラリなどを参照するツールは、主ファイルだけ移動すると必要なファイルを見つけられなくなる場合があります。
メニューに出ない・動かないときの確認順
通常のスクリプトは「ファイル」→「スクリプト」、ScriptUIパネルは「ウィンドウ」で探し、ファイル形式と表示場所を取り違えていないか確認します。
配置先のAEバージョン、ScriptsとScriptUI Panelsの違い、追加後の再起動、ファイル名の末尾を順に確認します。
実行するとエラーになる場合は、エラーの行番号とメッセージ、選択対象、作者の対応バージョン、付属ファイルを記録します。
エクスプレッション用の式をスクリプトとして保存していないか、通常のスクリプトを式の入力欄へ貼っていないかも確認します。
ファイル書込みや通信が必要なツールでは専用の許可設定が関係しますが、今回の読取サンプルはそれらの処理を使いません。
必要な権限と用途は作者の説明で確認し、エラーを直す目的だけで許可設定を一律に変更しないでください。
取り消しとアンインストール
レイヤー等を変更するスクリプトでは、実行直後に「編集」→「取り消し」でどの範囲を戻せるか確認します。
すべてのスクリプトが1回の取り消しにまとまるとは限らず、外部へ保存したファイルや送信したデータが取り消しで戻る保証もありません。
変更前のプロジェクトと式・キー・選択対象を控え、取り消しが効かない場合は保存済みのコピーへ戻します。
導入したファイルを外す場合はAEを終了してから、自分で配置したファイルと付属物だけを移動し、再起動後のメニューと必要な機能を確認します。
作者のインストーラーで入れたツールや、ほかのツールと共通のライブラリは、作者の解除手順を使います。
練習用スクリプトをダウンロード
自作の読取スクリプト・ScriptUIパネル・説明書をダウンロード（ZIP）できます。
read-ae-version.jsxはファイル指定で1回実行する練習用、CGM Script Intro Practice 20261003.jsxはパネルの配置とドッキングを試す練習用です。
外部素材やプラグインは不要で、実行結果はバージョンと言語を表示するダイアログです。
次に試すスクリプトと関連する記事
素材整理を試す場合はプロジェクト内の移動範囲を確認し、スクリプトを増やしたあとにランチャーで整理する流れを使えます。
参考資料
Adobe：スクリプト、Scripting Guide：app.version・app.isoLanguage・Undoグループ、Good Boy Ninja：配布ツールのパネル導入を参照しました。
