目次
コントロールバーボタンのカスタマイズ
概要
コントロールバーは 2 つのエリアに分かれています:
- 左側（ファイルレベル）: 外部アプリケーションとの連携やクイックアクション（例: 「別のプログラムで開く...」、「エクスプローラーで表示」）。これらは
設定 > コントロールで設定できます。 - 右側（プレビューレベル）: プレビュー表示の操作（回転、消音、ズームなど）。
このガイドでは、左側エリアの拡張について説明します。
コントロールの追加
設定 > コントロール では、標準ボタンの管理、カスタムアクションの作成、コントロールプラグインのインストールが行えます。
1. カスタムアクション
- アクション一覧の下にある + をクリックし、起動するプログラムやスクリプトを選択します。
- 右側のパネルでアクションの詳細を設定します:
- 名前 (Name): ツールチップに表示される表示名。
- 実行可能ファイル (Executable): 起動対象の実行ファイル (
.exe) のパス。 - 引数 (Arguments): コマンドライン引数。ファイルパスを渡すには
"${input_file}"などのプレースホルダーを使用します。 - ファイル形式 (File Formats): 対象の拡張子（例:
png,zip）または特別なトークン（例:${type_folder}）。 - 起動成功後にプレビューを閉じる (Close preview after successful launch): 外部プログラムが正常に起動したらプレビューウィンドウを閉じます。Seer はプログラムの終了を待機しません。
2. コントロールプラグイン
コントロールプラグインはパッケージ化されたアクションを提供します。PC 内の既存のプログラムやスクリプトを指定するカスタムアクションとは異なります。
公式コントロールプラグイン
公式コントロールプラグインパッケージはダウンロードセンターに集約されています。プラグインのダウンロード - コントロール から必要な .zip パッケージをダウンロードしてください。解凍せずに 設定 > コントロール で直接インポートできます。
ダウンロードしたパッケージのインストール
設定 > コントロールで、リストの下にある + をクリックします。- ダウンロードした
.zipを直接選択するか、解凍したパッケージからplugin.jsonを選択します。 - 詳細パネルで、インポートされたアクションの対応形式と動作を確認します。
- OK をクリックして保存・適用します。キャンセル をクリックするとインポートを破棄します。
パッケージが別の機能タイプである場合、Seer は自動的に対応する設定ページへ案内します。
アクションの管理
- 並べ替え: リスト内の項目をドラッグ＆ドロップして、コントロールバー上のボタンの並び順を変更します。
- 切り替え: アクションを選択し、詳細パネルで 有効 を切り替えて設定を保存します。
- ルールのカスタマイズ: インストール済みプラグインの場合、対応するファイル形式や CLI 引数をいつでもカスタマイズしたり、初期値にリセットしたりできます。
- 標準ボタン: 標準アクション（既定のアプリで開く、エクスプローラーで表示、同種ファイルの移動）は個別に表示/非表示を切り替えられます。
プレースホルダーと特別なトークン
1. コマンドライン引数のプレースホルダー
外部ツール起動時に実行時動的解決される組み込みトークンが用意されています:
| プレースホルダー | 説明 | 例 |
|---|---|---|
${input_file} |
プレビュー中のファイルまたはフォルダーの絶対パス。 | C:\Users\Username\Documents\file.zip |
${7z} |
同梱されている 7z.exe の絶対パス。実行可能ファイル 欄でも使用できます。 |
C:\Program Files\Seer\plugins\7z.exe |
${seer_exe} |
Seer.exe の絶対パス。 |
C:\Program Files\Seer\Seer.exe |
${seerviewer_exe} |
SeerViewer.exe の絶対パス。 |
C:\Program Files\Seer\SeerViewer.exe |
${seer_dir} |
Seer.exe のあるフォルダー。 |
C:\Program Files\Seer |
${screenshot} |
現在のビューの一時 PNG スクリーンショットの絶対パス。 | C:\Users\Username\AppData\Local\Temp\Seer\screenshot\view_1.png |
パスにスペースが含まれる可能性がある場合は、プレースホルダーを二重引用符で囲んでください: "${input_file}"。
独自のコントロールプラグインを作成しますか？各プラグイン機能がサポートするプレースホルダーや、プレースホルダーとマッチャートークンの完全な対応表については、プラグインの開発と実装 を参照してください。
2. ファイル形式の特別なトークン
特殊なファイルタイプやフォルダーを一致させるには、ファイル形式 欄で以下のトークンを使用します:
| トークン | 説明 |
|---|---|
${type_folder} |
ディレクトリおよびフォルダーに一致します。 |
${type_file} |
すべてのファイル（拡張子のないファイルを含む）に一致します。 |
${type_all} |
すべての項目（ファイルとフォルダーの両方）に一致します。 |
${type_pdf} |
PDF ドキュメントに一致します。 |
${type_image} |
画像ファイルに一致します（内蔵の画像ビューアーと同じ分類）。 |
${type_media} |
音声/動画ファイルに一致します（内蔵のメディアビューアーと同じ分類）。 |
${type_web} |
Web ページ（HTML・Markdown）に一致します（内蔵の HTML ビューアーと同じ分類）。 |
${type_text} |
テキスト/コードファイルに一致します（内蔵のテキストビューアーと同じ分類）。 |
${type_none} |
上記のいずれのカテゴリーにも属さないファイルに一致します（例: アーカイブ、実行ファイル）。 |
注: トークンは大文字と小文字を区別せず、スペースまたはカンマを使用して通常の拡張子と組み合わせて指定できます（例: png jpg ${type_folder}).
${type_*} カテゴリートークンは、内蔵ビューアーと同じ拡張子テーブルでファイルを分類します。ファイルのみに一致するため、フォルダーも対象にする場合は ${type_folder} と組み合わせてください。
3. 設定例: 7-Zip によるアーカイブの展開
同梱の 7-Zip を使用してアーカイブを展開するボタンを追加する場合:
- 実行可能ファイル:
${7z}（またはご自身の7z.exeを指定）。 - 引数:
x "${input_file}" -r -y -o"C:\Output\Path\" - ファイル形式:
zip rar 7z tar gz
パラメータの詳細:
* x: フルパスを維持して展開。
* "${input_file}": 対象のアーカイブファイル。
* -r: サブディレクトリを再帰的に処理。
* -y: すべての問い合わせに「はい」と応答（上書き）。
* -o"...": 出力先フォルダー。