Home Gallery User Guide
English
Getting started
- Requires Android 11 or later.
- On first launch, allow Photos and videos access.
- Main screens use a bottom navigation bar (a side rail in landscape)—there is no sidebar drawer.
- We do not host a cloud gallery. SMB passwords stay on your device.
- If you used an older test build before the host/album refactor, clear app data or reinstall, then set up hosts and home albums again. Do not import old-format settings files.
Bottom navigation
| Tab | What it does |
|---|---|
| Local | On-device gallery (folders / timeline). With recycle bin enabled, open the bin from the local gallery title bar. |
| Home | Opens your last home album. Tap again to open/close the album picker (switch albums / manage). |
| Bookmarks | Folder bookmarks and video bookmarks (resume playback). |
| More | Album backup (when enabled; may show a badge) and Settings. About / user guide live under Settings. |
There is no separate “network storage” list. Browse NAS/PC files only via Home.
Local gallery
- Folders or Timeline browse modes at the gallery root.
- Long-press to multi-select; in folder mode, long-press a folder to select all media inside.
- While selecting, long-press another item for an inclusive range select.
- Toolbar actions: slideshow, copy, move, delete, share, upload to a home album.
- Slideshow: multi-select photos → Slideshow, or start/pause from the photo viewer. About 5 seconds per photo, loops; tap to pause, swipe to change photo. Photos only (videos are skipped). Plays on the phone screen.
- Photo edit (JPEG / PNG / WebP): crop, adjust, and portrait. Local tone markers stay usable after pinch-zoom; brightness previews instantly.
Home albums & SMB hosts
- SMB host: one NAS/PC plus credentials. Manage under More → Settings → Host connections. Add a host via the discovery dialog (or manual address), test, then save.
- Home album: one card = one host + one share + one folder. Add multiple albums separately if you need more sources—setup creates one album at a time.
- Typical setup: add a host in Settings (or from the home-album flow) → pick a share → pick a folder → done. Open from the Home tab.
- Away / WebDAV (NAS): set remote access to WebDAV with DDNS or a public IP + HTTPS port. See WebDAV setup.
- Away / Tailscale (Windows / no WebDAV): paste the PC’s 100.x address. See Tailscale setup.
- Enable IPv6 (Settings → Host connections, off by default): when off, discovery/connect stay IPv4-only and IPv6 fields are hidden; saved IPv6 is kept. Away access uses WebDAV or Tailscale. The same settings page links to the WebDAV / Tailscale guides.
- Opening a subfolder loads from the server; going back uses a cached listing when available so the parent appears quickly.
- Slideshow for photos works the same as in the local gallery (multi-select or from the viewer).
- Video streaming: home videos can be streamed on the phone (Settings → Home albums).
Haven’t shared a folder on your PC/NAS yet? See Set up home storage (Windows 11 walkthrough with screenshots; Synology / QNAP summaries). Away: WebDAV (NAS) or Tailscale (Windows).
Album backup & restore
One-way backup from the phone to a private folder on home storage: .HomeGallery/backup/{device}/. Not two-way sync. Open via More → Album backup (or Settings).
| Topic | What happens |
|---|---|
| Basic | Manual backup, exclude folders, restore |
| Pro | Plus optional automatic backup on Wi‑Fi |
| Move to recycle bin | NAS copy kept; not listed as “Missing on device” — restore from the recycle bin |
| Permanent delete in this app | Not “Missing on device”; next backup removes the matching NAS copy |
| Deleted outside the app | Listed as “Missing on device”; you can restore manually from the backup zone |
Restore: More → Album backup → View backup / restore → filter Missing on device → restore selected or all missing.
Parallel folders (e.g. Documents) without SAF may restore under Pictures/…. See in-app prompts for path mapping.
Recycle bin vs permanent delete
- Recycle bin: deleted items can be restored on the phone when enabled in Settings; home backup copies stay until you permanently delete. Open from the Local gallery title bar when enabled (hidden when disabled).
- Permanent delete: removes from the phone and schedules cleanup of the matching backup file on the next backup run.
Basic vs Pro
- Basic (free): full local & home album management, video streaming, timeline, recycle bin, parallel folders, manual backup & restore. No ads.
- Pro (one-time): automatic album backup on Wi‑Fi.
Support
- In the app: More → Settings → About → User guide, or Settings → Support.
- Report issues from Settings / About (email). Optional diagnostic ZIP — no passwords or photo contents.
- Settings export may include SMB credentials in an encoded form (not immediately readable, not strong encryption)—keep export files private.
- Email: jasoncs311@gmail.com
- Privacy policy
繁體中文
開始使用
- 需 Android 11 或以上。
- 首次啟動請允許相片和影片存取。
- 主畫面使用底部導航（橫向為側邊導覽列），沒有側邊欄抽屜。
- 本 App 不提供雲端相簿代管；網路儲存帳密僅保存在您的裝置上。
- 若曾使用重構前的舊測試版，請先清除 App 資料或重裝，再重新設定主機與家中相簿；勿匯入舊格式設定檔。
底部導航
| 分頁 | 說明 |
|---|---|
| 本機 | 本機相簿（資料夾／時間軸）。啟用回收桶時，可從本機標題列進入回收桶。 |
| 家中 | 進入上次使用的家中相簿；再點一次開啟／關閉相簿選擇器（切換或管理相簿）。 |
| 書籤 | 資料夾書籤與影片書籤（可續播）。 |
| 更多 | 相簿備份（啟用時顯示，可能有徽章）與設定。關於／使用說明在設定內。 |
沒有「網路儲存」連線列表；家中檔案一律由家中進入。
本機相簿
- 根目錄可切換資料夾或時間軸瀏覽。
- 長按進入多選；資料夾模式下長按資料夾可選取該夾全部媒體。
- 多選中再長按另一項可區間多選（含兩端）。
- 可投影片、複製、移動、刪除、分享、上傳至家中相簿。
- 投影片：多選相片後點「投影片」，或在瀏覽頁開始／暫停。約每張 5 秒、循環播放；輕觸暫停、左右滑切換。僅相片（略過影片）。於手機螢幕播放。
- 相片編輯（JPEG／PNG／WebP）：裁剪、調整、肖像。局部色調標記點在預覽縮放後仍可拖曳；調整亮度可即時預覽。
家中相簿與主機連線
- SMB 主機：一台 NAS／PC 加上帳密。在更多 → 設定 → 主機連線管理登記。透過探索對話框（或手動輸入）新增、測試連線後儲存。
- 家中相簿：一張卡片＝一台主機＋一個共用＋一個資料夾。需要多個來源就分別新增——一次流程只建一筆。
- 建議流程：先新增主機 → 選共用 → 選資料夾 → 完成。再到底部導航「家中」瀏覽。
- 外出／WebDAV（NAS）：遠端存取選 WebDAV，填 DDNS 或公網 IP 與 HTTPS 埠。見 WebDAV 建置。
- 外出／Tailscale（Windows／無 WebDAV）：在 App 貼上 PC 的 100.x。見 Tailscale 建置。
- 啟用 IPv6（設定 → 主機連線管理，預設關閉）：關閉時探索／連線僅 IPv4，並隱藏 IPv6 欄位；已儲存的 IPv6 會保留。外出請用 WebDAV 或 Tailscale。同頁「連線說明」可開啟 WebDAV／Tailscale 線上指引。
- 進入子目錄需向伺服器載入；返回上層會盡量使用已快取列表，讓上層較快出現。
- 投影片與本機相簿相同（多選或瀏覽頁啟動）。
- 網路影片串流：家中影片可在手機串流播放（設定 → 家中相簿）。
還沒在電腦／NAS 開過共用？請先看 家中儲存建置指南（Windows 11 含截圖；Synology／QNAP 為步驟摘要）。外出：NAS 見 WebDAV；Windows 見 Tailscale。
相簿備份與還原
將本機相簿單向備份到家中儲存私有區：.HomeGallery/backup/{裝置}/。不是雙向同步。入口：更多 → 相簿備份（或設定）。
| 情境 | 說明 |
|---|---|
| Basic | 手動備份、排除目錄、還原 |
| Pro | 另可 Wi‑Fi **自動**備份 |
| 移至回收桶 | 家中備份保留；不算「本機缺失」——請從回收桶還原本機 |
| 本 App 永久刪除 | 不算「本機缺失」；下次備份會清除對應的家中備份檔 |
| 外部／未知消失 | 列為「本機缺失」，可手動從備份區還原 |
還原：更多 → 相簿備份 → 檢視備份／還原 → 篩選「本機缺失」→ 還原已選或全部缺失。
平行目錄（如 Documents）若尚未 SAF 授權，還原可能寫入 Pictures/…；請依對話框的路徑映射提示確認。
回收桶與永久刪除
- 回收桶：可還原本機項目；在回收桶期間家中備份仍保留。於本機相簿標題列進入（已啟用時；關閉時隱藏）。
- 永久刪除：自手機刪除，並在下次備份時清除對應的備份檔。
Basic 與 Pro
- Basic（免費）：完整本機與家中媒體管理、家中影片、時間軸、回收桶、平行目錄、手動備份／排除／還原。無廣告。
- Pro（一次性）：相簿備份自動同步（Wi‑Fi 背景上傳）。
說明與支援
- App 內：更多 → 設定 → 關於 → 使用說明，或設定 → 支援。
- 可從設定／關於回報問題（Email）；可選匯出診斷 ZIP（不含密碼與相片內容）。
- 匯出設定可能以編碼形式包含 SMB 帳密（非一目了然的明文，但非強加密）——請妥善保管匯出檔。
- 信箱：jasoncs311@gmail.com
- 隱私權政策
Play Console support / website URL (optional):
https://jasoncschang-stack.github.io/homegallery-privacy/help/