設定ファイルの仕様

LoPiQ の設定は JSON 形式で保存されます。Web UI の設定ダイアログ（⚙️）から変更可能ですが、直接編集することもできます。

---

📂 設定ファイルの保存場所と探索順序

設定ファイルは以下の優先順位で探索・読み書きされます。

1. カレントディレクトリ: 実行ファイルと同じディレクトリに config.json が存在する場合は、それを最優先で読み書きします（ポータブル動作）。
2. ユーザー設定ディレクトリ: カレントディレクトリにない場合、OS の標準設定ディレクトリを使用します。
   • macOS: ~/Library/Application Support/lopiq/config.json
   • Windows: %APPDATA%\lopiq\config.json
   • Linux: ~/.config/lopiq/config.json

---

📝 設定例 (config.json)

{
  "port": 13180,
  "root_dirs": [
    "/Users/username/Pictures/sample-photos",
    "/mnt/nas/images"
  ],
  "password": "",
  "actions": [
    {
      "name": "ゴミ箱へ移動",
      "icon": "🗑️",
      "command": "trash \"{file}\"",
      "confirm": false,
      "reload": false
    }
  ],
  "folder_actions": [
    {
      "name": "PNG全削除",
      "icon": "🗑️",
      "color": "#d00b0b",
      "command": "rm -f *.png",
      "confirm": true,
      "reload": true
    }
  ],
  "openai_api_key": "",
  "openai_model": "gpt-5.6-luna"
}

---

⚙️ 主要パラメータ一覧

フィールド	型	デフォルト	説明
port	整数	13180	HTTP サーバーの待機ポート番号。
root_dirs	文字列配列	[]	登録された画像ルートディレクトリの絶対パス一覧。
password	文字列	""	簡易認証用パスワード。空文字列の場合は認証無効。
actions	オブジェクト配列	(削除アクション)	個別画像向けカスタムアクション定義（最大3つ）。
folder_actions	オブジェクト配列	[]	フォルダ全体向けアクション定義（最大3つ）。
openai_api_key	文字列	""	AI アシスタントおよびコマンド生成用の OpenAI API キー。
openai_model	文字列	"gpt-5.6-luna"	AI 機能で使用する OpenAI モデル名（例: gpt-4o, gpt-4o-mini, o3-mini など）。

---

⚡ アクションオブジェクトの仕様

actions および folder_actions 配列内の各オブジェクトで設定可能な項目です。

フィールド	型	デフォルト	説明
name	文字列	""	ボタンに表示されるアクション名。
icon	文字列	""	表示用絵文字アイコン（例: 🗑️, 🔄, ✨）。
command	文字列	""	実行するシェルコマンド。画像アクション（{file}, {dir}等）およびフォルダアクション（{dir}, {folder}, {name}, {parent}等）でプレースホルダーが利用可能。
confirm	真偽値	false	実行前にブラウザ上で確認ダイアログを表示するかどうか。
reload	真偽値	false	コマンド実行後にフォルダ表示をリロードするかどうか。
color	文字列	""	ボタンのカスタム背景色（HEXカラーコード。例: #d00b0b）。