使用方法

LoPiQ の基本的な操作方法と、各種設定について解説します。

⚙️ 初回セットアップ

アプリケーションを起動し、ブラウザで http://localhost:13180 にアクセスすると、初回のみ「画像ディレクトリの追加」ダイアログが表示されます。

画像ディレクトリの指定: 画像を保存・管理しているローカルディレクトリの絶対パスを入力します。
- 例 (macOS): /Users/username/Pictures/sample-photos
- 例 (Linux): /mnt/nas/images
保存: 保存するとディレクトリの読み込みが行われ、ビューアー画面が表示されます。

🖥️ 基本操作

ディレクトリの選択と移動

ルートディレクトリの切り替え: ヘッダーにあるドロップダウンから、登録済みの画像ルートディレクトリを瞬時に切り替えることができます。
フォルダ探索: リストに表示されているフォルダ名をクリックすると、そのサブディレクトリに深く入って画像を表示できます（階層無制限）。ヘッダーのパンくずリストから上の階層に戻ることができます。

ビューアー表示と並び替え

カラム切り替え: 画面右上のレイアウト切り替えボタンにより、1カラム（大きく表示）、2カラム（2列表示）、3カラム（3列表示）を切り替えることができます。
ソート機能: ソートボタンから以下の並び順に変更できます。
- ファイル名順（昇順・降順）
- ランダム表示

画像とフォルダの操作

フルサイズ表示: 画像をクリックすると、画面いっぱいに拡大表示されます（背景が暗くぼかされたモーダルが表示されます）。
- キーボード操作: 左右の矢印キー（← / →）で前後の画像へ移動、Esc キーでフルサイズ表示を閉じます。
- クリック操作: 画面全体の右側 1/3の領域をクリックすると次の画像へ、left側 1/3の領域をクリックすると前の画像へ切り替わります（中央の 1/3 の領域をクリックしても変化しません）。
- 閉じる方法: キーボードの Esc キー、または右上にある ✕ ボタンをクリックします（画像のない背景をクリックしても閉じません）。
- 削除機能: 左上にあるゴミ箱アイコン（🗑️）をクリックすると、画像を完全に削除して自動で次の画像に切り替わります（「削除時に確認する」がONの場合は確認モーダルが表示されます）。
削除:
- 画像削除: 各画像カードの下にある「削除」ボタンをクリックすると、ディスク上の実ファイルが削除されます。ヘッダーの「削除時に確認する」チェックボックスがONの場合は、削除前に確認モーダルが表示されます。
- 空フォルダ削除: フォルダ内に画像やサブフォルダがない場合、フォルダの横に削除ボタンが表示され、ディスク上の空ディレクトリを削除できます。
- 削除確認の切り替え: ヘッダーの「削除時に確認する」チェックボックスをOFFにすると、画像一覧の「削除」ボタンおよびフルサイズ表示のゴミ箱アイコン（🗑️）をクリックした際、確認モーダルを表示せずに即座にファイルを削除できるようになります。設定内容はブラウザ（localStorage）に保存されます。
フォルダのZIPダウンロード:
- ヘッダーにある「📥 ZIPダウンロード」ボタンをクリックすると、現在表示しているフォルダ（サブフォルダや内包する画像ファイルすべて）を丸ごとZIPファイルに圧縮してダウンロードできます。まとめてバックアップしたい場合や、別の環境に移動させたい場合に便利です。

🔧 設定の変更

ヘッダーにある ⚙️（ギアマーク） ボタンをクリックすると、設定画面が開きます。

項目

設定項目	内容
ポート番号 (Port)	HTTPサーバーが待受けるポート番号（デフォルト: `13180`）。変更すると自動的にデーモンが再起動されます。
画像ルートディレクトリ一覧	登録済みのルートパス一覧。新しいパスの追加や、不要になったパスの削除が行えます。
アプリを終了 (🛑 アプリを終了)	バックグラウンドで動作している Go サーバープロセスを安全にシャットダウン（終了）させます。

これらの設定は、設定ファイル config.json に保存されます。