プラグイン

farman は、ビュアーやアーカイブ形式を後から追加できる外部プラグインに対応しています。 公式プラグインのほか、第三者が作成したプラグインも導入できます。

外部プラグインはネイティブコードで、farman と同じ権限で動作します。安全のため、外部プラグインの読み込みは既定でオフです。信頼できる提供元のプラグインだけを有効にしてください。

プラグイン一覧

3D モデルビュアー (FBX / OBJ / glTF / Blender)

.fbx / .obj / .gltf / .glb / .blend 形式の 3D モデルを farman 内で表示。テクスチャ(外部・埋め込み)・スケルタルアニメーション・複数マテリアル・床グリッド・ワイヤーフレーム・ボーン(スケルトン)表示・裏面カリング・ノード階層の情報パネルに対応。マウス / キーボードで回転・平行移動・拡大縮小できます(操作キーは本体の「設定 → キーバインド」で変更できます)。

farman のファイル一覧から 3D モデルを開き、アニメのクリップを切り替え、ノード情報パネルで階層のノードを選んで 3D ビューで強調するデモ

※ デモのモデル: KayKit Adventurers の Mage と、KayKit Character Animations のアニメーション(Kay Lousberg 作、CC0)。デモ用に、Mage とアニメーションを 1 つのファイルへ合成しています。

  • 種別: ビュアー
  • 対応形式: FBX(.fbx)/ glTF(.gltf .glb)/ OBJ(.obj)/ Blender(.blend、メッシュとマテリアルのみ)
  • 対応 OS: macOS / Windows / Linux
  • 対応本体バージョン: 0.9.9 以降

ダウンロード リポジトリ

最新版の更新内容 1.1.0 · 2026-10-20

アニメーションのクリップを切り替えられるように
  • アニメーションが複数入っているファイル(glTF / FBX)で、再生するクリップを選べるようになりました。ツールバーの選択ボックス、または [ / ] キーで切り替えます。クリップが 1 つ以下のファイルでは、選択ボックスは出ません。
  • 左上のモデル情報のアニメ時間も、選んだクリップの長さになります。
  • 操作説明(H)に、クリップが複数あるときだけ「[ / ] : クリップ切替」を表示します。

これまでの版の更新内容は、リリース一覧に日本語・英語で掲載しています。

LZH (LHA) アーカイブ

.lzh / .lha アーカイブを、zip / tar と同じようにブラウジング・展開。日本語 Shift-JIS のファイル名にも対応(読み取り専用)。macOS 版は Apple の Developer ID 署名 + 公証済み。

  • 種別: アーカイブ
  • 対応 OS: macOS / Windows / Linux
  • 対応本体バージョン: 0.9.8 以降

ダウンロード リポジトリ

最新版の更新内容 1.0.0 · 2026-07-22

  • 最初の公開版です。.lzh / .lha アーカイブのブラウジング・展開 (読み取り専用) と、Shift-JIS のファイル名に対応しています。

更新内容はリリース一覧にも掲載しています。

プラグインは順次追加予定です。作ってみたい方は下の「プラグイン開発」を参照してください。

導入手順

外部プラグインは、farman の 設定 → プラグイン(ヘルプ → プラグイン... からも開けます)でインストール・更新・アンインストールできます。ファイルを手でコピーする必要はありません。手順はどのプラグインでも共通です。

  1. 設定 → プラグインを開き、「外部プラグインの読み込みを許可する」をオンにします(既定はオフ)。
  2. 公式プラグインは、まだ入れていないものが「外部プラグイン」の一覧に並びます。目的のプラグインの「インストール」を押すと、最新版を取得して導入します。
  3. 手元のファイル(第三者のプラグインなど)は、お使いの OS 用のファイル(macOS: .dylib / Windows: .dll / Linux: .so)をダウンロードし、ページ下部の枠にドラッグ&ドロップするか、「ファイルからインストール...」で選びます。ビュアー用かアーカイブ用かは自動で判別します。
  4. 導入は次回起動時に反映されます。ページの「farman を再起動」ボタンで、その場で再起動できます。再起動後、一覧に読み込み済みのプラグインが表示されれば導入完了です。
設定 → プラグインで外部プラグインの読み込みを許可し、ファイルをドロップするか「ファイルからインストール...」で導入する
設定 → プラグイン(上: 「外部プラグインの読み込みを許可する」をオン / 下: ドロップまたは「ファイルからインストール...」)

更新するときは、一覧の「更新を確認」で最新版を調べ、更新があるプラグインの「更新する」を押します。アンインストールも同じ一覧の「アンインストール...」から行います。プラグインディレクトリ(ページ下部の「開く」)の viewers / archives サブフォルダへ直接ファイルを置く従来の方法も使えます。

macOS: 公式プラグインは署名 + 公証済みでそのまま読み込めます。未署名の第三者プラグインはダウンロード時の隔離により初回ロードがブロックされることがあります(提供元の案内に従ってください)。Windows: 未署名のプラグインは SmartScreen の警告が出ることがあります。

プラグイン開発

farman のプラグインは C++ / Qt で作成できます。ビュアー用の IViewerPlugin、アーカイブ用の IArchivePlugin インターフェースを実装し、動的ライブラリとしてビルドします。ABI(Qt バージョン)の一致、優先度の割り当て、macOS の実行時リンク、CI テンプレートなどをガイドにまとめています。

プラグイン開発ガイド 参照実装 (farman-plugin-lzh)