設定ファイル仕様・手動編集手順書 (Configuration)
fjFlow プロ版の設定は、すべて構造化された JSON ファイルで管理されています。設定画面からの操作だけでなく、テキストエディタで直接編集して反映することも可能です。...
JSON設定ファイルのパラメータ構造、手動編集、バックアップ・復元の手順ガイド
fjFlow プロ版の設定は、すべて構造化された JSON ファイルで管理されています。設定画面からの操作だけでなく、テキストエディタで直接編集して反映することも可能です。
目次
- 1. 設定ファイルの配置場所を確認する
- 2. CaretFocus.json (基本設定) の主要パラメータ一覧
- 3. KeyExt.json (キーマッピング) の構成と編集手順
- 4. 設定ファイルを手動編集して反映する手順
- 5. 設定をバックアップ・復元する手順
1. 設定ファイルの配置場所を確認する
設定ファイルは、fjFlow.exe（または fjFlow.ahk）と同じディレクトリに自動生成・配置されます。
CaretFocus.json: 外観、インジケーター、フォーカス強調、ハイライト/ズーム、マウス動作、QuickDraftなどの全般的なパラメータを保持します（※トレイメニューのエクスポートではfjFlow_backup.jsonとして出力されます）。KeyExt.json: キー拡張機能の各レイヤー（L0, SS, L1, L2）におけるマッピングルールを保持します。
2. CaretFocus.json (基本設定) の主要パラメータ一覧
{
"IndicatorEnabled": true, // インジケーター表示の有効/無効
"IndicatorTextVal": "●", // 通常時の表示文字
"IndicatorColor": "FF0000", // 文字カラー (RGB16進数)
"ImeIndicatorEnabled": true, // IMEオン連動の有効/無効
"ImeIndicatorTextOn": "あ", // IMEオン時の文字
"ImeIndicatorColorOn": "FF0000", // IMEオン時の文字色
"ImeIndicatorTextOff": "A", // IMEオフ時の文字
"ImeIndicatorColorOff": "00C0FF", // IMEオフ時の文字色
"FontSize": 14, // インジケーターフォントサイズ (pt)
"OffsetX": 15, // キャレットX座標からの距離 (px)
"OffsetY": -5, // キャレットY座標からの距離 (px)
"HideDuringInput": true, // 打鍵中にインジケーターを隠すか
"HideDelay": 1000, // 打鍵停止から再表示までの待機ミリ秒
"FocusHighlightEnabled": true, // ウィンドウ強調の有効/無効
"FocusHighlightBorderSize": 3, // 強調枠の太さ (px)
"FocusHighlightColorMode": 0, // カラーモード (0: ユーザー指定, 1: CPU/メモリ連動)
"FocusHighlightDimEnabled": false, // 背景暗転（ディミング）の有効/無効
"FocusHighlightDimAlpha": 120, // 背景暗転の強度 (0-255)
"KeyExtHoldTimeout": 240, // 長押し判定時間 (ms)
"KeyExtComboIntervalTime": 300, // コンボ打鍵判定間隔 (ms)
"KeyExtSilenceTime": 300, // 前後静寂判定時間 (ms)
"KeyExtGuideDelay": 500, // キーガイドHUD自動表示遅延 (ms)
"UiSnapEnabled": false, // UIスマートスナップ（エイムアシスト）の有効/無効
"UiSnapRadius": 50, // マウス周囲のターゲット検知半径 (20-150 px)
"UiSnapStopDelay": 60, // マウス静止判定時間 (ms)
"UiSnapJumpDelay": 500, // 予告ハイライトから自動吸着までの猶予時間 (50-1000 ms)
"UiSnapBorderColor": "0078D7", // スナップ前の予告ハイライト枠色 (RGB16進数)
"UiSnapSnappedBorderColor": "FF0000", // スナップ完了後の確定枠色 (RGB16進数)
"UiHintTimeout": 3000, // UIヒント自動消去時間 (ms)
"UiHintCvPruning": 3 // CV画像認識の感度 (1-20)
}3. KeyExt.json (キーマッピング) の構成と編集手順
キー拡張のマッピングは、レイヤーと打鍵キーをパイプ記号（|）で結んだキーで定義されます。
{
"Enabled": 1,
"Mappings": {
"SS|h": "{Left}", // SSレイヤーでhを押すと左矢印
"SS|;": "{Enter}", // SSレイヤーで;を押すとEnter
"SS|<h>": "{Home}", // SSレイヤーでh長押しで行頭ジャンプ
"L0|eq": "=", // L0レイヤーでeq連続入力で=を出力
"L0|pt": "(){Left}", // L0レイヤーでpt連続入力で()を出力し内側へ
"L0|<a>": "@", // L0レイヤーでa長押しで@を出力
"L1|q": "{F1}", // L1レイヤーでqを押すとF1
"SS|j": { "value": "{Down}", "showGuide": false } // ガイドHUDに非表示にする設定例
}
}キー記法の形式
- 即時置換 (
key):SS|h➔ 0ms 完全無遅延で置換出力。 - 長押し (
<key>):L0|<a>➔ 一定時間押し続けで記号を出力。 - マルチキーコンボ (
seq):L0|eq➔ 2文字連続入力後に確定出力。
4. 設定ファイルを手動編集して反映する手順
エディタで直接設定値を書き換えて反映する手順です。
- VS Code やメモ帳等のテキストエディタで
CaretFocus.jsonまたはKeyExt.jsonを開きます。 - 目的のパラメータを編集し、UTF-8 で保存します。
- タスクトレイの fjFlow アイコンを右クリックし、再起動 (Restart) をクリックします。
- 設定ファイルが再読み込みされ、新しい設定で動作が開始されます。
5. 設定をバックアップ・復元する手順
環境移行やバックアップを行う手順です。
- バックアップ: 作業フォルダ内の
CaretFocus.jsonおよびKeyExt.jsonを別のフォルダやクラウドへコピーします（またはトレイメニューの「エクスポート」機能を利用します）。 - 復元: 復元先フォルダへ上記2つのファイルを配置し、fjFlow を起動（またはトレイメニューから再起動）します。