プレビュープラグイン

プレビュープラグイン は、動画、音声、複数ページの文書などの形式への対応を追加する機能です。プラグインは個別にインストールします。

プラグインのプレビューは、更新資格の範囲内で、すべての有料プランに含まれます。ローカル ZIP からのインストールを含め、インストール、更新、利用には対象となる有料ライセンスの権利が必要です。ライセンスと利用規約を参照してください。

プラグインの実行方法

各プラグインは 独立したプロセス で動作します。tessoa はフレームのデコードや動画再生が必要なときだけ起動し、待機状態が続くとプラグイン自身が終了します。プラグインがクラッシュしたり応答しなくなったりしても、tessoa 本体には影響しません。そのファイルはアイコン表示に戻り、その他の操作は続けられます。

プラグインページにも、プラグインは独立したプロセスで動作し、クラッシュしても tessoa 本体には影響しません。有効化・無効化・アンインストールは再起動なしで即時反映されます。 と表示されます。

インストールしたパッケージは、次のユーザーフォルダーに展開します。設定と一緒には移行されません。

システム	保存場所
Windows	%LOCALAPPDATA%\tessoa\plugins\<plugin id>\
macOS	~/Library/Application Support/tessoa/plugins/
Linux	$XDG_DATA_HOME/tessoa/plugins/

プラグインページを開く

次の 2 つの入口は同じページを開きます。

• ウィンドウ左上のメニューボタンをクリックし、プラグイン（Plugins） を選びます。
• 設定を開き、システム（System） グループの プラグイン をクリックします。

システム グループには、用途の異なる 2 つのスイッチもあります。

設定項目	動作
プラグインを有効にする（Enable plugins）	プラグインを読み込むかどうかを指定します。オフにすると、インストール済みプラグインは動作せず、未インストールと同じ状態になります
インストール可能なプラグインを提案（Suggest installable plugins）	プラグインが必要な形式を開いたときに、プレビューに案内を表示するかを指定します

プラグインソースからインストールする

プラグインページの下半分には、インストールできるプラグイン（Available plugins） があり、このコンピューターで利用できるものを一覧表示します。各行の末尾のボタンには 5 つの状態があります。

ボタン	意味
インストール（Install）	まだインストールしていません。クリックするとダウンロードを開始します
更新（Update）	旧バージョンがインストールされています。下の行には 新しいバージョン x.y.z があります（version x.y.z available） と表示します
インストール済み（Installed）	最新版です。クリックできません
パーセント表示	ダウンロードとインストール中です。100% まで進みます
本体の更新が必要（Needs newer host）	新しい tessoa が必要です。下の行には tessoa x.y.z 以降が必要です（requires tessoa x.y.z or newer） と表示します

インストール手順：

1. プラグインページを開き、プラグイン一覧を取得しています…（Fetching the plugin list…） が一覧に変わるまで待ちます。
2. 必要な行の インストール をクリックします。
3. 初めてインストールするときは、先にプラグイン利用規約を表示します。読んでから 同意して続ける（Agree & Continue） をクリックします。今はしない（Not now） を選ぶと、インストールせずにプラグインページへ戻ります。
4. ボタンの進捗が完了すると、上部の インストール済みプラグイン（Installed plugins） に項目が表示されます。

ダウンロードが中断した場合は、次に インストール をクリックすると中断位置から再開します。最初からやり直すことはありません。

注記

tessoa はバックグラウンドでプラグインの更新を確認しません。 一覧は、プラグインページを開いたとき、または 再スキャン（Rescan） をクリックしたときだけ取得します。再スキャン ボタンは、インストール済みプラグインの再検出と、プラグインソースの再取得を同時に行います。

ファイルからインストールする

.zip のプラグインパッケージを持っている場合：

1. プラグインページ右上の ファイルからインストール…（Install from file…） をクリックします。
2. プラグインパッケージを選択（Choose a Plugin Package） ダイアログで .zip ファイルを選び、インストール をクリックします。
3. プラグイン … をインストールしました（Installed plugin …） という通知が表示され、プラグインページに項目が追加されます。

インストール済みプラグインの新しいバージョンを入れるときは、先に古いものをアンインストールする必要はありません。

失敗した場合は、通知に理由を表示します。

メッセージ	意味
プラグインパッケージではありません（ルートに plugin.toml がありません）	違うファイルを選択しています
プラグインマニフェスト（plugin.toml）が無効です	パッケージの説明ファイルを読み取れません
展開に失敗しました — パッケージが破損している可能性があります	ダウンロードが不完全か、ファイルが破損しています
旧バージョンを置き換えられませんでした（ファイル使用中の可能性）— 後でもう一度お試しください	古いバージョンのファイルが使用中です。しばらくしてから再試行してください
パッケージの検証に失敗しました（転送中の破損、または改ざんの可能性）。インストールを中止しました。	ソースから取得したパッケージのチェックサムが一覧の値と一致しません

インストール済みプラグインを管理する

インストール済みプラグイン では、各プラグインを 2 行で表示します。1 行目は名前とバージョン、2 行目は ID、対応する拡張子、ディスク上のサイズ、現在の状態です。

行末のドロップダウンには、次の 4 つの操作があります。

項目	動作
有効にする（Enable） / 無効にする（Disable）	無効にしたプラグインは、未インストールと同じように何も出力しません。再び有効にすると、すぐ反映されます
保存場所を開く（Open file location）	ファイルマネージャーでプラグインのフォルダーを開きます
アンインストール（Uninstall）	プロセスを停止し、フォルダーを削除します。再インストールは 1 操作でできるため、確認なしで実行します

通常の状態表示は 有効（Enabled） または 無効（Disabled） です。問題がある場合は、代わりに理由を表示します。

状態	意味
連続して失敗したため今回の起動中は停止中	2 回続けて失敗したため、tessoa は今回の起動中、そのプラグインへの要求を停止します。tessoa の再起動、または無効化してから再び有効化するとリセットします
プロトコルバージョンが非互換	異なるバージョンの tessoa 向けに作られたプラグインです
このプラットフォーム用の実行ファイルがありません	パッケージ内に使用中のシステム用のプログラムがありません
バージョン x.y.z のインストールに失敗	前回の更新が完了せず、古いバージョンを使い続けています

インストール後のプレビュー

プラグインが対応する形式では、アイコンビューのサムネイルと、ギャラリー、カラムのプレビュー、側面の詳細パネル、プレビュータブでの表示を利用できます。

動画と音声では、カバー画像の中央に ▶ が表示されます。クリックすると再生し、画像の下に再生バーが現れます。

コントロール	動作
⏯	一時停止 / 再開。音声と映像を同時に止めます
進捗バー	クリックした位置に移動します
時刻	現在の再生位置を mm:ss で表示します
♪	ミュート / 解除。ミュートは一時停止ではなく、映像は続きます
音量バー	クリックして音量を設定し、ミュートも解除します。音量とミュート状態は再起動後も保持します

次の動作に留意してください。

• 別のファイルに切り替えるか、タブを閉じると再生を終了します。
• 別のタブに切り替えると一時停止します。戻っても停止位置を保ち、自動で再開しません。
• ウィンドウを最小化すると、音声を続け、映像を止めます。
• 2 つのウィンドウで再生している場合は、後から再生を開始した ウィンドウだけが音声を出します。もう一方の映像は続きます。

複数ページの文書

ページ移動に対応するプラグインは、文書をページごとに表示できます。カバー画像だけを提供するプラグインには、ページ操作を表示しません。たとえば tessoa-office 0.2.0 以降 は、tessoa 0.24.0 以降と組み合わせると、複数ページの .docx と .pptx のプレビューに対応します。

1. 形式に対応するプラグインをインストールまたは更新し、有効になっていることを確認します。
2. 文書を選択し、ギャラリー、カラムのプレビュー、側面の詳細パネル、またはプレビュータブで表示します。
3. 最初のページを待ち、ページ番号と表示方法のコントロールで残りを閲覧します。

操作	方法
ページ送り	プレビュー上でマウスホイールを回します
指定ページへ移動	1/6 などのページ番号をクリックし、移動先の番号を入力します
表示方法を変更	単ページ（Single page）、連続スクロール（Continuous scroll）、見開き（Two-page） から選びます
拡大 / 縮小	プレビューの拡大・縮小ボタンを使います。拡大後はページをドラッグできます

PDF プレビューと同じコントロールです。ウィンドウが狭い場合は表示方法のボタンを隠します。文書プレビューは閲覧用で、ページ内のテキストは編集できません。

待機と失敗のメッセージ

プラグインがプレビューを出力するまで約 0.3 秒以上かかると、大きなプレビュー領域に読み込み表示が現れます。まだ読み込んでいない文書ページに切り替えた場合は、そのページ中央に表示し、読み込み完了後に消えます。アイコンビューのサムネイルには、この読み込み表示はありません。

ファイルをデコードできない場合は、プラグインの名前と診断を表示します。たとえば プラグイン … はこのファイルを再生できません などです。繰り返しの実行時エラーで一時的に停止した場合は、通知とプレビューの両方に プラグイン … が連続して失敗したため、今回の実行では無効になりました と表示します。再生とページ移動のコントロールは使用できなくなります。

再試行するには、左上のメニューから プラグイン を開き、インストール済みプラグインのメニューで 無効にする、有効にする の順に操作します。tessoa の再起動でもリセットできます。それでも失敗する場合は、プラグインの更新確認や問題報告のために、表示されたプラグイン名と診断を控えてください。

未インストール時の案内

プラグインが必要な形式の動画、音声、文書を開くと、プレビューに プラグインを入れるとこの形式を表示できます（Install a plugin to preview this format） と、その下にプラグインページを直接開く プラグインを見る（View plugins） ボタンが表示されます。

この案内は、次の 4 条件をすべて満たす場合にだけ表示します。インストール可能なプラグインを提案 がオン、プラグインを有効にする がオン、拡張子が tessoa の組み込み一覧（mp4 mkv mov webm m4v avi mp3 flac ogg m4a wav docx pptx）にある、インストール済みプラグインがその形式に対応していないことです。無効にしたプラグインもインストール済みとして扱うため、再インストールを案内しません。

案内を消すには、システム グループの インストール可能なプラグインを提案 をオフにします。このスイッチは案内だけを切り替え、プラグインの動作には影響しません。

注記

Windows では、通常の mp4 にこの案内が出ないことがあります。 システムがカバーフレームを生成し、プレビューがその画像を表示するため、案内を表示する場所がありません。HEVC などシステムでもデコードできない動画や、macOS と Linux では通常どおり表示します。

ライセンスと利用規約

プラグインのプレビューは、ライセンスの更新資格の範囲内で、すべての有料プランに含まれます。ローカル ZIP からのインストールを含め、インストール、更新、利用には、この機能を対象とする有効な有料ライセンスの権利が必要です。有料ライセンスがなくても、一覧の閲覧、無効化、アンインストールはできます。設定（Settings）→ システム → プラグイン を開いてください。

プラグイン利用規約は、第三者のプラグインと tessoa の責任範囲を説明する独立した文書です。プラグインをインストール するときに一度表示し、起動を妨げることはありません。規約の変更後は、次回のインストールまたは更新時に再び確認します。全文は設定の 情報（About） グループでいつでも読めます。

プラグインソースに接続できない場合

インストールできるプラグイン は常にページ内に表示されます。接続できない場合は、代わりに理由を表示します。

メッセージ	対処
プラグインソースに接続できません。…	ネットワークを確認し、再スキャン をクリックします
プラグインソースの署名検証に失敗したため、この一覧は破棄されました。…	後で再試行します。続く場合は、公式サイトからパッケージを取得し、ファイルからインストール… を使います
プラグイン一覧の形式を認識できません。…	先に tessoa を最新版に更新します
このマシンで使えるプラグインはまだありません。	このシステムまたはアーキテクチャ用のプラグインはまだ公開されていません

関連項目

プレビューの概要 · プレビュータブ · 設定の概要 · よくある質問