プラグイン
farman は、ビュアーやアーカイブ形式を後から追加できる外部プラグインに対応しています。
公式プラグインのほか、第三者が作成したプラグインも導入できます。
外部プラグインはネイティブコードで、farman と同じ権限で動作します。安全のため、外部プラグインの読み込みは既定でオフです。信頼できる提供元のプラグインだけを有効にしてください。
プラグイン一覧
3D モデルビュアー (FBX / OBJ / glTF / Blender)
.fbx / .obj / .gltf / .glb / .blend 形式の 3D モデルを farman 内で表示。テクスチャ(外部・埋め込み)・スケルタルアニメーション・複数マテリアル・床グリッド・ワイヤーフレーム・ボーン(スケルトン)表示・裏面カリング・ノード階層の情報パネルに対応。マウス / キーボードで回転・平行移動・拡大縮小できます(操作キーは本体の「設定 → キーバインド」で変更できます)。
※ デモのモデル: KayKit Adventurers の Mage と、KayKit Character Animations のアニメーション(Kay Lousberg 作、CC0)。デモ用に、Mage とアニメーションを 1 つのファイルへ合成しています。
ダウンロード
リポジトリ
最新版の更新内容 1.1.0 · 2026-10-20
アニメーションのクリップを切り替えられるように
- アニメーションが複数入っているファイル(glTF / FBX)で、再生するクリップを選べるようになりました。ツールバーの選択ボックス、または
[ / ] キーで切り替えます。クリップが 1 つ以下のファイルでは、選択ボックスは出ません。
- 左上のモデル情報のアニメ時間も、選んだクリップの長さになります。
- 操作説明(
H)に、クリップが複数あるときだけ「[ / ] : クリップ切替」を表示します。
これまでの版の更新内容は、リリース一覧に日本語・英語で掲載しています。
LZH (LHA) アーカイブ
.lzh / .lha アーカイブを、zip / tar と同じようにブラウジング・展開。日本語 Shift-JIS のファイル名にも対応(読み取り専用)。macOS 版は Apple の Developer ID 署名 + 公証済み。
ダウンロード
リポジトリ
最新版の更新内容 1.0.0 · 2026-07-22
- 最初の公開版です。
.lzh / .lha アーカイブのブラウジング・展開 (読み取り専用) と、Shift-JIS のファイル名に対応しています。
更新内容はリリース一覧にも掲載しています。
プラグインは順次追加予定です。作ってみたい方は下の「プラグイン開発」を参照してください。
導入手順
外部プラグインは、farman の 設定 → プラグイン(ヘルプ → プラグイン... からも開けます)でインストール・更新・アンインストールできます。ファイルを手でコピーする必要はありません。手順はどのプラグインでも共通です。
- 設定 → プラグインを開き、「外部プラグインの読み込みを許可する」をオンにします(既定はオフ)。
- 公式プラグインは、まだ入れていないものが「外部プラグイン」の一覧に並びます。目的のプラグインの「インストール」を押すと、最新版を取得して導入します。
- 手元のファイル(第三者のプラグインなど)は、お使いの OS 用のファイル(macOS:
.dylib / Windows: .dll / Linux: .so)をダウンロードし、ページ下部の枠にドラッグ&ドロップするか、「ファイルからインストール...」で選びます。ビュアー用かアーカイブ用かは自動で判別します。
- 導入は次回起動時に反映されます。ページの「farman を再起動」ボタンで、その場で再起動できます。再起動後、一覧に読み込み済みのプラグインが表示されれば導入完了です。
設定 → プラグイン(上: 「外部プラグインの読み込みを許可する」をオン / 下: ドロップまたは「ファイルからインストール...」)
更新するときは、一覧の「更新を確認」で最新版を調べ、更新があるプラグインの「更新する」を押します。アンインストールも同じ一覧の「アンインストール...」から行います。プラグインディレクトリ(ページ下部の「開く」)の viewers / archives サブフォルダへ直接ファイルを置く従来の方法も使えます。
macOS: 公式プラグインは署名 + 公証済みでそのまま読み込めます。未署名の第三者プラグインはダウンロード時の隔離により初回ロードがブロックされることがあります(提供元の案内に従ってください)。Windows: 未署名のプラグインは SmartScreen の警告が出ることがあります。
プラグイン開発
farman のプラグインは C++ / Qt で作成できます。ビュアー用の IViewerPlugin、アーカイブ用の IArchivePlugin インターフェースを実装し、動的ライブラリとしてビルドします。ABI(Qt バージョン)の一致、優先度の割り当て、macOS の実行時リンク、CI テンプレートなどをガイドにまとめています。
プラグイン開発ガイド
参照実装 (farman-plugin-lzh)