ファイル配置
このページでは、LoPiQ を各 OS にインストールした際に配置されるファイルおよびディレクトリの構造について説明します。
📂 各 OS でのファイル配置一覧
🍎 macOS 環境 (DMG パッケージからインストールした場合)
| パス | 区分 | 役割 |
|---|---|---|
/Applications/LoPiQ.app/ |
アプリ本体 | macOS アプリケーションバンドル。実行バイナリおよび表示用静的アセット(static/)を内包。 |
~/Library/Application Support/lopiq/config.json |
ユーザー設定 | ポート番号、登録画像フォルダ一覧、カスタムアクション等を保存する設定ファイル。 |
### 🐧 Linux 環境 (Debian/Ubuntu/Mint .deb パッケージからインストールした場合) |
| パス | 区分 | 役割 |
|---|---|---|
/opt/lopiq/ |
インストール先 | 実行バイナリ lopiq およびアセットディレクトリ static/ が配置されます。 |
/usr/bin/lopiq |
シンボリックリンク | /opt/lopiq/lopiq へのシンボリックリンク。ターミナルから lopiq コマンドで実行可能です。 |
/usr/lib/systemd/user/lopiq.service |
systemd ユーザーサービス | ユーザーセッションで自動起動・常駐管理を行うサービスユニットファイル。 |
~/.config/lopiq/config.json |
ユーザー設定 | ユーザー権限動作時の設定ファイル。 |
🔄 設定ファイルの指定(-config フラグ)
ポータブル運用する場合や、開発・検証等で特定の設定ファイルを読み書きしたい場合は、-config コマンドライン引数または LOPIQ_CONFIG_PATH 環境変数を指定してください。
# 任意の設定ファイルを指定して起動
lopiq -config ./config.json