初期セットアップ

LoPiQ をインストールして起動した直後、最初に画像を読み込んでブラウザで閲覧可能にするまでの初期設定手順です。
OS（Windows / macOS / Linux）によってパスの形式やおすすめの画像保存場所が異なります。お使いの環境に合わせて設定を行ってください。

🚀 LoPiQ への初回アクセス

アプリを起動後、ブラウザを開いて以下の URL にアクセスします。

http://localhost:13180

初回起動時（まだ一度もフォルダを登録していない状態）は、画面中央に以下の案内が表示されます。

📂 ルートディレクトリが設定されていません
画像ファイルが保存されているディレクトリのフルパスを設定してください。
[ ⚙️ 設定する ]

ディレクトリの指定には、「直接フルパス入力」 と 「📂 フォルダ選択ブラウザ」 の2通りの方法があります。

Windows では、ドライブレター付きの絶対パスを指定します。

おすすめパス例:
- ピクチャフォルダ: C:\Users\ユーザー名\Pictures
- 専用の写真フォルダ: D:\Photos または E:\AI_Images
- ネットワークドライブ: Z:\nas_images
操作のポイント:
- エクスプローラーのアドレスバーをクリックしてパスをコピーし、入力欄に貼り付けるのが最も確実です。
- 「📂」ボタンをクリックすると、ドライブ直下からフォルダ階層を順番にクリックして選択できます。

macOS では、/Users/ユーザー名/... から始まる UNIX 形式の絶対パスを指定します。

おすすめパス例:
- ピクチャフォルダ: /Users/ユーザー名/Pictures
- 写真ライブラリ外の作業フォルダ: /Users/ユーザー名/Documents/Artwork
- 外付けHDD / SSD: /Volumes/ExternalDrive/Photos
隠しフォルダの指定:
- ~/.config や ~/Library などのドット（.）で始まる隠しフォルダを指定したい場合は、フォルダ選択ブラウザ上部の「隠しフォルダを表示」チェックボックスをオンにしてください（オンの間は淡色・👻アイコンで表示されます）。

Linux 環境では、/home/ユーザー名/... やマウントポイントの絶対パスを指定します。

おすすめパス例:
- ユーザーホーム配下: /home/ユーザー名/Pictures
- マウント済みストレージ: /mnt/storage/images や /media/data/photos
- Web / 共有ディレクトリ: /var/data/gallery
アクセス権限（パーミッション）の確認:
- LoPiQ を実行しているユーザー（例: master や lopiq）が、指定したディレクトリに対する 読み取り権限（ファイルの削除や移動も行う場合は書き込み権限） を持っていることを確認してください。

複数のルートフォルダを登録したい場合

設定画面で「➕ ディレクトリを追加」をクリックすると、何個でもルートディレクトリを追加できます。登録後はメイン画面上部のドロップダウンで即座に切り替えられるようになります。

画像の読み込みが確認できたら、フォルダの探索やレイアウトの調整を行ってみましょう。

👉 画像の一覧・閲覧 — カラム切替、ソート、サブフォルダ再帰表示