Home Gallery User Guide

English

# Home Gallery User Manual

1. Introduction

Home Gallery is an Android photo and video manager for on-device media and home storage (NAS / PC over SMB). You choose the space—no extra cloud capacity to buy. Use the disks you already have; photos stay in storage you control.

• Browse and manage photos and videos in the local gallery
• Connect home albums to shared folders on a NAS / PC (each card is one host + one share + one folder)
• Register SMB credentials once under Host connections in Settings (scan once, sign in once, reuse later)
• View, edit, share, copy, move, rename, and delete photos
• Slideshow auto-plays selected photos (local / home albums; Pro can also cast the slideshow to a TV)
• Bookmark frequently used folders
• Browse a local timeline; browse home media by date with the home-album timeline
• Home videos can stream on the phone (no full-file download first)
• UI languages: English, Traditional Chinese, Simplified Chinese, Japanese, Korean (follows system language)

This app does not host a cloud gallery. SMB passwords stay on your device. Basic is a full, ad-free photo manager (slideshow, home video streaming, timelines, recycle bin, parallel folders, manual album backup, browse backup zone, and more). Pro (optional, one-time purchase) additionally unlocks automatic album backup and photo / slideshow casting to a TV.

Requirements: Android 11 (API 30) or later.

2. Getting started

2.1 Opening the app

The app opens in the local gallery. If photo access is not granted yet, allow Photos and videos.

2.2 Main navigation (bottom bar)

A bottom navigation bar switches the main areas (in landscape it becomes a side rail with the same items). There are four tabs:

There is no sidebar. There is also no “network storage” connection list; home files are always opened from the Home tab.
About (rate / share / version) is under More → About; Settings → Support can open it too. Upgrade to Pro and report a problem are also in Settings.

Second tap on Home / Bookmarks: if you are already on that tab, tapping the same icon toggles the picker panel without leaving what you are browsing.

During multi-select or in the viewer / player, the bottom bar may hide and return when you go back to browsing.

2.3 Leaving the app

On main screens such as the local gallery, a home album, or Settings, the first Back press shows “Press Back again to exit”; press again within 2 seconds to close the app.

3. Local gallery

3.1 Browsing photos

• The root shows folders (for example DCIM, Pictures)
• Open a folder to see a grid of photos
• Tap a photo for full-screen viewing
• With the recycle bin enabled: the title bar opens the recycle bin (a count badge appears when it has items; Basic and Pro can enable this in Settings)

3.2 Search and sort

• Use the top search field to search by file name; the X on the right clears text when present, or closes search when empty
• Tap sort to change the field (name, modified date, capture date, size, folder) and ascending / descending

3.3 Multi-select

1. Long-press a photo / video to enter selection; at the folder root, long-press a folder to select all media inside
2. Tap other items to add them (in folder mode you can also tap a folder to toggle selecting the whole folder)
3. Range select: while already selecting, long-press another item (or folder) to select everything between them (inclusive) in the current browse order; the anchor is the last tap or long-press that entered selection
4. The bottom toolbar shows: Slideshow, Copy, Move, Delete, Share, Upload to home album
5. After deleting a whole folder’s media in folder mode, if the path has no files left, the app tries to remove the empty folder (it will not delete system roots such as DCIM / Pictures; folders that still contain non-media files are kept)

Slideshow: after multi-select, tap Slideshow to auto-play the selected photos (videos are skipped). See §5.8.

3.4 Bookmarks

Tap the bookmark icon in the gallery toolbar to bookmark the current folder; open it later from the Bookmarks tab.

3.5 Browse modes

At the local gallery root, switch views in the toolbar:

Timeline:

• Bottom date axis: year / month / day granularity; pinch to change it, or tap “year / month / day” in the hint
• At day granularity the axis shows thumbnails; labels are the date (in Chinese locales M月d日) and year
• A fast scroller on the right (when there is enough content) jumps quickly
• Search, multi-select, the viewer, and video playback are supported

Shared:

• Bookmarks still point at a folder path; opening a bookmark returns to folder mode

Settings → Local gallery → Grid display sets the default browse mode (folders / timeline) and default sort; the app also remembers the last mode you used.

4. Home albums and SMB hosts

Haven’t shared a folder on your PC / NAS yet? Start with the standalone setup guide:
Set up home storage (Windows 11 · Synology · QNAP; if you cannot connect see Troubleshooting; away NAS see WebDAV; away Windows / no WebDAV see Tailscale).

Home files use two layers:

4.1 Add an SMB host

1. Open More → Settings → Host connections → Manage host connections
2. Tap Add SMB host (or “Find a new SMB host” in the home-album flow)
3. The dialog scans the LAN and asks you to confirm Wi‑Fi is on and on the same network as the storage
4. Pick a host (already-saved hosts are dimmed) → enter credentials; a host name is used as the display name when available → Test connection → Save
   • LAN IPv4: for home Wi‑Fi (for example 192.168.x.x)
   • Remote access (optional, see §4.4):
     • WebDAV: for a NAS while away; enter external host (DDNS / public IP) and HTTPS port (often 5006)
     • Tailscale: for Windows or when WebDAV is unavailable; enter 100.x
     • None: home LAN only, no away helper
5. You can also type a host address manually

Connection notes (in Settings)

• Home albums are meant for the same home Wi‑Fi (LAN); at home the app uses SMB
• On mobile data away from home:
  • NAS: prefer WebDAV (DDNS / public IP); see the WebDAV guide
  • Windows PC or no WebDAV: use Tailscale or an existing LAN VPN; see the Tailscale guide
• The UI may show “home LAN” or “away”; away mode still needs WebDAV, Tailscale, or a VPN configured correctly
• The connection notes card on Manage host connections opens the online WebDAV / Tailscale setup pages
• Enable IPv6 (same page, off by default): when off, discovery and connect use IPv4 only and IPv6 fields are hidden; saved IPv6 is kept. Turn it on to scan / use IPv6. Away, use WebDAV / Tailscale (see §4.4)

4.2 Add a home album

1. Bottom navigation → Home (if you have no albums yet, setup is offered; or tap Home again → Manage home albums)
2. If there is no album yet, tap Connect home storage (or the Add FAB)
3. If there is no host yet: the Add SMB host dialog opens; after you save, setup continues
4. If hosts already exist:
   • One host: go straight to Choose a share
   • Several hosts: pick a host, then a share
   • Find a new SMB host is available when you need a scan
5. Choose the album folder: browse subfolders in the share; you can stop at any level as the album root
6. Display name (optional) defaults to the folder name → tap Done (this creates one album)
7. Open it from the Home tab; tap Home again to switch albums

Setup no longer re-runs a full host scan or lets you multi-select several shares to create many albums in one go.

4.3 Browse and manage

1. Bottom navigation → Home → open an album (or tap Home again and switch in the picker)
2. Browse that source folder (grid / list)
3. The title bar switches Folders / Timeline. Timeline shows photos and videos by date across folders (Basic). The first open builds an index; later visits prefer the cache. If the index is older than about 24 hours it refreshes silently after connect; you can also refresh manually. On the timeline, pull down to refresh folders near the current view (segment refresh) without a full-library rescan
4. Switching to timeline inside a subfolder shows only that folder’s scope
5. Tap a photo to view; the toolbar can Refresh. After a rename on the timeline, the index follows the new name; a later move uses the new path
6. Timeline multi-select can align times (match a reference photo) or correct time on a single photo (date and time)
7. On the home-album manage screen, each album has a timeline scan depth (1–8 levels, default 4; the album root is level 0)

Remove an album link

• On the home-album manage screen: long-press a card or tap ⋮ → Remove album link
• This only removes the link in the app; it does not delete files on the storage device

Multi-select move / copy

• The destination picker lists home albums by display name only (no second-line path), then you can enter subfolders

4.4 Away access (optional)

After you leave home Wi‑Fi, pick one remote method for the host type:

WebDAV (recommended for NAS)

1. On home Wi‑Fi, set up the host and home album first (§4.1–4.2)
2. Enable WebDAV HTTPS on the NAS and prepare DDNS or a public IP
3. Edit the host → Remote access = WebDAV → enter external host and port → Test connection → Save
4. (Most home NAS use a self-signed certificate) You may enable Allow untrusted HTTPS certificates: the app tries system trust first; if that fails it pins the certificate for that host (TOFU)—the first successful connection stores the fingerprint. If the NAS certificate changes later and connection fails, turn this option off and on again to re-pin
5. Open the home album while away (turn off home Wi‑Fi to verify)

Full steps and security notes: WebDAV guide.

Tailscale (Windows / no WebDAV)

Use Tailscale as a secure tunnel so the phone can reach home SMB at 100.x.

Short flow:

1. On home Wi‑Fi, set up the host and home album first (§4.1–4.2)
2. PC / NAS: install Tailscale → sign in → Connected → copy that machine’s Tailscale IPv4 (100.x)
3. Phone: install Tailscale → same account → Connected
4. Open the home album while away → when prompted Open Tailscale → copy the PC 100.x → return to the app → Paste → Save Tailscale IP and retry

Day to day: open Tailscale when you need the album. When you leave the app or return to home Wi‑Fi, the app asks Tailscale to disconnect to save power. If you already have OpenVPN (or similar) onto the LAN, you usually do not need Tailscale.

Full walkthrough, FAQ, and notes: Tailscale guide.

Enable IPv6 (optional)

Under Host connections you can toggle Enable IPv6 (off by default):

• Off: discovery and connect stay IPv4-only; IPv6 fields are hidden when editing; saved IPv6 is kept
• On: the app can scan / fill IPv6 and use it among connection candidates
• For away access use WebDAV / Tailscale in §4.4

5. Photo viewer

Tap a photo in the local or home gallery for full-screen viewing. Other apps (Files, Downloads, Messages, and so on) can also Open with Home Gallery.

5.1 Gestures

The lower-left corner shows the photo date: if EXIF DateTimeOriginal / Digitized exists, it shows date + time; otherwise it uses the earlier of modified / created and shows date only (plain DateTime tags are ignored so a later file time is not used by mistake). Hidden during fullscreen or slideshow.

5.2 Top toolbar

If the current format cannot be edited, the Edit button is not shown.

5.3 Side / bottom actions

Tap the arrow to expand the action row (in auto-collapse mode), or set it to always shown in Settings.

Portrait: actions at the bottom. Landscape: actions on the right.

5.4 Properties

The properties dialog shows:

• File info: name, path, size, type, created date, modified time
• EXIF (when present): resolution, capture settings, GPS, and so on

Photos without EXIF still show file info; created date is always shown.

5.5 Copy / move

1. Tap Copy or Move
2. Pick a destination in the folder browser (fullscreen grid)
   • Empty folders are hidden by default; turn on Show empty folders to pick a folder that has no files yet
   • The same row has New folder and Confirm
   • After New folder, it becomes the target (shown even if empty) so you can confirm immediately
3. If the destination already has the same name:
   • Overwrite: replace with the new file
   • Keep both: keep the original; the new file gets a number (photo (1).jpg)
   • Cancel: abort

Local multi-select: Move works for photos and videos; Copy is hidden when the selection includes video (video copy is not implemented yet).

5.6 Image formats and limits

The app uses the extension and MIME type to decide whether a file can be viewed or edited. The table applies to the local gallery and home albums (other files on home storage appear as ordinary files and cannot open in the viewer).

Viewable photo formats

.jpg, .jpeg, .png, .gif, .webp, .bmp, .heic, .heif, .svg, .svgz

Editable photo formats

Only these formats can enter Edit from the viewer, and they stay the same format after save:

Other viewable formats (.gif, .bmp, .heic, .heif, .svg, .svgz, and so on) have no Edit button, so a save cannot change the format or damage the file.

SVG / SVGZ

Other format notes

Video formats

The app recognizes these video extensions in both the local gallery and home albums. Playback details are in §5.7.

.3gp, .avi, .flv, .m2ts, .m4v, .mkv, .mov, .mpeg, .mpg, .mp4, .qt, .rm, .rmvb, .swf, .ts, .vob, .webm, .wmv

Settings → Media list filters also lists these video extensions as a reference.

5.7 Video playback

Local and home-album videos can stream in the app (home files do not need a full download first). Slideshow is §5.8.

Recognized video extensions

.3gp, .avi, .flv, .m2ts, .m4v, .mkv, .mov, .mpeg, .mpg, .mp4, .qt, .rm, .rmvb, .swf, .ts, .vob, .webm, .wmv

Being on the list means the app opens the file as video. It does not guarantee decode; that still depends on the inner codec and the device.

On the phone

Codec limits: the same extension can hide different codecs. If both engines fail, you may get audio only, a black frame, or no playback.

Format summary

Cast video to a TV

Casting video from local or home albums is Basic (photo cast is §5.9). The phone and TV must be on the same LAN. Some extensions (for example .avi, .wmv) hide the Cast button.

“This video’s bitrate is too high” appears only when transcode is required but the home file is not downloaded / has no transcode cache. Confirmed H.264 is not blocked for that reason; play on the phone, then retry cast once a local file or cache exists.

5.8 Slideshow

Auto-play photos from the local or home gallery on the phone screen. Available in Basic and Pro. Pro can also send the slideshow to a TV (see §5.9). Use the video player for videos (§5.7).

How to start

If the selection has no photos (for example videos only), you see “Please select at least one photo” and slideshow does not start.

Playback

Gestures while playing

After pause

System Back: if a slideshow is running, the first press ends it; another press leaves the viewer (depending on the current screen).

5.9 Cast photos to a TV

Pro can cast local or home-album photos to a Google Cast TV / Chromecast. Basic still shows the Cast icon on the photo viewer; tapping it prompts an upgrade.

Phone and TV must be on the same LAN. Allow local-network permission the first time.

6. Photo editor

Tap Edit in the viewer (only .jpg, .jpeg, .png, .webp show this button, see §5.6).

Editing is a draft. There are two layers:

1. Inside a tool, adjust on the bottom (portrait) or right (landscape); tap ✓ to apply that step to the working preview, or X to discard the step and return to tool picker.
2. Back on the tool picker, top Save writes every applied step to the file.

Landscape: entering Portrait / Adjust / Crop hides the top title bar for preview space; system Back or toolbar X leaves that tool.

6.1 Tools

Three tools appear at the bottom (portrait) or right (landscape):

6.2 Crop

Dark panel; pick an aspect from the icon row:

• Tilt: −15° to +15°, drag the scale; Reset returns to 0
• Auto: suggested tilt is computed only when you tap Auto (not when entering Crop)
• Flip / rotate: in the middle of the bottom confirm row; they apply to the working image immediately (you still need ✓ later to commit this crop step)
• Drag the crop box to move; drag corners to scale. Rule-of-thirds guides appear only while dragging
• Tap ✓ to apply the step

6.3 Adjust

Dark panel; the middle of the confirm row switches four items:

• Reset on the right resets the current item
• Use Crop for rotate / flip
• Tap ✓ to apply the step

6.4 Portrait

Dark panel; entering the tool detects faces (you can “Detect again”). The confirm row switches: smooth, brightness, contrast, saturation.

When no face is found:

• Smooth strength is 0% and no suggestion is shown
• A circular region appears: drag with one finger to move it, use the slider to resize, then raise smooth

When a face is found:

• Suggested smooth uses the largest face’s share of the frame (closer shots higher, group / distant shots lower) and shows “Suggested N%”
• Faces are outlined

Tap ✓ to apply the step.

6.5 Save and cancel

Editor preview (tool picker, Portrait, Adjust) supports pinch-zoom and double-tap zoom (about 1×–3×), then pan; Crop does not zoom the preview so gestures stay with the crop box.

7. Bookmarks

7.1 Add a bookmark

In a local or home album, tap the toolbar bookmark icon. A “Bookmarked” hint appears at the bottom.

While playing a video, tap the star to add a video bookmark (including resume position).

7.2 Use bookmarks

1. Tap Bookmarks in the bottom bar (tap again on that tab to toggle the panel)
2. In the panel you can open:
   • Folder bookmarks: jump to that folder
   • Video bookmarks: open the player and try to resume

7.3 Remove a bookmark

Long-press an item in the bookmark panel → confirm (folder and video bookmarks work the same).

8. Upload to a home album

1. Enter multi-select in the local gallery and pick photos / videos
2. Tap the bottom Upload icon
3. Choose a home album (names only) and an optional subfolder (the private backup zone cannot be chosen)
4. Confirm

Progress

• Shows progress (N / M), file name, and a byte bar
• Stop cancels remaining files; finished files are kept; the result distinguishes success / partial success / cancelled

Same name

• If the destination already has the name, the upload is renamed to name (1).ext, name (2).ext, … and does not overwrite

Delete local after a successful upload

• Only when every item uploaded successfully and the recycle bin is enabled, the app asks whether to move local copies to the recycle bin
• Choose Move to recycle bin or Keep on device; recycle bin off only shows a success message
• Album backup does not offer this; after moving to the recycle bin, a remote backup copy is still kept if that file was already in album backup

9. Settings

Open More → Settings.

9.1 Host connections

• View, edit, or delete saved SMB hosts
• Add a host from Manage host connections (LAN scan or manual address)
• Connection notes open the online WebDAV / Tailscale away-setup pages; the same page toggles Enable IPv6 (off by default, see §4.1 / §4.4)
• The Settings home screen does not repeat Add SMB host; use the manage page

9.2 Home albums (Settings block)

• Shows how many home albums are configured
• Photo cast (Pro): cast local / home photos to a TV. Basic tapping the switch prompts an upgrade; Pro is unlocked (use the viewer Cast button). Home video streaming is Basic and no longer needs a Settings switch
• Portrait H.264 direct cast: a video-Cast compatibility option (Basic); turn it off only if the TV picture is rotated
• Add / remove albums from the Home tab (picker / manage screen)

9.3 Local gallery folders

• Include folders: which roots to show (defaults DCIM, Pictures)
• Exclude folders: skip specific subfolders

Basic vs Pro (parallel folders)

Basic and Pro can authorize parallel paths such as Documents in Settings; without that grant, restore may map into Pictures/… (see §9.7).

Note (Android platform limit): from Android 11, the system does not allow authorizing the entire Download root with the folder picker—“Use this folder” stays grey. That is not an app bug. Authorize Documents (or similar), or create a subfolder under Downloads and authorize that subfolder.

Do not confuse the two grants

9.4 Display

9.5 Cache

See cache size and clear cache (network thumbnails, image disk cache, network video stream cache, memory cache). Originals are untouched; the next home-album browse must download or rebuild cache.

9.6 Media list filters

Hide folder names, file names, or extensions in local and home album lists. Built-in photo / video extension rules are read-only references.

Settings is grouped: local gallery, media filters, Host connections, home albums (including network video streaming), album backup, cache, Report a problem / export diagnostics, and so on.

9.7 Album backup

Album backup uploads one way from the local gallery into a private zone on home storage (.HomeGallery/backup/{device}/) so you can restore after a phone failure.

Each device keeps device_info.json in its own folder (model, optional display name, last backup time). When several people share the same backup anchor, set Local backup identity → Display name in album backup settings; the “Link existing backup” list shows that name / model instead of only android_xxxx.

If you switch to another share, change host, or change the backup anchor folder, local tracking starts over: synced / failed / backup-only counts clear. Tap Check pending backup to scan again (if the new destination already has a backup for this device, items can align as synced without a full re-upload).

Unlike Basic “upload to a public folder”, the backup zone is app-managed, hidden from normal network browsing by default, and keeps the local copy by default.

Browse backup zone (large folder grid)

1. More → Album backup → Browse backup zone
2. Open the private backup root in home-album folder mode (large grid); drill into folders as needed
3. Backup-only items have a red border; long-press to select and purge them from the backup zone (and drop tracking)
4. Files that exist on the backup disk but have no local index row are labeled Not tracked (often copied in manually, or after an index reset); run a scan / remote index before they appear as Backup-only
5. List-style restore / filters still use View backup / restore below

Restore (R1.1)

1. More → Album backup (or Album backup in Settings) → View backup / restore
2. Default filter Missing on device (backed up before, gone locally; not items in the recycle bin, and not permanent deletes from this app)
3. Tap Restore all missing, or multi-select then Restore selected → confirm (file count, size, path-mapping count) → restore (Items after linking an old phone are usually “Backup only”; the Missing-on-device filter also shows those pending files)
4. Restored files appear in the local gallery

Parallel-folder restore paths (important)

If the backup contains parallel paths such as Documents/…:

Basic and Pro can both authorize parallel folders (see Settings → Local gallery folders).

If the confirm dialog shows path mapping, some files will land under Pictures. Device-to-device restore (R2) uses the same rule.

New phone (R2) (link existing backup / full restore library; Basic and Pro)

1. More → Album backup → View backup / restore
2. Tap Link existing backup → pick the old phone’s backup/{deviceId}/ on the NAS (restore source only)
3. After indexing, use the Backup only filter for files not on this phone
4. Multi-select or Restore all missing (same parallel-folder rule: without SAF they go to Pictures/…)
5. Later backups from this phone still write to its own folder; the old phone can keep backing up separately

After clearing app storage (same phone)

1. After a backup, Export settings first (this also remembers the backup deviceId)
2. Clear app storage (or reinstall) → grant permissions again → Restore settings as soon as possible (do not enable album backup first, or a new device identity may be created)
3. Open album backup → Check pending backup: the app connects to the home backup zone and marks local files that still match the NAS as synced—no full re-upload
4. If you restore settings on another phone that already has a different identity: the write identity stays; the imported old deviceId is treated as a linked restore source (use “Link existing backup” to index / restore)
5. If the export is old (no deviceId), export again after a backup, or pick the old folder with “Link existing backup”

9.8 Export and restore settings

If you used an older (SambaProfile) test build before the refactor, clear app data or reinstall, then set up hosts and home albums again. Do not import old-format settings files.

9.9 Report a problem and diagnostics

10. FAQ

Q1: Local photos are missing?

• Confirm Photos and videos access is granted
• Settings → Local gallery folders: make sure the folder is in Include folders

Q2: Cannot connect to home storage?

• Phone and NAS / PC must be on the same home Wi‑Fi / LAN
• Settings → Host connections: check address, account, and password
• Confirm SMB is enabled on the NAS / PC (port 445)
• If scan finds nothing: turn Wi‑Fi on, stay on the same LAN as the storage, then scan again
• Cannot connect while away:
  • NAS: remote access must be WebDAV, with the correct DDNS / port → WebDAV guide
  • Windows / no WebDAV: see the Tailscale guide
  • Other cases: Troubleshooting §E

Q3: A system permission prompt appears when deleting or editing a local photo?

On Android 11+, some media created by other apps needs an extra grant to modify / delete. Allow it in the system dialog.

Q4: Portrait / smooth looks weak?

• Confirm a face was detected, or drag the circle and resize it with the slider
• Raise Smooth
• Apply (✓) then Save

Q5: Quality drops after editing?

Portrait preview uses a lower resolution for speed; Save processes at original resolution. If it still looks too strong, lower Smooth.

Q6: Copy / upload to a home album is slow?

Speed depends on network bandwidth and file size. Use a stable Wi‑Fi connection.

Q7: Why can I view SVG but not edit it?

SVG is vector. The app can only view a rasterized bitmap, not edit vectors and save SVG, so Edit is hidden. See §5.6.

Q8: Why is there no Edit button for GIF / HEIC?

Those formats can be viewed, but an edited save cannot keep the original format (GIF animation, HEIC encoding). To avoid damage, Edit is only for .jpg, .jpeg, .png, .webp.

Q9: An SVG file is missing from the local gallery?

Confirm Android MediaStore indexed it (Downloads is a common case). If the system never registered the SVG as media, this app cannot list it.

Q10: A video is listed but will not play?

• Confirm the extension is in §5.7
• On the phone: the app tries the built-in engines (Media3 or the compatibility engine); if that fails, open with another app. You can also test the same file in another player
• Network video: check the network; if needed, clear cache in Settings and retry

11. Permissions

12. Basic and Pro

Home Gallery offers Basic and Pro. Basic is ad-free and already includes full photo / video management (local and home albums, timelines, home video streaming, recycle bin, parallel folders, manual album backup and exclude folders, restore / link an old phone, and more). Extra space comes from home storage, not cloud quotas. Pro is an optional one-time purchase that additionally unlocks automatic album backup (background upload on Wi‑Fi) and photo casting to a TV.

Production builds unlock Pro with an in-app purchase; debug builds can toggle related features in Settings for testing.

12.1 Basic — free

12.2 Pro — one-time purchase

On top of everything in Basic:

12.3 Related Settings switches

After a successful Pro purchase / restore, a one-time “You are on Pro” dialog appears; later launches (including after the process is killed) do not show it again.

Recycle bin options (Settings → Local gallery → Recycle bin options): default delete is Move to recycle bin or Permanently delete; confirm before emptying the bin; expiry reminders (daily notification for items the system will permanently delete within about a day; Android 13+ needs notification permission).

• Default = Move to recycle bin: deletes from the local gallery / viewer go to the bin (and can be restored).
• Default = Permanently delete: after confirm, local gallery / viewer deletes should actually delete and must not enter the bin because of that delete. The bin can still show items for other reasons:
  1. After a fully successful upload, you chose to move local copies to the recycle bin (independent of the delete default)
  2. Photo edit keeps a pre-edit backup in the recycle bin before overwrite
  3. Other apps / the system gallery moved items into the shared MediaStore trash
• With the recycle bin off, local deletes are always permanent; a successful upload will not ask to move copies to the bin.

12.4 How to upgrade

1. More → Settings → Upgrade to Pro (or an upgrade prompt when you try automatic backup, photo cast, and similar)
2. Complete the Google Play one-time purchase
3. After a new phone or reinstall, use Restore purchases in Settings

12.5 Pro FAQ

Q: Can Basic edit, delete, and upload?

Yes. Basic is a full photo manager, not a view-only app.

Q: Do local or home videos require Pro?

No. Local and home video playback are Basic. Pro unlocks automatic album backup and photo cast.

Q: Does photo cast to a TV require Pro?

Yes. Basic can play a slideshow on the phone; TV cast needs Pro. Video Cast remains Basic.

Q: Why does video cast say “bitrate too high”?

Only when transcode is required but there is no local file or transcode cache yet. Typical phone H.264 casts directly and is not blocked by bitrate. HEVC and other TV-incompatible codecs are prepared first. See §5.7.

Q: How is upload different from backup?

Upload is you picking files and a home album folder (Basic and Pro). With the recycle bin on, a fully successful upload can move local copies to the bin to save space. Backup writes the local gallery one way into an app-managed private backup zone and keeps local copies by default; restore in the app when you need it.

Q: How does album backup differ between Basic and Pro?

Basic supports manual backup, exclude folders, and restore / linking an old phone. Pro can additionally enable automatic background backup on Wi‑Fi.

Q: Is backup two-way?

No. Backup is phone → NAS. Editing backup files on the NAS does not write back to the phone. Restore is a deliberate action in the app.

Q: Office Lens files live in Documents. Can Basic see them?

Yes. Basic and Pro can Select and authorize parallel folders such as Documents under Settings → Local gallery.

Q: When restoring, where do Documents and other parallel folders go?

Without SAF for that folder: a mapped path under Pictures/ (not back to Documents/…). With that parallel folder authorized: the original relative path. The restore confirm dialog shows how many paths are mapped. See §9.7.

Q: Why is “Use this folder” grey when authorizing Download?

This is an Android 11+ system limit. The app cannot get a tree grant for the Download root. Choose Documents, or authorize a subfolder under Downloads. The app does not offer a “read-only include Download” path (it would disagree with copy / restore writes and be more awkward).

13. Version info

Under More → About (or More → Settings → About) you can see:

• Version (currently 1.2.5; trust About in the app)
• Build date
• User guide (this online manual: https://jasoncschang-stack.github.io/homegallery-privacy/help/)
• Report a problem
• Copyright

Settings → Support opens the same guide.

This public guide matches App 1.2.5 and manual 1.50.

繁體中文

1. 簡介

Home Gallery（家相簿）是一款 Android 相片與影片管理應用程式，讓您同時管理手機本機與家中儲存（NAS／PC，透過 SMB 連線）上的相片與影片。空間自己決定，不必為雲端加購容量——用家裡已有的硬碟擴充，照片留在您掌控的空間。

• 瀏覽與管理本機相簿中的相片與影片
• 以 家中相簿 連線家中 NAS／PC 的共用資料夾（每張卡片對應「一台主機 + 一個 share + 一個資料夾」）
• 在設定中以 主機連線管理 統一登記 SMB 主機帳密（掃一次、登入一次，之後沿用）
• 檢視、編輯、分享、複製、移動、重新命名與刪除相片
• 投影片自動播放選取的相片（本機／家中相簿；Pro 可同時投影到電視）
• 將常用目錄加入書籤快速存取
• 本機時間軸瀏覽；家中相簿時間軸依日期瀏覽家中媒體
• 家中影片可在手機串流播放（無需先整檔下載）
• 介面語言：英文、繁體中文、简体中文、日本語、한국어（隨系統語言）

本 App 不提供雲端相簿代管服務；SMB 帳密僅保存在您的裝置上。Basic 為無廣告的完整相片管理器（含投影片、家中影片串流、時間軸、回收桶、平行目錄、手動相簿備份與瀏覽備份區等）；Pro（選購、一次性購買）額外解鎖相簿備份自動同步，以及將相片／投影片投影到電視。

系統需求：Android 11（API 30）或以上。

2. 首次使用

2.1 開啟應用程式

啟動後預設進入本機相簿。若尚未授予相片讀取權限，畫面會提示您授權 「相片和影片」 存取權限，請點選允許。

2.2 主畫面導覽（底部導航）

主畫面以底部導航列切換主要功能（橫向時改為螢幕一側的導覽列，項目相同）。共四個分頁：

沒有側邊欄。「網路儲存」連線列表亦不存在；家中檔案一律由 家中 分頁進入。
關於（含評價／分享／版本）在 更多 → 關於；設定 → 支援亦可開啟。升級 Pro、問題回報也可在設定內操作。

家中／書籤的二次點選：已在該分頁時再點同一圖示，可開關上方的選擇面板，無須先離開目前瀏覽內容。

多選或進入檢視器／播放器時，底部導航可能暫時隱藏，返回主瀏覽後再出現。

2.3 離開應用程式

在本機相簿、家中相簿或設定等主畫面，按一次返回鍵會提示「再按一次返回鍵離開」；2 秒內再按一次即可關閉 App。

3. 本機相簿

3.1 瀏覽相片

• 根目錄顯示資料夾列表（如 DCIM、Pictures）
• 點選資料夾進入，即可看到該目錄下的相片格狀列表
• 點選相片進入全螢幕瀏覽
• 已啟用回收桶時：標題列可開啟回收桶（有項目時會顯示數量徽章；Basic／Pro 皆可於設定啟用）

3.2 搜尋與排序

• 使用頂部搜尋欄依檔名搜尋；右側 X 在有文字時清除關鍵字，無文字時關閉搜尋
• 點選排序按鈕，可切換排序欄位（名稱、修改日期、拍攝日期、大小、資料夾）與升冪/降冪

3.3 多選操作

1. 長按任一相片／影片進入選取模式；在資料夾根目錄長按資料夾，可一次選取該資料夾內全部媒體
2. 點選其他項目加入選取（資料夾模式下亦可點選資料夾切換整夾選取）
3. 區間多選：已在選取模式時，再長按另一張（或另一個資料夾），會依目前瀏覽順序選取兩者之間的全部項目（含兩端）；錨點為最近一次點選或長按進入選取的項目
4. 底部工具列出現：投影片、複製、移動、刪除、分享、上傳至家中相簿
5. 在資料夾模式刪除整夾媒體後，若該路徑已無檔案，App 會嘗試移除空白資料夾（不會刪除 DCIM／Pictures 等系統根目錄；若資料夾內仍有非媒體檔案則保留）

投影片：多選後點 投影片，會以選取中的相片開始自動播放（影片會略過）。詳見 §5.8。

3.4 加入書籤

在相簿工具列點選書籤圖示，即可將目前目錄加入書籤；之後可從底部導航 書籤 開啟。

3.5 瀏覽模式

本機相簿根目錄提供兩種檢視，可於工具列切換：

時間軸：

• 底部日期軸：可依年／月／日粒度顯示；雙指縮放切換粒度，提示文字中的「年／月／日」可點選直接切換
• 日粒度時軸上顯示縮圖，標籤為日期（中文環境為「M月d日」）與年份
• 右側快速捲動條（內容較多時）：拖曳可快速跳轉
• 支援搜尋、多選、viewer 與影片播放

共通：

• 書籤仍指向資料夾路徑；從書籤進入會切回資料夾模式

設定 → 本機相簿 → 格狀顯示 可設定預設瀏覽模式（資料夾／時間軸）與預設排序；App 亦會記住上次使用的模式。

4. 家中相簿與 SMB 主機

還沒在電腦／NAS 開過共用？ 請先看獨立建置指南：
家中儲存建置指南（Windows 11 · Synology · QNAP；連不上見 排查；外出 NAS見 WebDAV；外出 Windows／無 WebDAV見 Tailscale）。

家中檔案以兩層概念管理：

4.1 新增 SMB 主機

1. 開啟 更多 → 設定 → 主機連線管理 → 管理主機連線
2. 點 新增 SMB 主機（或家中相簿流程中的「尋找新的 SMB 主機」）
3. 對話框會掃描區域網路，並提示確認 Wi‑Fi 已開啟且與儲存裝置同一區網
4. 選取主機（已登記者會灰顯）→ 輸入帳密；若有主機名稱會帶入顯示名稱 → 測試連線 → 儲存
   • 區網 IPv4：家中 Wi‑Fi 用（如 192.168.x.x）
   • 遠端存取（選用，見 §4.4）：
     • WebDAV：NAS 外出用；填 外網主機（DDNS／公網 IP） 與 HTTPS 埠（常見 5006）
     • Tailscale：Windows 或無法開 WebDAV 時；填 100.x
     • 無：只在家中區網使用，不啟用外出輔助
5. 亦可改手動輸入主機位址

連線說明（設定內）

• 家中相簿以同一家中 Wi‑Fi（區網）使用為主；在家時走 SMB
• 外出改用行動數據時：
  • NAS：建議用 WebDAV（DDNS／公網 IP），見 WebDAV 使用手冊
  • Windows PC 或無 WebDAV：用 Tailscale 或既有家中區網 VPN，見 Tailscale 使用手冊
• 畫面可能顯示「家中區網」或「外網」；外網模式仍須你已正確設定 WebDAV 或 Tailscale（或 VPN）才可能連上
• 管理主機連線頁的「連線說明」卡片可直接開啟線上 WebDAV／Tailscale 建置頁
• 啟用 IPv6（同頁開關，預設關閉）：關閉時探索與連線僅用 IPv4，並隱藏 IPv6 欄位；已儲存的 IPv6 不會清除。開啟後才會掃描／使用 IPv6。外出請用 WebDAV／Tailscale（見 §4.4）

4.2 新增家中相簿

1. 底部導航 → 家中（若尚無相簿會引導新增；或再開一次 家中 開啟相簿選擇器 → 管理家中相簿）
2. 若尚無相簿，點 連線家中儲存（或 FAB 新增）
3. 若尚無主機：自動開啟「新增 SMB 主機」對話框；儲存後進入後續步驟
4. 若已有主機：
   • 僅一台：直接進入 選擇共用資料夾（share）
   • 多台：先選主機，再選 share
   • 畫面提供 尋找新的 SMB 主機 按鈕（需要時才掃描）
5. 選擇相簿資料夾：瀏覽 share 內子資料夾；可停留在任意層級作為相簿根
6. 顯示名稱（選填） 預設為資料夾名稱 → 點 完成（一次新增一筆）
7. 完成後由 家中 分頁進入瀏覽；再點 家中 可切換其他相簿

不再於新增相簿流程中重跑完整主機掃描／多選多個 share 一次建多筆。

4.3 瀏覽與管理

1. 底部導航 → 家中 → 進入相簿（或再開一次 家中 從選擇器切換）
2. 進入該來源資料夾瀏覽（格狀／列表）
3. 標題列可切換資料夾／時間軸：時間軸依日期跨資料夾顯示相片與影片（Basic）。首次開啟會建立索引，之後優先顯示快取；索引超過約 24 小時會在連線後靜默更新，也可手動重新整理。時間軸畫面單指下拉可重整目前畫面附近的資料夾（區段重整），不必整庫重掃
4. 子資料夾內切到時間軸時，只顯示該資料夾範圍
5. 點選相片進入瀏覽；工具列可重新整理。時間軸上重新命名後索引會立刻跟著新檔名；再移動時以新路徑為準
6. 時間軸多選可做時間回歸（對齊參考張）或單張相片時間修正（日期與時間）
7. 家中相簿管理畫面可為各相簿設定時間軸掃描深度（1～8 層，預設 4；相簿根為第 0 層）

移除相簿連結

• 於家中相簿管理畫面：長按卡片或點 ⋮ → 移除相簿連結
• 僅從 App 列表移除連結，不會刪除儲存裝置上的檔案

多選移動／複製

• 目的地選擇對話框會列出家中相簿（僅顯示名稱，不顯示第二列路徑細節），再可進入子資料夾

4.4 外出連線（選用）

離開家中 Wi‑Fi 後，請依主機類型選一種遠端方式：

WebDAV（NAS 建議）

1. 家中 Wi‑Fi 先把主機與家中相簿設好（§4.1～4.2）
2. NAS 啟用 WebDAV HTTPS，並準備 DDNS 或公網 IP
3. 編輯主機 → 遠端存取 = WebDAV → 填外網主機與埠 → 測試連線 → 儲存
4. （多數家用 NAS 為自簽憑證）可勾選 允許不受信任的 HTTPS 憑證：App 會先套用系統信任；失敗時才對該主機做憑證釘選（TOFU）——第一次成功連線會記住憑證指紋。若 NAS 之後換憑證而無法連線，請關閉再開此開關以重新釘選
5. 外出開啟家中相簿即可（關家中 Wi‑Fi 驗證）

完整步驟與安全提醒：WebDAV 使用手冊。

Tailscale（Windows／無 WebDAV）

可用 Tailscale 當安全隧道，讓手機以 100.x 連回家中 SMB。

精簡流程：

1. 家中 Wi‑Fi 先把主機與家中相簿設好（§4.1～4.2）
2. PC／NAS：安裝 Tailscale → 登入 → Connected → 複製該機的 Tailscale IPv4（100.x）
3. 手機：安裝 Tailscale → 同一帳號 → Connected
4. 外出開啟家中相簿 → App 提示時 開啟 Tailscale → 複製 PC 的 100.x → 返回 App → 貼上 → 儲存 Tailscale IP 並重試

日常： 要看相簿再開 Tailscale；離開 App 或回到家中 Wi‑Fi 時，App 會請 Tailscale 斷線以省電。若你已有 OpenVPN 等連進區網，通常不必再開 Tailscale。

完整圖文步驟、FAQ 與注意事項：Tailscale 使用手冊。

啟用 IPv6（選用）

在 主機連線管理 可開關 啟用 IPv6（預設關閉）：

• 關閉： 主機探索與連線只走 IPv4；編輯畫面隱藏 IPv6 欄位；已儲存的 IPv6 位址保留不清除
• 開啟： 才會掃描／填入 IPv6，並在連線候選中使用
• 外出連線請用 §4.4 的 WebDAV／Tailscale

5. 圖片瀏覽

從本機／家中相簿點選相片可全螢幕瀏覽；亦可在其他 App（檔案管理員、下載、訊息等）用「開啟方式」選擇家相簿直接開圖。

5.1 基本操作

左下角顯示相片日期：有 EXIF 拍攝時間（DateTimeOriginal／Digitized）時為 日期＋時間；否則取修改／建立時間中較早者，僅顯示日期（不含一般 DateTime 標籤，避免誤用較晚的檔案時間）。全螢幕或投影片播放時隱藏。

5.2 頂部工具列

若目前檔案格式不支援編輯，頂部工具列不會顯示編輯按鈕。

5.3 側邊 / 底部操作列

點選箭頭展開操作列（若設定為「自動收合」模式），或在設定中改為固定顯示。

直向時操作列在底部；橫向時在右側。

5.4 檔案屬性

屬性對話框顯示：

• 檔案資訊：檔名、路徑、大小、類型、建立日期、修改時間
• EXIF 資訊（若相片含有拍攝資料）：解析度、拍攝參數、GPS 等

若相片不含 EXIF，僅顯示檔案相關資訊；建立日期一定會顯示。

5.5 複製 / 移動

1. 點選複製或移動
2. 在目錄瀏覽對話框（全螢幕 GRID 選擇器）中選擇目標資料夾
   • 預設不顯示空資料夾；可切換 顯示空資料夾 以選擇尚未放入檔案的資料夾
   • 同一列提供 新增資料夾、確認 按鈕
   • 新增資料夾後會自動設為目標（即使為空也會顯示於列表），可直接按確認
3. 若目標已有同名檔案，會詢問：
   • 覆寫：以新檔取代
   • 同時保留：保留原檔，新檔自動加編號（如 photo (1).jpg）
   • 取消：中止操作

本機多選：移動可用於相片與影片；選取含影片時不顯示複製（影片複製尚未實作）。

5.6 圖片格式與功能限制

App 依副檔名與 MIME 類型判斷檔案能否瀏覽、編輯。下表適用於本機相簿與 家中相簿（家中儲存上非下列格式的檔案會顯示為一般檔案，無法以看圖器開啟）。

可瀏覽的相片格式

.jpg、.jpeg、.png、.gif、.webp、.bmp、.heic、.heif、.svg、.svgz

可編輯的相片格式

僅下列格式可在瀏覽頁進入圖片編輯，且儲存後仍維持相同格式：

其餘可瀏覽格式（.gif、.bmp、.heic、.heif、.svg、.svgz 等）不提供編輯按鈕，以避免儲存時格式不符或檔案損壞。

SVG / SVGZ 特別說明

其他格式備註

影片格式

App 依副檔名辨識下列影片格式（本機相簿與 家中相簿皆同）。詳細播放說明見 §5.7。

.3gp、.avi、.flv、.m2ts、.m4v、.mkv、.mov、.mpeg、.mpg、.mp4、.qt、.rm、.rmvb、.swf、.ts、.vob、.webm、.wmv

設定 → 媒體清單篩選 頁面亦會列出上述影片副檔名作為參考。

5.7 影片播放

本機與家中相簿影片皆可在 App 內串流播放（家中無需先整檔下載）。投影片見 §5.8。

App 辨識的影片副檔名

.3gp、.avi、.flv、.m2ts、.m4v、.mkv、.mov、.mpeg、.mpg、.mp4、.qt、.rm、.rmvb、.swf、.ts、.vob、.webm、.wmv

副檔名在清單內表示 App 會以影片開啟；不代表一定能成功解碼，實際結果仍取決於影片內部編碼與裝置能力。

手機播放

編碼限制：副檔名相同不代表編碼相同。若兩種引擎皆無法解碼，可能只有聲音、黑畫面或無法播放。

格式對照摘要

投影到電視（影片 Cast）

本機與家中影片投影屬 Basic（相片投影見 §5.9）。需與電視同一區網。部分副檔名（如 .avi、.wmv）不顯示 Cast 按鈕。

提示「此影片位元率過高」只會出現在需要先轉檔、但家中檔案還沒下載／沒有轉檔快取時。已確認的 H.264 不會因此被擋；請改用手機播放，本機已有檔或之後有快取可再試投影。

5.8 投影片播放（Slideshow）

可對本機相簿、家中相簿中的相片進行投影片自動播放（於手機螢幕）。Basic／Pro 皆可使用。Pro 可同時將投影片投到電視（見 §5.9）。影片請使用影片播放器（見 §5.7）。

如何開始

選取內容若沒有任何相片（例如只選了影片），會提示「請至少選取一張相片」，不會進入投影片。

播放行為

手勢（播放中）

暫停後

系統返回鍵：若正在投影片中，會先結束投影片；再按一次才離開瀏覽頁（行為依目前畫面狀態）。

5.9 相片投影到電視（Cast）

Pro 可將本機或家中相簿的相片投影到支援 Google Cast 的電視／Chromecast。Basic 在相片瀏覽頁仍看得到 Cast 圖示，點選會提示升級。

需與電視同一區網。首次使用請允許本機網路權限。

6. 圖片編輯

從瀏覽頁點選編輯進入（僅 .jpg、.jpeg、.png、.webp 會顯示此按鈕，見 §5.6）。

編輯採草稿模式，操作分兩層：

1. 進入某一工具後，在底部（直向）或右側（橫向）調整參數；按 ✓ 將該步驟套用至工作預覽，或按 X 放棄本步驟並返回工具選擇。
2. 回到工具選擇畫面後，頂部 儲存 才會把所有已套用結果寫入檔案。

橫向：進入肖像／調整／裁剪任一工具時，頂部標題列會自動隱藏，以爭取預覽空間；系統返回鍵或工具列 X 可離開該工具。

6.1 工具選擇

底部（直向）或右側（橫向）顯示三項工具：

6.2 裁剪

深色面板；比例以圖示列選取：

• 傾斜角度：−15°～+15°，拖曳刻度滑桿調整；可按重設歸零
• 自動：僅在您按下「自動」時才運算建議傾斜角（進入裁剪頁不會自動運算）
• 翻轉／旋轉：位於底部確認列中間，立即作用於工作圖（仍需之後按 ✓ 才算套用本裁剪步驟）
• 拖曳裁切框移動；拖曳四角縮放。拉動時才顯示九宮格輔助線
• 完成後點 ✓ 套用本步驟

6.3 調整

深色面板；底部確認列中間切換四項：

• 右側可重設目前項目
• 旋轉／翻轉請至裁剪工具使用
• 完成後點 ✓ 套用本步驟

6.4 肖像

深色面板；進入後自動偵測人臉（可「重新偵測」）。底部確認列中間切換：柔膚、亮度、對比、飽和度。

無偵測到人臉時：

• 柔膚強度自動為 0%，不顯示建議值
• 畫面顯示圓形作用區：可單指拖曳移動位置，用上方滑桿調整大小，再調高柔膚

有人臉時：

• 依最大人臉佔畫面比例動態計算建議柔膚（近拍偏高、遠景／合照偏低），並顯示「建議 N%」
• 人臉以框線標示

完成後點 ✓ 套用本步驟。

6.5 儲存與取消

編輯預覽（工具選擇、肖像、調整）支援雙指縮放與雙擊縮放（約 1×～3×），縮放後可拖曳平移；裁剪模式不啟用預覽縮放，手勢留給裁切框。

7. 書籤

7.1 新增書籤

在本機或家中相簿中，點工具列的書籤圖示。成功後底部會顯示「已加入書籤」提示。

播放影片時可點星號將目前影片加入影片書籤（含續播位置）。

7.2 使用書籤

1. 底部導航點 書籤（已在書籤分頁時再點一次可開關面板）
2. 面板內可選：
   • 資料夾書籤：直接跳至該目錄
   • 影片書籤：開啟播放器並嘗試續播

7.3 移除書籤

在書籤面板中長按項目 → 確認移除（資料夾書籤與影片書籤皆同）。

8. 上傳至家中相簿

1. 在本機相簿進入多選模式，選取相片／影片
2. 點選底部 上傳 圖示
3. 選擇目標家中相簿（列表僅顯示相簿名稱）與可選的子資料夾（不可選備份專用區）
4. 確認上傳

上傳進度

• 顯示目前進度（例如 N / M）、檔名與位元組進度條
• 可隨時按停止中止剩餘檔案；已完成者保留，結果會區分成功／部分成功／已取消

同名檔案

• 目標目錄若已有同名檔，會自動改名為 檔名 (1).ext、檔名 (2).ext…，不會覆寫既有檔

上傳成功後刪除本機

• 僅在全部項目上傳成功，且已啟用回收桶時，會詢問是否將本機副本移至回收桶
• 可選 移至回收桶 或 保留本機；未開回收桶時只顯示上傳成功提示，不詢問刪除
• 備份流程不會提供此選項；移至回收桶後，若該檔已納入相簿備份，遠端備份副本仍保留

9. 設定

開啟 更多 → 設定。

9.1 主機連線管理

• 檢視、編輯、刪除已儲存的 SMB 主機
• 進入「管理主機連線」後可新增主機（區網掃描或手動輸入）
• 「連線說明」可開啟線上 WebDAV／Tailscale 外出建置頁；同頁可開關 啟用 IPv6（預設關閉，見 §4.1／§4.4）
• 設定首頁不會重複「新增 SMB 主機」按鈕；請由管理頁操作

9.2 家中相簿（設定區塊）

• 顯示已設定的家中相簿筆數
• 相片投影（Pro）：將本機／家中相片投到電視。Basic 點開關會提示升級；Pro 為已解鎖（由瀏覽頁 Cast 按鈕使用）。家中影片串流屬 Basic，不再需要設定開關
• 直式 H.264 直投：影片 Cast 的相容選項（Basic）；僅在電視畫面橫置時才需關閉
• 新增／移除相簿請至底部導航 家中（相簿選擇器／管理畫面）操作

9.3 本機相簿目錄

• 包含目錄：指定要顯示哪些根目錄下的相片（預設 DCIM、Pictures）
• 排除目錄：排除特定子目錄

Basic 與 Pro 差異（平行目錄）

Basic 與 Pro 皆可於設定中授權 Documents 等平行路徑；未授權時還原可能映射至 Pictures/…（見 §9.7）。

注意（Android 平台限制）：自 Android 11 起，系統不允許透過資料夾選擇器授權整個 Download（下載）根目錄——進入後「使用這個資料夾」會變灰。這不是 App 故障。可行作法：授權 Documents 等路徑，或先在下載目錄下建立子資料夾再授權該子資料夾。

兩種授權請勿混淆

9.4 顯示設定

9.5 快取管理

檢視快取占用空間，並可清除快取（含網路縮圖、圖片磁碟快取、網路影片串流快取、記憶體快取）。清除後不影響原始相片，但下次瀏覽家中相簿圖片或影片需重新下載或產生快取。

9.6 媒體清單篩選

可設定要隱藏的資料夾名稱、檔名或副檔名，套用於本機與家中相簿列表。內建相片／影片副檔名規則為唯讀參考。

設定頁已分層：本機相簿、媒體篩選、主機連線管理、家中相簿（含網路影片串流）、相簿備份、快取、問題回報／匯出診斷等類別，點選後進入細項。

9.7 相簿備份

相簿備份將本機相簿單向上傳至家中儲存上的私有備份區（.HomeGallery/backup/{裝置}/），供手機故障時還原。

每位裝置在自己的資料夾內維護 device_info.json（型號、可選顯示名稱、上次備份時間）。多人共用同一備份錨點時，可在相簿備份設定 本機備份身分 → 顯示名稱；「連結既有備份」清單會顯示該名稱／型號，而非只有 android_xxxx。

若改選另一個共用資料夾（share）、換主機，或改備份錨點資料夾，本機追蹤會重來：已同步／失敗／僅備份區等計數清空；請再按檢查待備份重新掃描（新目的地上若已有同裝置備份，仍可對齊為已同步，不必整批重傳）。

與 Basic「上傳至公共目錄」不同：備份區由 App 管理、網路瀏覽預設隱藏，且預設保留本機副本。

瀏覽備份區（資料夾大畫面）

1. 更多 → 相簿備份 → 瀏覽備份區
2. 以家中相簿資料夾模式（格狀大圖）進入私有備份根目錄，可逐層開啟資料夾
3. 僅備份區項目有紅色邊框；長按選取後可自備份區清除（並移出追蹤）
4. 若檔案在備份區磁碟上、但本機索引沒有對應紀錄，會標 未追蹤（常見於手動放到備份資料夾、或索引曾重設）；需重新掃描／遠端索引後才會納入「僅備份區」管理
5. 清單式還原／篩選仍走下方的 檢視備份／還原

還原流程（R1.1）

1. 更多 → 相簿備份（或設定內相簿備份）→ 檢視備份／還原
2. 預設篩選 本機缺失（曾備份、本機已不存在；不含回收桶內項目、亦非本 App 永久刪除）
3. 點 還原全部缺失，或先多選再 還原已選 → 確認對話框（檔案數、大小、路徑映射數量）→ 還原 （連結舊機後的項目多半標為「僅備份區」；「本機缺失」篩選亦會一併顯示這些待還原檔）
4. 還原完成後本機相簿可見

平行目錄還原路徑（重要）

備份區若含 Documents/… 等平行目錄路徑：

Basic／Pro 皆可授權平行目錄（見 §9.3）。

確認還原前，對話框若顯示有檔案需路徑映射，即代表部分檔會改寫入 Pictures 下。換機還原（R2）同一規則。

換機（R2）（連結既有備份／完整還原庫；Basic／Pro 皆可）

1. 更多 → 相簿備份 → 檢視備份／還原
2. 點 連結既有備份 → 選 NAS 上舊機的 backup/{deviceId}/（只當還原來處）
3. App 索引備份樹後，在 僅備份區 篩選檢視本機沒有的檔案
4. 多選或 還原全部缺失 寫回本機（平行目錄路徑規則同上：無 SAF 時進 Pictures/…）
5. 本機之後的新備份仍寫入自己的資料夾；舊機若繼續使用可照常備份，兩邊不會共用寫入根

清除 App 儲存後復原設定（同機）

1. 備份完成後先 匯出設定（會一併記住備份用的 deviceId）
2. 清除 App 儲存空間（或重裝）→ 重新授權 → 儘早復原設定（勿先開啟相簿備份，以免先產生新的裝置身分）
3. 開啟相簿備份 → 檢查待備份：App 會連上家中備份區，把本機已有且與 NAS 相符的檔標為已同步，不必整批重傳
4. 若在另一台手機復原設定且該機已有不同裝置身分：寫入身分不變，匯入的舊 deviceId 會當成連結還原來處（請再用「連結既有備份」索引／還原）
5. 若匯出檔是舊版（沒有 deviceId），請在備份後重新匯出，或改用「連結既有備份」選回舊目錄

9.8 設定備份與還原

重構後若曾使用舊版（SambaProfile）測試版，請清除 App 資料或重裝後重新設定主機與家中相簿；勿匯入舊格式設定檔。

9.9 問題回報與診斷匯出

10. 常見問題（FAQ）

Q1：看不到本機相片？

• 確認已授予「相片和影片」讀取權限
• 至設定 → 本機相簿目錄，確認相片所在目錄已加入「包含目錄」

Q2：無法連線家中儲存？

• 確認手機與 NAS／PC 在同一家中 Wi‑Fi／區域網路
• 至設定 → 主機連線管理 確認主機位址、帳號、密碼正確
• 確認 NAS／PC 的 SMB 服務已啟用（port 445）
• 若掃描不到主機：確認 Wi‑Fi 已開啟，並與儲存裝置同一區網後重新掃描
• 外出連不上：
  • NAS：確認遠端存取為 WebDAV，且 DDNS／埠正確 → WebDAV 手冊
  • Windows／無 WebDAV：見 Tailscale 手冊
  • 其餘排查：排查 §E

Q3：刪除或修改本機相片時出現系統授權提示？

Android 11 以上對部分由其他 App 建立的媒體，修改/刪除需額外授權。請在系統對話框中允許。

Q4：肖像／柔膚效果不明顯？

• 確認已偵測到人臉，或已手動拖曳圓形並用滑桿調整大小
• 調高「柔膚」強度
• 套用（✓）後再儲存

Q5：編輯後相片品質下降？

肖像預覽為加速而降低解析度；儲存時使用原圖解析度處理。若仍不滿意，請降低柔膚強度。

Q6：複製／上傳到家中相簿很慢？

速度取決於網路頻寬與檔案大小。建議在穩定的 Wi-Fi 環境下操作。

Q7：為什麼 SVG 看得到但不能編輯？

SVG 為向量格式，App 僅能光柵化後瀏覽，無法以向量方式編輯並存回 SVG。因此瀏覽頁會隱藏編輯按鈕。詳見 §5.6。

Q8：為什麼 GIF / HEIC 沒有編輯按鈕？

這些格式雖可瀏覽，但儲存編輯結果時無法維持原格式（例如 GIF 動畫、HEIC 編碼）。為避免檔案損壞，App 僅對 .jpg、.jpeg、.png、.webp 提供編輯功能。

Q9：本機相簿找不到 SVG 檔？

請確認檔案已被 Android MediaStore 索引（常見於「下載」等目錄）。若系統未將 SVG 登錄為媒體檔，本 App 無法列出該檔案。

Q10：影片有列出但無法播放？

• 確認副檔名在 §5.7 所列格式內
• 手機無法播：App 會先嘗試內建引擎（Media3 或相容引擎）；仍失敗時可用「其他應用程式」開啟。亦可改用其他 App 測試同一檔案
• 網路影片：確認網路穩定，必要時至設定清除快取後重試

11. 權限說明

12. Basic 與 Pro 版本

Home Gallery 提供 Basic（基本版） 與 Pro 兩種使用方式。Basic 無廣告，已包含完整的相片／影片管理（本機與家中相簿、時間軸、家中影片串流、回收桶、平行目錄、手動相簿備份與排除目錄、還原／連結舊機等）；空間擴充靠家中儲存，不必為雲端加購容量。Pro 為選購、一次性購買，額外解鎖相簿備份自動同步（Wi‑Fi 背景下上傳）以及相片投影到電視。

正式版透過應用內購買解鎖 Pro；開發版可於設定中開關相關功能以測試。

12.1 Basic（基本版）— 免費

12.2 Pro — 一次性購買

在 Basic 全部能力之上，額外解鎖：

12.3 設定中的相關開關

購買／還原 Pro 成功後，會顯示一次確認對話框「已是 Pro 版」；之後啟動（含程序被系統清掉再打開）不會再跳出。

回收桶選項（設定 → 本機相簿 → 回收桶選項）：可設定預設刪除為移至回收桶或永久刪除、清空回收桶前是否確認、以及到期提醒（約 1 天內將被系統永久刪除的項目每日通知；Android 13+ 需通知權限）。

• 預設＝移至回收桶：本機相簿／檢視器的刪除會移入回收桶（之後可還原）。
• 預設＝永久刪除：本機相簿／檢視器的刪除經確認後應真正刪除，不會因刪除動作進入回收桶。此時回收桶仍可能出現項目，常見原因：
  1. 上傳全部成功後，您在對話框選擇將本機副本移至回收桶（與刪除預設無關）
  2. 影像編輯覆寫前，系統保留的「編輯前」備份會放進回收桶
  3. 其他 App／系統相簿移入系統回收桶的項目（本 App 與系統回收桶共用 MediaStore）
• 回收桶關閉時，本機刪除一律為永久刪除；上傳成功後也不會詢問移至回收桶。

12.4 如何升級

1. 更多 → 設定 → 升級 Pro（或觸發自動備份、相片投影等 Pro 功能時的升級提示）
2. 完成 Google Play 一次性購買
3. 換機或重裝後，於設定使用 還原購買

12.5 常見問題

Q：Basic 能編輯、刪除、上傳嗎？

可以。Basic 是完整的相片管理器，不是只能看的 Viewer。

Q：本機影片或家中影片要 Pro 嗎？

不需要。本機與家中影片播放皆屬 Basic；Pro 解鎖相簿備份自動同步與相片投影。

Q：相片投影到電視要 Pro 嗎？

要。Basic 可在手機播放投影片；投到電視需 Pro。影片 Cast 仍屬 Basic。

Q：為什麼影片投影提示「位元率過高」？

只在需要先轉檔、但家中還沒有本機檔或轉檔快取時。常見手機 H.264 是直接投影，不會因碼率被擋。HEVC 等電視解不了的會先準備再投。詳見 §5.7。

Q：上傳和備份有什麼不同？

上傳是您手動選檔、選家中相簿目錄（Basic／Pro 皆可）。若已開啟回收桶，上傳全部成功後可選擇將本機副本移至回收桶以省空間。備份是將本機相簿單向寫入 App 管理的私有備份區，預設不刪本機；需要時在 App 內手動還原。

Q：Basic 和 Pro 的相簿備份差在哪？

Basic 支援手動備份、排除目錄、還原／連結舊機。升級 Pro 後可額外啟用 Wi‑Fi 自動背景備份。

Q：備份會雙向同步嗎？

不會。備份是本機 → NAS；在 NAS 上改備份檔不會自動寫回手機。還原需您在 App 內主動操作。

Q：Office Lens 在 Documents 裡，Basic 看得到嗎？

可以。Basic 與 Pro 皆可在設定 → 本機相簿中選取並授權 Documents 等平行資料夾，納入掃描範圍。

Q：從備份還原時，Documents 等平行目錄會還原到哪裡？

尚未 SAF 授權該資料夾時：寫入 Pictures/ 下的映射路徑（不會寫回原 Documents/…）。已授權該平行資料夾時：可寫回原本相對路徑。還原確認對話框會顯示路徑映射筆數。詳見 §9.7。

Q：為什麼授權 Download／下載 時「使用這個資料夾」是灰色的？

這是 Android 11 以後的系統限制，App 無法對下載根目錄取得資料夾樹授權。請改選 Documents，或在下載底下對子資料夾授權。本 App 不另提供「只讀納入 Download」（與複製／還原等寫入行為不一致，操作更煩瑣）。

13. 版本資訊

在 更多 → 關於（或 更多 → 設定 → 關於），可查看：

• 版本號（目前為 1.2.5，以 App「關於」為準）
• 建置日期
• 使用說明（開啟線上手冊：https://jasoncschang-stack.github.io/homegallery-privacy/help/）
• 回報問題
• 版權資訊

設定 → 支援 亦可開啟同一份使用說明。

公開使用說明已與本手冊對齊（App 1.2.5／手冊 1.50）：https://jasoncschang-stack.github.io/homegallery-privacy/help/

日本語

<!-- Source: English user manual 1.50 / App 1.2.5; machine-translated to Japanese -->

1. はじめに

ホームギャラリーは、Android用の写真・動画管理アプリで、デバイス内のメディアや家庭内ストレージ（NAS / SMB経由でPC）に対応しています。スペースは自分で選べます—追加のクラウド容量を購入する必要はありません。 既に持っているディスクを使い、写真は自分が管理するストレージに保存されます。

• ローカルギャラリーで写真や動画を閲覧・管理
• ホームアルバムを共有フォルダーに接続する（各カードは1つのホスト＋1つの共有＋1つのフォルダー）
• 設定の Host connections で SMB の資格情報を一度登録する（一度スキャンして、一度サインインし、後で再利用）
• 写真を表示、編集、共有、コピー、移動、名前変更、削除する
• スライドショー は選択した写真（ローカル / ホームアルバム）を自動再生します；Pro はスライドショーをテレビにキャストすることもできます
• よく使うフォルダーをブックマークする
• ローカルのタイムラインを閲覧する；ホームアルバムタイムラインで日付ごとにホームメディアを閲覧する
• ホームビデオは電話でストリーミングできます（最初にファイル全体をダウンロードする必要はありません）
• UI言語: 英語、繁体字中国語、簡体字中国語、日本語、韓国語（システム言語に従う）

このアプリはクラウドギャラリーをホストしません。SMB のパスワードはデバイスに保存されます。Basic は完全で広告のない写真管理アプリです（スライドショー、ホームビデオストリーミング、タイムライン、ごみ箱、並行フォルダ、手動アルバムバックアップ、バックアップゾーンの閲覧など）。Pro（任意、一度きりの購入）では、さらに自動アルバムバックアップおよびTVへの写真／スライドショーキャストが解除されます。

要件: Android 11 (API 30) 以上。

2. はじめに

2.1 アプリを開く

アプリはローカルギャラリーで開きます。まだ写真へのアクセスが許可されていない場合は、写真と動画を許可してください。

2.2 メインナビゲーション（下部バー）

ボトムナビゲーションバーは主要な領域を切り替えます（横向きでは同じ項目でサイドレールになります）。タブは4つあります：

サイドバーはありません。また、「ネットワークストレージ」の接続リストもなく、ホームのファイルは常にホームタブから開きます。
「について」（評価 / 共有 / バージョン）は その他 → について にあります。設定 → サポート でも開けます。Pro にアップグレードと問題の報告も設定にあります。

ホーム / ブックマークを2回目にタップ： すでにそのタブにいる場合、同じアイコンをタップすると、閲覧中のページを離れずにピッカーパネルを切り替えることができます。

マルチセレクト中やビューア／プレーヤーで、下部バーが隠れ、ブラウジングに戻ると再表示される場合があります。

2.3 アプリを終了する

ローカルギャラリー、ホームアルバム、または設定などのメイン画面では、最初の 戻る ボタンの押下時に「もう一度戻るを押すと終了します」と表示されます。2秒以内にもう一度押すとアプリが閉じます。

3. 地元のギャラリー

3.1 写真の閲覧

• ルートはフォルダー（例えば DCIM、Pictures）を表示します
• フォルダーを開いて写真のグリッドを表示する
• 写真をタップして全画面表示
• ごみ箱が有効になっている場合: タイトルバーを開くとごみ箱が開きます（アイテムがあるとカウントバッジが表示されます; Basic と Pro は設定でこれを有効化できます）

3.2 検索と並べ替え

• 上の検索フィールドを使ってファイル名で検索します；右側のXはテキストがある場合はクリアし、空の場合は検索を閉じます
• 並べ替えをタップして、フィールド（名前、変更日、撮影日、サイズ、フォルダ）および昇順／降順を変更します

3.3 複数選択

1. 写真や動画を長押しして選択モードに入ります。フォルダのルートでは、フォルダを長押しすると内部のすべてのメディアを選択できます。
2. 他のアイテムをタップして追加します（フォルダモードでは、フォルダ全体を選択するかどうかを切り替えるためにフォルダをタップすることもできます）
3. 範囲選択: すでに選択している状態で、別の項目（またはフォルダ）を長押しすると、現在の閲覧順でその間のすべての項目（含む）が選択されます。アンカーは、選択を開始した最後のタップまたは長押しです。
4. 下部ツールバーには以下が表示されます：スライドショー、コピー、移動、削除、共有、ホームアルバムにアップロード
5. フォルダモードでフォルダ内のメディアをすべて削除した後、パスにファイルが残っていない場合、アプリは空のフォルダを削除しようとします（DCIM / Pictures のようなシステムルートは削除されません。メディア以外のファイルを含むフォルダは保持されます）

スライドショー: 複数選択の後、選択した写真を自動再生するにはスライドショーをタップします（動画はスキップされます）。§5.8を参照してください。

3.4 ブックマーク

ギャラリーツールバーのブックマークアイコンをタップして、現在のフォルダーをブックマークします。後でブックマークタブから開くことができます。

3.5 ブラウズモード

地元のギャラリー root では、ツールバーで表示を切り替えます:

タイムライン：

• 下の日付軸: 年／月／日単位；ピンチして変更するか、ヒントの「年／月／日」をタップしてください
• 日単位の粒度では、軸にはサムネイルが表示されます；ラベルは日付（中国語のロケールでは M月d日）と年です
• 右側の高速スクロールバー（コンテンツが十分にある場合）は素早くジャンプします
• 検索、複数選択、ビューア、およびビデオ再生がサポートされています

共有:

• ブックマークはまだフォルダのパスを指しています；ブックマークを開くとフォルダモードに戻ります

設定 → ローカルギャラリー → グリッド表示 は、デフォルトの閲覧モード（フォルダー / タイムライン）とデフォルトの並べ替えを設定します。アプリは最後に使用したモードも記憶します。

4. ホームアルバムとSMBホスト

PCやNASでフォルダーをまだ共有していませんか？ スタンドアロンのセットアップガイドから始めましょう:
Set up home storage (Windows 11 · Synology · QNAP; 接続できない場合は Troubleshooting を参照; 離れて NAS は WebDAV を参照; 離れて Windows / WebDAV がない場合 は Tailscale を参照).

ホームファイルは2つの層を使用します:

4.1 SMB ホストを追加

1. その他 → 設定 → ホスト接続 → ホスト接続の管理 を開きます
2. SMBホストを追加をタップ（またはホームアルバムのフローでは「新しいSMBホストを探す」）
3. ダイアログはLANをスキャンし、あなたにWi‑Fiがオンであり、ストレージと同じネットワーク上にあることを確認するよう求めます
4. ホストを選択（すでに保存されているホストは薄く表示されます）→ 資格情報を入力；ホスト名は利用可能な場合、表示名として使用されます → 接続をテスト → 保存
5. LAN IPv4: 家庭用 Wi‑Fi（例えば 192.168.x.x）
6. リモートアクセス（任意、§4.4参照）：
7. WebDAV: NAS の間離れている場合；外部ホスト (DDNS / 公開IP) と HTTPS ポート を入力（多くの場合 5006）
8. Tailscale: Windows用、またはWebDAVが利用できない場合; 100.xを入力してください
9. なし: ホームLANのみ、外部ヘルパーなし
10. ホストアドレスを手動で入力することもできます

接続のメモ（設定内）

• ホームアルバムは 同じホーム Wi‑Fi（LAN） 用です；自宅ではアプリは SMB を使用します
• 外出先でモバイルデータを使用する場合:
• NAS: WebDAV を好む (DDNS / 公共IP); WebDAV guide を参照
• Windows PC またはなし WebDAV: Tailscale または既存の LAN VPN を使用; Tailscale guide を参照
• UIには「ホームLAN」や「外出中」と表示されることがあります。外出中モードでも、WebDAV、Tailscale、またはVPNが正しく設定されている必要があります。
• 「接続ノート」カードは、ホスト接続の管理でオンラインの WebDAV / Tailscale 設定ページを開きます
• Enable IPv6(同じページ、デフォルトでオフ):オフ時はDiscovery and ConnectがIPv4のみを使用し、IPv6フィールドは非表示;保存されたIPv6は保持されます。オンにしてスキャン/IPv6を使用します。AwayはWebDAV / Tailscale(§4.4参照)を使用。

4.2 ホームアルバムを追加する

1. 下部ナビゲーション → ホーム（アルバムがまだない場合、設定が提案されます；または再度 ホーム をタップ → ホームアルバムを管理）
2. まだアルバムがない場合は、ホームストレージに接続（または 追加 FAB）をタップします
3. まだホストがいない場合: 「ホストを追加 SMB」ダイアログが開きます。保存後、セットアップが続行されます
4. 既にホストが存在する場合：
5. 1つのホスト：共有を選択 に進む
6. 複数のホスト：ホストを選択してから、共有を選択
7. 新しいSMBホストを見つける はスキャンが必要なときに利用可能です
8. アルバムのフォルダーを選択: 共有内のサブフォルダーを参照します; アルバムのルートで任意のレベルで停止できます
9. 表示名（任意） はフォルダ名がデフォルト → 完了 をタップ（これで 1つ のアルバムが作成されます）
10. ホームタブから開きます；アルバムを切り替えるには再度ホームをタップします

＞ セットアップは もう フルホストスキャンを再実行したり、複数の共有を一度に選択して多くのアルバムを作成したりすることはできません。

4.3 閲覧と管理

1. 下部ナビゲーション → ホーム → アルバムを開く（または ホーム を再度タップしてピッカーで切り替える）
2. そのソースフォルダーを閲覧する（グリッド / リスト）
3. タイトルバーは フォルダ / タイムライン を切り替えます。タイムラインはフォルダを横断して日付ごとに写真や動画を表示します（Basic）。初めて開くとインデックスが作成され、後の訪問ではキャッシュが優先されます。インデックスが約24時間以上古い場合、接続後に自動的に静かに更新されます。また、手動で更新することもできます。タイムライン上では、現在表示されている付近のフォルダを更新するために 下に引き下げる（セグメント更新）ことができ、ライブラリ全体の再スキャンは不要です。
4. サブフォルダ内でタイムラインに切り替えると、そのフォルダの範囲のみが表示されます
5. 写真をタップして表示します。ツールバーで更新できます。タイムラインで名前を変更した後、インデックスは新しい名前に従います。その後の移動では新しいパスが使用されます
6. タイムラインのマルチセレクトは、時間を揃える（参照写真と一致させる）ことや、単一の写真の時間を修正する（日付と時刻）ことができます
7. ホームアルバムの管理画面では、各アルバムにタイムラインスキャン深度（1～8レベル、デフォルトは4；アルバムのルートはレベル0）があります

アルバムのリンクを削除する

• ホームアルバムの管理画面で：カードを長押しするか ⋮ をタップ → アルバムリンクを削除
• これはアプリ内のリンクのみを削除します；ストレージデバイス上のファイルは削除されません

複数選択して移動／コピー

• 宛先ピッカーはホームアルバムを表示名のみで一覧表示します（2行目のパスは表示されません）、その後サブフォルダを入力できます

4.4 離れた場所からのアクセス（オプション）

家を出た後Wi‑Fi、ホストタイプのためのリモート方法を1つ選んでください:

WebDAV（NASに推奨）

1. ホームWi‑Fiで、まずホストとホームアルバムを設定する（§4.1–4.2）
2. NASでWebDAV HTTPSを有効にし、DDNSまたはパブリックIPを準備します
3. ホストを編集 → リモートアクセス = WebDAV → 外部ホストとポートを入力 → 接続をテスト → 保存
4. （ほとんどの家庭用NASは自己署名証明書を使用しています）信頼されていないHTTPS証明書を許可を有効にすることができます：アプリはまずシステムの信頼を試みます；それが失敗した場合、そのホストの証明書をピン留めします（TOFU）—最初の接続に成功した時にフィンガープリントが保存されます。後でNAS証明書が変更されて接続に失敗した場合は、このオプションを一度オフにしてから再度オンにしてピンを再設定してください
5. 不在時にホームアルバムを開く（確認のためホームWi‑Fiをオフにする）

完全な手順とセキュリティに関する注意事項: WebDAV guide。

Tailscale（Windows / WebDAVなし）

Tailscale を安全なトンネルとして使用し、携帯電話が 100.x で自宅 SMB に接続できるようにします。

短いフロー:

1. ホームWi‑Fiで、まずホストとホームアルバムを設定する（§4.1–4.2）
2. PC / NAS: Tailscale をインストール → サインイン → 接続済み → そのマシンの Tailscale IPv4 (100.x) をコピー
3. 電話: インストール Tailscale → 同じアカウント → 接続済み
4. 外出中にホームアルバムを開く → プロンプトが表示されたら 開くTailscale → PCの100.xをコピー → アプリに戻る → 貼り付け → Tailscale IPを保存して再試行

日常的な使い方: アルバムが必要なときにTailscaleを開きます。アプリを離れるかホームに戻るとWi‑Fi、アプリは電力を節約するためにTailscaleの切断を求めます。すでにLANにOpenVPN（または同様のもの）がある場合、通常はTailscaleは必要ありません。

完全なウォークスルー、FAQ、ノート：Tailscale guide。

IPv6 を有効にする（オプション）

ホスト接続の下で、有効化 IPv6（デフォルトではオフ）を切り替えることができます：

• オフ: 発見と接続はIPv4のみ; 編集時にIPv6フィールドは非表示; 保存されたIPv6は保持される
• オン: アプリはIPv6をスキャン/入力でき、接続候補間で使用できます
• 遠隔アクセスには §4.4 の WebDAV / Tailscale を使用してください

5. 写真ビューア

ローカルまたはホームギャラリーの写真をタップして全画面表示します。他のアプリ（ファイル、Download、メッセージなど）でもHome Galleryで開くことができます。

5.1 ジェスチャー

左下隅には写真の日付が表示されます: EXIF DateTimeOriginal / Digitized が存在する場合、日付 + 時刻 が表示されます。存在しない場合は、修正日 / 作成日のより早い方が使用され、日付のみ が表示されます（通常の DateTime タグは無視されるため、誤って後のファイル時刻が使用されることはありません）。フルスクリーンまたはスライドショー時は非表示です。

5.2 上部ツールバー

現在のフォーマットを編集できない場合、編集ボタンは表示されません。

5.3 サイド／ボトムアクション

矢印をタップしてアクション行を展開します（自動折りたたみモードの場合）、または設定で常に表示に設定します。

縦向き：下部に操作。横向き：右側に操作。

5.4 Proプロパティ

プロパティダイアログには次の内容が表示されます:

• ファイル情報: 名前、パス、サイズ、種類、作成日、最終更新時間
• EXIF（存在する場合）：解像度、撮影設定、GPS、など

EXIFのない写真でもファイル情報は表示されます；作成日は常に表示されます。

5.5 コピー / 移動

1. コピーまたは移動をタップ
2. フォルダブラウザ（全画面グリッド）で目的地を選択する
3. 空のフォルダーはデフォルトで非表示になっています。ファイルがまだないフォルダーを選択するには、空のフォルダーを表示をオンにしてください
4. 同じ行に 新しいフォルダ と 確認 があります
5. 「新しいフォルダー」の後、それが対象になります（空でも表示されるので、すぐに確認できます）
6. もし宛先に同じ名前が既にある場合:
7. 上書き: 新しいファイルで置き換える
8. 両方を保持する: 元のファイルを保持する; 新しいファイルには番号（photo (1).jpg）が付く
9. キャンセル: 中止

ローカルマルチセレクト: 移動は写真と動画で機能します; 選択に動画が含まれる場合、コピーは非表示です（動画のコピーはまだ実装されていません）。

5.6 画像形式と制限

アプリは拡張子とMIMEタイプを使用して、ファイルが表示可能か編集可能かを判断します。この表はローカルギャラリーおよびホームアルバムに適用されます（ホームストレージ上のその他のファイルは通常のファイルとして表示され、ビューアで開くことはできません）。

表示可能な写真形式

.jpg, .jpeg, .png, .gif, .webp, .bmp, .heic, .heif, .svg, .svgz

編集可能な写真形式

これらの形式のみがビューワーから編集に入ることができ、保存後も同じ形式のままです:

他の表示可能な形式（.gif、.bmp、.heic、.heif、.svg、.svgzなど）には編集ボタンがありませんので、保存しても形式を変更したりファイルを損傷したりすることはできません。

SVG / SVGZ

その他のフォーマットに関する注記

ビデオフォーマット

アプリは、ローカルギャラリーおよびホームアルバムの両方でこれらのビデオ拡張子を認識します。再生の詳細は§5.7に記載されています。

.3gp, .avi, .flv, .m2ts, .m4v, .mkv, .mov, .mpeg, .mpg, .mp4, .qt, .rm, .rmvb, .swf, .ts, .vob, .webm, .wmv

設定 → メディアリストフィルター には、これらの動画拡張子も参照用として一覧表示されています。

5.7 ビデオ再生

ローカルおよびホームアルバムのビデオはアプリでストリーミングできます（ホームファイルは最初に完全にダウンロードする必要はありません）。スライドショーは§5.8です。

認識されたビデオ拡張子

.3gp, .avi, .flv, .m2ts, .m4v, .mkv, .mov, .mpeg, .mpg, .mp4, .qt, .rm, .rmvb, .swf, .ts, .vob, .webm, .wmv

リストに載っているということは、アプリがファイルをビデオとして開くことを意味します。デコードを保証するものではなく、それは依然として内部のコーデックとデバイスに依存します。

電話で

コーデックの制限: 同じ拡張子でも異なるコーデックを隠すことがあります。両方のエンジンが失敗した場合、音声のみ、黒いフレーム、または再生不可になることがあります。

形式の概要

Cast ビデオをテレビに

ローカルまたはホームアルバムからビデオをCastすることはBasicです（フォトキャストは§5.9を参照）。電話とテレビは同じLANに接続されている必要があります。一部の拡張機能（例えば.avi、.wmv）はCastボタンを隠します。

「この動画のビットレートが高すぎます」は、トランスコードが必要だが、ホームファイルがダウンロードされていない／トランスコードキャッシュが存在しない場合にのみ表示されます。その理由でH.264がブロックされていないことを確認してください。電話で再生し、ローカルファイルまたはキャッシュが存在する状態で再度キャストを試みてください。

5.8 スライドショー

ローカルまたはホームギャラリーの写真を電話画面で自動再生します。BasicおよびProで利用可能です。Proはスライドショーをテレビに送信することもできます（§5.9参照）。ビデオにはビデオプレーヤーを使用してください（§5.7）。

始め方

選択に写真が含まれていない場合（例えば、動画のみ）、「少なくとも1枚の写真を選択してください」と表示され、スライドショーは開始されません。

再生

プレイ中のジェスチャー

一時停止後

システムバック：スライドショーが実行中の場合、最初の押下で終了し、もう一度押すとビューアを終了します（現在の画面によります）。

5.9 Cast の写真をテレビに

Pro はローカルまたはホームアルバムの写真を Google Cast TV / Chromecast にキャストできます。Basic は写真ビューアに Cast アイコンを表示し続けます；それをタップするとアップグレードが促されます。

電話とテレビは同じLANに接続されている必要があります。初回はローカルネットワークの許可を与えてください。

6. 写真編集者

ビューアで 編集 をタップします（.jpg、.jpeg、.png、.webp のみこのボタンが表示されます、§5.6 を参照）。

編集は下書きです。層は二つあります：

1. ツール内で、下（縦向き）または右（横向き）を調整します；作業プレビューにそのステップを適用するには ✓ をタップし、ステップを破棄してツールピッカーに戻るには X をタップします。
2. ツールピッカーに戻ると、上部の 保存 はすべての適用されたステップをファイルに書き込みます。

ランドスケープ: ポートレート / 調整 / トリミングに入ると、プレビュー用スペースのために上部のタイトルバーが隠れます；システムの「戻る」またはツールバーの X を押すと、そのツールを終了します。

6.1 ツール

3つのツールが下部（縦向き）または右側（横向き）に表示されます：

6.2 作物

ダークパネル；アイコン行からアスペクトを選択してください：

• 傾き: −15°から+15°、スケールをドラッグ；リセットで0に戻ります
• オート: 推奨される傾きは、オートをタップしたときのみ計算されます（クロップに入るときではありません）
• 反転 / 回転: 下部の確認行の中央にあります；作業中の画像にすぐ適用されます（このトリミングステップを確定するには、後で✓が必要です）
• クロップボックスをドラッグして移動します；角をドラッグして拡大縮小します。三分割法のガイドはドラッグ中のみ表示されます
• ステップを適用するには ✓ をタップしてください

6.3 調整

ダークパネル；確認行の中央は4つのアイテムを切り替えます：

• 右側のリセットは現在の項目をリセットします
• 回転/反転には切り抜きを使用してください
• ステップを適用するには ✓ をタップしてください

6.4 ポートレート

ダークパネル; ツールに入力すると顔を検出します（「再検出」も可能です）。確認行は切り替わります: 滑らかさ、明るさ、コントラスト、彩度。

顔が見つからない場合:

• 滑らかさの強さは0%で、提案は表示されません
• 円形の領域が表示されます: 指1本でドラッグして移動し、スライダーでサイズを変更してから、スムーズに持ち上げます

顔が見つかったとき:

• 推奨スムーズは、フレームの最大の顔の割合を使用します（クローズアップは高め、グループ／遠景は低め）および「推奨 N%」を表示します
• 顔が輪郭で描かれている

ステップを適用するには ✓ をタップしてください。

6.5 保存とキャンセル

エディタープレビュー（ツールピッカー、ポートレート、調整）はピンチズームとダブルタップズーム（約1×〜3×）をサポートし、その後パンが可能です。クロップではプレビューはズームされないため、ジェスチャーはクロップボックスにとどまります。

7. ブックマーク

7.1 ブックマークを追加する

ローカルまたは自宅のアルバムで、ツールバーのブックマークアイコンをタップします。「ブックマーク済み」というヒントが画面下部に表示されます。

ビデオを再生している間に、星印をタップしてビデオブックマーク（再生位置を含む）を追加します。

7.2 ブックマークを使用する

1. 下部バーのブックマークをタップします（そのタブをもう一度タップするとパネルを切り替えられます）
2. パネルで開くことができます:
3. フォルダブックマーク: そのフォルダにジャンプ
4. ビデオブックマーク: プレイヤーを開き、再開を試みてください

7.3 ブックマークを削除する

ブックマークパネルの項目を長押し → 確認（フォルダと動画のブックマークも同じ操作です）。

8. ホームアルバムにアップロード

1. ローカルギャラリーで複数選択を入力し、写真や動画を選択します
2. 下の アップロード アイコンをタップしてください
3. ホームアルバム（名前のみ）とオプションのサブフォルダを選択します（プライベートバックアップゾーンは選択できません）
4. 確認

Proグレス

• 進行状況（N / M）、ファイル名、およびバイトバーを表示します
• 停止 は残りのファイルをキャンセルします; 完了したファイルは保持されます; 結果は成功 / 部分成功 / キャンセル済みを区別します

同じ名前

• もし宛先にすでに同じ名前が存在する場合、アップロードはname (1).ext、name (2).ext、…と名前が変更され、上書きされません

アップロードに成功した後、ローカルを削除する

• すべてのアイテムが正常にアップロードされ、かつごみ箱が有効になっている場合にのみ、アプリは「ローカルのコピーをゴミ箱に移動しますか」と尋ねます
• ゴミ箱に移動 または デバイスに保持 を選択します。ゴミ箱オフの場合は成功メッセージのみが表示されます
• アルバムのバックアップではこれを提供していません；ファイルがすでにアルバムバックアップにある場合、ゴミ箱に移動した後でもリモートバックアップのコピーは保持されます

9. 設定

「その他 → 設定」を開きます。

9.1 ホスト接続

• 保存されたSMBホストを表示、編集、または削除
• ホスト接続の管理からホストを追加する（LANスキャンまたは手動アドレス）
• 接続メモはオンラインの WebDAV / Tailscale 遠隔セットアップページを開きます。同じページで IPv6 を有効化 を切り替えます（デフォルトではオフ、§4.1 / §4.4 を参照）。
• 設定のホーム画面では ホストSMBを追加 は 繰り返されません。管理ページを使用してください

9.2 ホームアルバム（設定ブロック）

• 設定されているホームアルバムの数を表示します
• フォトキャスト（Pro）： ローカル／家庭の写真をテレビにキャストします。Basic スイッチをタップするとアップグレードを促されます；Pro は解除されています（ビューアーの Cast ボタンを使用）。自宅の ビデオ ストリーミングは Basic で、設定のスイッチはもう必要ありません
• ポートレート H.264 直接キャスト: ビデオCast互換オプション（Basic）；テレビの映像が回転している場合のみオフにしてください
• ホームタブからアルバムを追加/削除する（ピッカー / 管理画面）

9.3 ローカルギャラリーフォルダー

• フォルダーを含める: 表示するルート（デフォルト DCIM、Pictures）
• フォルダーを除外: 特定のサブフォルダーをスキップ

Basic 対 Pro（並行フォルダー）

設定でBasicおよびProはDocumentsのような並行パスを許可できます。その権限がない場合、復元はPictures/…にマッピングされることがあります（§9.7参照）。

注意（Androidプラットフォームの制限）： Android 11から、システムはフォルダピッカーで Download ルート全体の認可を 許可しません—「このフォルダを使用」はグレーのままです。これはアプリのバグではありません。Documents（または同様のもの）を認可するか、Download の下に サブフォルダー を作成してそのサブフォルダーを認可してください。

その二つの助成金を混同しないでください

9.4 ディスプレイ

9.5 キャッシュ

キャッシュサイズを確認し、キャッシュをクリア（ネットワークのサムネイル、画像ディスクキャッシュ、ネットワーク動画ストリームキャッシュ、メモリキャッシュ）。オリジナルはそのままです。次回のホームアルバム閲覧時には、キャッシュを再度ダウンロードまたは再構築する必要があります。

9.6 メディアリストフィルター

ローカルおよびホームアルバムリストでフォルダー名、ファイル名、または拡張子を非表示にします。組み込みの写真/ビデオ拡張子ルールは読み取り専用の参照です。

設定は次のようにグループ化されています: ローカルギャラリー、メディアフィルター、ホスト接続、ホームアルバム（ネットワークビデオストリーミングを含む）、アルバムのバックアップ、キャッシュ、問題の報告 / 診断のエクスポート、など。

9.7 アルバムのバックアップ

アルバムのバックアップは、ローカルギャラリーからホームストレージのプライベートゾーン（.HomeGallery/backup/{device}/）への一方向のアップロードで、電話が故障した後に復元できるようにします。

各デバイスは、それぞれのフォルダにdevice_info.jsonを保持します（モデル、任意の表示名、最後のバックアップ時間）。複数の人が同じバックアップアンカーを共有する場合は、アルバムバックアップ設定でローカルバックアップの識別 → 表示名を設定してください。「既存のバックアップをリンク」リストには、android_xxxxだけでなく、その名前／モデルが表示されます。

別の共有に切り替える、ホストを変更する、またはバックアップアンカーフォルダーを変更すると、ローカルトラッキングは最初から始まります：同期済み／失敗／バックアップのみのカウントはクリアされます。保留中のバックアップを確認をタップして再度スキャンしてください（新しい保存先に既にこのデバイスのバックアップがある場合、アイテムは再アップロードせずに同期済みとして揃うことがあります）。

Basic「パブリックフォルダにアップロードする」とは異なり、バックアップゾーンはアプリ管理で、デフォルトでは通常のネットワーク閲覧から隠されており、ローカルコピーもデフォルトで保持します。

バックアップゾーンを閲覧（大きなフォルダグリッド）

1. もっと → アルバムのバックアップ → バックアップゾーンを閲覧
2. ホームアルバムフォルダモード（大きなグリッド）でプライベートバックアップルートを開き、必要に応じてフォルダを掘り下げる
3. バックアップ専用 アイテムは赤い枠で表示されます。長押しして選択し、バックアップゾーンから削除（および追跡解除）できます
4. バックアップディスク上に存在するが、ローカルインデックス行がないファイルは、未追跡とラベル付けされます（手動でコピーされたものや、インデックスリセット後のものが多いです）。バックアップ専用として表示される前に、スキャンまたはリモートインデックスを実行してください。
5. リスト形式の復元 / フィルターは、以下の バックアップ / 復元を表示 をまだ使用します

復元 (R1.1)

1. その他 → アルバムのバックアップ（または設定のアルバムのバックアップ）→ バックアップ / 復元の表示
2. デフォルトフィルター デバイス上に存在しない（以前にバックアップ済みで、ローカルでは消滅；ごみ箱内のアイテムではなく、このアプリからの永久削除でもない）
3. すべての不足を復元 をタップするか、複数選択して 選択を復元 → 確認（ファイル数、サイズ、パスマッピング数）→ 復元

（古い電話をリンクした後のアイテムは通常「バックアップのみ」です。デバイスにないフィルターも保留中のファイルを表示します）

1. 復元されたファイルがローカルギャラリーに表示されます

並列フォルダーの復元パス（重要）

バックアップに Documents/…: のような並列パスが含まれている場合

Basic と Pro は両方とも並列フォルダを認可できます（設定 → ローカルギャラリーフォルダを参照）。

確認ダイアログにパスマッピングが表示される場合、一部のファイルはPicturesの下に配置されます。デバイス間復元（R2）も同じルールを使用します。

新しい電話 (R2)（既存のバックアップをリンク / ライブラリを完全復元; Basic と Pro）

1. その他 → アルバムのバックアップ → バックアップを表示 / 復元
2. 既存のバックアップをリンク をタップ → 古い電話の backup/{deviceId}/ を NAS で選択（復元元のみ）
3. インデックス作成後、この電話にないファイルには バックアップのみ フィルターを使用します
4. 複数選択または すべての欠落を復元（同じ並列フォルダルール: SAF がない場合、Pictures/… に移動）
5. この電話からの後のバックアップは依然として自分自身のフォルダに書き込まれます。古い電話は別々にバックアップを続けることができます

アプリのストレージをクリアした後（同じ電話）

1. バックアップの後、まず 設定をエクスポート します（これによりバックアップdeviceIdも記憶されます）
2. アプリのストレージをクリア（または再インストール）→ 再度権限を付与 → できるだけ早く設定を復元（最初にアルバムのバックアップを有効にしないこと、新しいデバイスIDが作成される可能性があります）
3. アルバムのバックアップを開く → 保留中のバックアップを確認: アプリはホームバックアップゾーンに接続し、ローカルファイルでNASとまだ一致するものを同期済みとしてマークします—完全再アップロードは不要
4. すでに異なる識別情報を持つ別の電話で設定を復元する場合：書き込み識別情報はそのまま残ります；インポートされた古い deviceId はリンクされた復元元として扱われます（インデックス化／復元するには「既存のバックアップをリンク」を使用してください）
5. エクスポートが古い場合（deviceIdがない場合）、バックアップの後に再度エクスポートするか、「既存のバックアップをリンク」して古いフォルダを選択してください

9.8 設定のエクスポートと復元

リファクタリング前の古い（SambaProfile）テストビルドを使用していた場合は、アプリのデータを消去するか再インストールし、再度ホストとホームアルバムを設定してください。古い形式の設定ファイルはインポートしないでください。

9.9 問題の報告と診断

10. よくある質問

Q1: ローカルの写真が見つかりませんか？

• 写真とビデオへのアクセスが許可されていることを確認する
• 設定 → ローカルギャラリーフォルダー：フォルダーが フォルダーに含める にあることを確認してください

Q2: ホームストレージに接続できませんか？

• 携帯電話とNAS/ PCは同じ家庭用Wi‑Fi/ LANに接続されている必要があります
• 設定 → ホスト接続：アドレス、アカウント、パスワードを確認
• NAS / PC（ポート445）でSMBが有効になっていることを確認してください
• スキャンで何も見つからない場合：Wi‑Fi をオンにし、ストレージと同じLANに接続したまま、再度スキャンしてください
• 離れている間は接続できません:
• NAS: リモートアクセスは WebDAV である必要があり、正しい DDNS / ポート → WebDAV guide
• Windows / なし WebDAV: Tailscale guide を参照
• その他の場合: Troubleshooting §E

Q3: ローカルの写真を削除または編集する際にシステムの権限確認が表示されますか？

Android 11以上では、他のアプリによって作成された一部のメディアは変更や削除するために追加の権限が必要です。システムダイアログで許可してください。

Q4: ポートレート／スムーズは弱く見えますか？

• 顔が検出されたことを確認するか、円をドラッグしてスライダーでサイズを変更してください
• 滑らかさを上げる
• 適用 (✓) してから保存

Q5: 編集後に品質は低下しますか？

ポートレートプレビューは速度のために低解像度を使用します；保存は元の解像度で処理します。まだ強すぎる場合は、スムーズを下げてください。

Q6: ホームアルバムへのコピー／アップロードは遅いですか？

速度はネットワーク帯域幅とファイルサイズに依存します。安定したWi‑Fi接続を使用してください。

Q7: なぜSVGは表示できるのに編集できないのですか？

SVGはベクターです。このアプリはベクターを編集してSVGとして保存することはできず、ラスター化されたビットマップのみを表示できます。そのため、編集は非表示になっています。§5.6を参照してください。

Q8: GIF / HEIC に編集ボタンがないのはなぜですか？

これらの形式は表示できますが、編集された保存では元の形式（GIFアニメーション、HEICエンコード）を保持できません。損傷を避けるため、編集は .jpg、.jpeg、.png、.webp のみに対応しています。

Q9: ローカルギャラリーにSVGファイルが見つかりませんか？

AndroidがMediaStoreをインデックスしたことを確認してください（Download秒は一般的なケースです）。システムがSVGをメディアとして登録していない場合、このアプリはそれを一覧表示できません。

Q10: 動画が表示されているが再生できませんか？

• 拡張が§5.7にあることを確認してください
• 電話で: アプリは組み込みエンジン（Media3 または互換性エンジン）を試します; それが失敗した場合、別のアプリで開きます。同じファイルを別のプレーヤーでテストすることもできます
• ネットワークビデオ：ネットワークを確認してください。必要に応じて、設定でキャッシュをクリアして再試行してください

11. 権限

12. Basic と Pro

ホームギャラリー は Basic と Pro を提供します。Basic は 広告なし で、すでにフルの写真・ビデオ管理（ローカルおよびホームアルバム、タイムライン、ホームビデオストリーミング、ごみ箱、並列フォルダ、手動アルバムバックアップとフォルダ除外、古い電話の復元/リンク、その他多数）を含んでいます。追加のスペースはクラウドの割り当てではなくホームストレージから提供されます。Pro は 任意の一度きりの購入 で、さらに 自動アルバムバックアップ（Wi‑Fi でのバックグラウンドアップロード）と 写真のテレビへのキャスト をアンロックします。

Prouction ビルドでは、アプリ内購入で Pro を解除できます；デバッグビルドでは、テストのために設定で関連する機能を切り替えることができます。

12.1 Basic — 無料

12.2 Pro — 一回購入

Basicの上にあるすべてのものの上に：

12.3 関連設定スイッチ

Pro の購入/復元が成功した後、一度だけ「あなたは Pro にいます」というダイアログが表示されます。その後の起動（プロセスが終了した後も含む）では再度表示されません。

ごみ箱のオプション（設定 → ローカルギャラリー → ごみ箱のオプション）：デフォルトの削除はごみ箱に移動または完全に削除; ごみ箱を空にする前に確認する; 有効期限のリマインダー（システムが約1日以内に完全に削除するアイテムの毎日の通知; Android 13+ は通知の許可が必要）。

• デフォルト = ごみ箱に移動: ローカルギャラリー / ビューアから削除してごみ箱に移動（復元可能）。
• デフォルト = 永久に削除: 確認後、ローカルギャラリー/ビューアーでの削除は実際に削除されるべきであり、その削除のためにゴミ箱に入るべきではありません。ゴミ箱には他の理由でアイテムが表示されることはまだあります:
• 完全に成功したアップロードの後、ローカルコピーをゴミ箱に移動することを選択しました（削除デフォルトとは独立しています）
• 写真編集 は、上書きする前に編集前のバックアップをゴミ箱に保存します
• 他のアプリ / システムギャラリー がアイテムを共有の MediaStore ゴミ箱に移動しました
• ゴミ箱がオフの場合、ローカルでの削除は常に永久的です。アップロードが成功しても、コピーをゴミ箱に移動するかどうかは尋ねられません。

12.4 アップグレードの方法

1. さらに → 設定 → Pro にアップグレード（または、自動バックアップ、フォトキャストなどを試すと表示されるアップグレードのプロンプト）
2. Google Play の一度きりの購入を完了する
3. 新しい電話や再インストール後は、設定で購入を復元を使用してください

12.5 Pro よくある質問

Q: Basic は編集、削除、アップロードできますか？

はい。Basicは閲覧専用アプリではなく、完全な写真管理アプリです。

Q: ローカルまたはホームビデオにはProが必要ですか？

いいえ。ローカルおよびホームビデオの再生はBasicです。Proは自動アルバムバックアップとフォトキャストのロックを解除します。

Q: 写真をテレビにキャストするにはProが必要ですか？

はい。Basicは電話でスライドショーを再生できます；テレビキャストにはProが必要です。ビデオCastはBasicのままです。

Q: ビデオキャストで「ビットレートが高すぎます」と表示されるのはなぜですか？

トランスコードが必要だが、ローカルファイルやトランスコードキャッシュがまだ存在しない場合のみ。典型的な電話のH.264は直接キャストされ、ビットレートによってブロックされることはありません。HEVCや他のテレビ非対応コーデックは先に準備されます。§5.7を参照してください。

Q: アップロードはバックアップとどう違いますか？

アップロードとは、あなたがファイルとホームアルバムフォルダ（BasicとPro）を選ぶことです。ゴミ箱がオンの場合、完全に成功したアップロードはローカルのコピーをゴミ箱に移動してスペースを節約できます。バックアップはローカルギャラリーを一方向でアプリ管理のプライベートバックアップゾーンに書き込み、デフォルトでローカルコピーを保持します；必要なときにアプリで復元します。

Q: アルバムのバックアップはBasicとProでどのように異なりますか？

Basic は 手動 バックアップ、フォルダーの除外、旧端末の 復元 / リンクをサポートします。Pro はさらに Wi‑Fi で 自動 バックアップをバックグラウンドで有効にすることができます。

Q: バックアップは双方向ですか？

いいえ。バックアップは 電話 → NAS です。NAS 上のバックアップファイルを編集しても、電話には書き戻されません。復元はアプリでの意図的な操作です。

Q: Office LensのファイルはDocumentsに保存されます。Basicはそれを見ることができますか？

はい。Basic と Pro は、設定 → ローカルギャラリーで Documents のような並列フォルダーを 選択して承認 できます。

Q: 復元する際、Documentsや他の並列フォルダーはどこに行きますか？

そのフォルダーに対してSAFなし: Pictures/以下のマップされたパス（Documents/…には戻らない）。その並列フォルダーが許可されている場合: 元の相対パス。復元確認ダイアログには、何本のパスがマップされているかが表示されます。§9.7を参照してください。

Q: Downloadを認証するときに「このフォルダーを使用」がグレー表示になるのはなぜですか？

これはAndroid 11+ システム制限です。アプリはDownloadのルートに対してツリー権限を取得できません。Documentsを選択するか、Downloadの下にあるサブフォルダを認可してください。アプリは「読み取り専用でDownloadを含める」パスを提供していません（コピー／復元の書き込みと矛盾し、より扱いにくくなるためです）。

13. バージョン情報

「その他 → バージョン情報」（または「その他 → 設定 → バージョン情報」）で以下を見ることができます:

• バージョン（現在 1.2.5；アプリ内の About を確認してください）
• 製造日
• ユーザーガイド（このオンラインマニュアル: https://jasoncschang-stack.github.io/homegallery-privacy/help/）
• 問題を報告する
• 著作権

設定 → サポート を開くと、同じガイドが表示されます。

この公開ガイドは、アプリ 1.2.5 およびマニュアル 1.50 に対応しています。

한국어

<!-- Source: English user manual 1.50 / App 1.2.5; machine-translated to Korean -->

1. 소개

홈 갤러리 은 장치 내 미디어와 가정 저장소(NAS / SMB를 통한 PC)를 위한 안드로이드 사진 및 비디오 관리 앱입니다. 원하는 공간을 선택하세요—추가 클라우드 용량을 구매할 필요가 없습니다. 이미 가지고 있는 디스크를 사용하세요; 사진은 사용자가 제어하는 저장소에 남습니다.

• 로컬 갤러리에서 사진과 동영상을 탐색하고 관리하세요
• 홈 앨범을 NAS / PC의 공유 폴더에 연결하기 (각 카드에는 하나의 호스트 + 하나의 공유 + 하나의 폴더가 있음)
• 설정의 호스트 연결에서 SMB 자격 증명을 한 번 등록하세요 (한 번 스캔하고, 한 번 로그인하면 나중에 재사용 가능)
• 사진을 보고, 편집하고, 공유하고, 복사하고, 이동하고, 이름을 바꾸고, 삭제하세요
• 슬라이드쇼는 선택된 사진(로컬 / 홈 앨범)을 자동 재생합니다; Pro는 슬라이드쇼를 TV로도 전송할 수 있습니다
• 자주 사용하는 폴더를 즐겨찾기
• 로컬 타임라인 탐색; 홈 앨범 타임라인으로 날짜별 홈 미디어 탐색
• 가정용 비디오는 휴대폰에서 스트리밍할 수 있습니다 (전체 파일을 먼저 다운로드할 필요 없음)
• UI 언어: 영어, 번체 중국어, 간체 중국어, 일본어, 한국어 (시스템 언어에 따름)

이 앱은 클라우드 갤러리를 호스팅하지 않습니다. SMB 비밀번호는 사용자의 기기에만 저장됩니다. Basic는 광고 없는 완전한 사진 관리 앱으로, 슬라이드쇼, 홈 비디오 스트리밍, 타임라인, 휴지통, 병렬 폴더, 수동 앨범 백업, 백업 영역 탐색, 그 외 기능들을 제공합니다. Pro (선택 사항, 일회성 구매)는 추가로 자동 앨범 백업과 사진/슬라이드쇼 TV 전송 기능을 잠금 해제합니다.

요구 사항: Android 11 (API 30) 이상.

2. 시작하기

2.1 앱 열기

앱이 로컬 갤러리에서 열립니다. 아직 사진 접근 권한이 허용되지 않았다면 사진 및 동영상을 허용하세요.

2.2 주요 내비게이션 (하단 바)

하단 내비게이션 바는 주요 영역을 전환합니다(가로 모드에서는 동일한 항목으로 측면 레일이 됩니다). 네 개의 탭이 있습니다:

사이드바가 없습니다. 또한 '네트워크 저장소' 연결 목록도 없으며, 홈 파일은 항상 홈 탭에서 열립니다.
정보(평가 / 공유 / 버전)는 더보기 → 정보에서 확인할 수 있으며; 설정 → 지원에서도 열 수 있습니다. Pro로 업그레이드하고 문제를 신고하는 것도 설정에 있습니다.

홈/북마크 두 번째 탭: 이미 해당 탭에 있는 경우, 같은 아이콘을 탭하면 현재 탐색 중인 내용을 벗어나지 않고 선택 패널이 토글됩니다.

멀티 선택 중이거나 뷰어/플레이어에서, 하단 바가 숨겨졌다가 탐색으로 돌아가면 다시 나타날 수 있습니다.

2.3 앱 종료

로컬 갤러리, 홈 앨범 또는 설정과 같은 주요 화면에서 처음 뒤로 버튼을 누르면 '다시 누르면 종료됩니다'가 표시됩니다. 2초 이내에 다시 누르면 앱이 종료됩니다.

3. 지역 갤러리

3.1 사진 탐색

• 루트는 폴더(예: DCIM, Pictures)를 보여줍니다
• 폴더를 열어 사진 그리드를 확인하세요
• 사진을 전체 화면으로 보려면 탭하세요
• 휴지통이 활성화된 경우: 제목 표시줄이 휴지통을 엽니다 (항목이 있을 때 카운트 배지가 나타납니다; Basic과 Pro은 설정에서 이를 활성화할 수 있습니다)

3.2 검색 및 정렬

• 상단 검색 필드를 사용하여 파일 이름으로 검색합니다; 오른쪽의 X는 텍스트가 있을 때 지우거나, 비어 있을 때 검색을 종료합니다
• 필드(이름, 수정 날짜, 캡처 날짜, 크기, 폴더) 및 오름차순/내림차순을 변경하려면 정렬을 탭하세요

3.3 다중 선택

1. 사진/동영상을 길게 누르면 선택 모드로 들어갑니다; 폴더 루트에서는 폴더를 길게 눌러 안의 모든 미디어를 선택할 수 있습니다
2. 다른 항목을 추가하려면 탭하세요 (폴더 모드에서는 폴더 전체를 선택하거나 해제하려면 폴더를 탭할 수도 있습니다)
3. 범위 선택: 이미 선택 중인 상태에서, 다른 항목(또는 폴더)을 길게 누르면 현재 탐색 순서에서 그 사이의 모든 항목(포함)을 선택할 수 있습니다; 기준점은 선택에 들어간 마지막 탭이나 길게 누른 것입니다
4. 하단 도구 모음에는 다음이 표시됩니다: 슬라이드쇼, 복사, 이동, 삭제, 공유, 홈 앨범에 업로드
5. 폴더 모드에서 전체 폴더의 미디어를 삭제한 후, 경로에 파일이 남아 있지 않으면 앱이 빈 폴더를 제거하려고 시도합니다 (DCIM / Pictures과 같은 시스템 루트는 삭제되지 않으며; 미디어가 아닌 파일이 남아 있는 폴더는 유지됩니다)

슬라이드쇼: 다중 선택 후, 선택한 사진을 자동 재생하려면 슬라이드쇼를 탭하세요(비디오는 건너뜁니다). §5.8 참조.

3.4 즐겨찾기

갤러리 도구 모음에서 북마크 아이콘을 눌러 현재 폴더를 북마크하세요; 나중에 북마크 탭에서 열 수 있습니다.

3.5 탐색 모드

지역 갤러리 root에서 도구 모음의 보기를 전환하세요:

타임라인:

• 하단 날짜 축: 연도 / 월 / 일 단위; 확대/축소로 변경하거나 힌트에서 ‘연도 / 월 / 일’을 탭하세요
• 일 단위 세분화에서는 축에 미리보기 이미지가 표시됩니다. 레이블은 날짜(중국어 로케일 M月d日에서)와 연도입니다.
• 오른쪽에 빠른 스크롤러(콘텐츠가 충분할 때)가 빠르게 이동합니다
• 검색, 다중 선택, 뷰어 및 동영상 재생이 지원됩니다

공유됨:

• 즐겨찾기는 여전히 폴더 경로를 가리킵니다; 즐겨찾기를 열면 폴더 모드로 돌아갑니다

설정 → 로컬 갤러리 → 그리드 표시는 기본 탐색 모드(폴더 / 타임라인)와 기본 정렬을 설정하며, 앱은 마지막으로 사용한 모드도 기억합니다.

4. 홈 앨범과 SMB 호스트

PC / NAS에서 아직 폴더를 공유하지 않았나요? 독립 실행형 설정 가이드부터 시작하세요:
Set up home storage (Windows 11 · Synology · QNAP; 연결할 수 없으면 Troubleshooting 참조; 원격 NAS 참고 WebDAV; 원격 Windows / WebDAV 없음 참조 Tailscale).

홈 파일은 두 개의 레이어를 사용합니다:

4.1 SMB 호스트 추가

1. 더보기 → 설정 → 호스트 연결 → 호스트 연결 관리를 엽니다
2. SMB 호스트 추가를 탭하세요(또는 홈 앨범 흐름에서는 “새 SMB 호스트 찾기”를 탭하세요)
3. 대화 상자가 LAN을 스캔하고 Wi‑Fi이 켜져 있으며 스토리지와 동일한 네트워크에 있는지 확인하도록 요청합니다
4. 호스트 선택(이미 저장된 호스트는 흐리게 표시됨) → 자격 증명 입력; 호스트 이름이 사용 가능할 때 표시 이름으로 사용됨 → 연결 테스트 → 저장
5. LAN IPv4: 가정용 Wi‑Fi (예를 들어 192.168.x.x)
6. 원격 접근 (선택 사항, §4.4 참조):
7. WebDAV: 잠시 NAS 동안; 외부 호스트(DDNS / 공용 IP) 와 HTTPS 포트 입력 (보통 5006)
8. Tailscale: Windows용 또는 WebDAV를 사용할 수 없을 때; 100.x를 입력하세요
9. 없음: 집 LAN 전용, 외부 도움 없음
10. 호스트 주소를 수동으로 입력할 수도 있습니다

연결 메모(설정에서)

• 홈 앨범은 같은 집 Wi‑Fi (LAN)용입니다; 집에서는 앱이 SMB를 사용합니다
• 집을 떠나 있을 때 모바일 데이터 사용:
• NAS: WebDAV (DDNS / 공인 IP) 선호; WebDAV guide 참조
• Windows PC 또는 없음 WebDAV: Tailscale 또는 기존 LAN VPN 사용; Tailscale guide 참조
• UI는 '홈 LAN' 또는 '외출'을 표시할 수 있습니다; 외출 모드에서도 WebDAV, Tailscale 또는 올바르게 구성된 VPN이 필요합니다
• 호스트 연결 관리에서 연결 메모 카드가 온라인 WebDAV / Tailscale 설정 페이지를 엽니다
• IPv6 활성화 (같은 페이지, 기본값 끔): 끄면, 검색 및 연결은 IPv4만 사용하고 IPv6 필드는 숨겨집니다; 저장된 IPv6는 유지됩니다. 켜면 IPv6를 스캔 / 사용할 수 있습니다. 자리 비움 시, WebDAV / Tailscale를 사용하세요 (§4.4 참조)

4.2 홈 앨범 추가

1. 하단 내비게이션 → 홈 (아직 앨범이 없으면 설정이 제공됩니다; 또는 홈을 다시 탭 → 홈 앨범 관리)
2. 아직 앨범이 없다면, 홈 스토리지 연결(또는 추가 FAB)을 탭하세요
3. 호스트가 아직 없는 경우: Add SMB 호스트 대화 상자가 열립니다; 저장 후 설정이 계속 진행됩니다
4. 이미 호스트가 존재하는 경우:
5. 한 호스트: 공유 선택으로 바로 이동
6. 여러 호스트: 호스트를 선택한 다음 공유를 선택
7. 스캔이 필요할 때 새 SMB 호스트 찾기 가능
8. 앨범 폴더 선택: 공유 폴더 내의 하위 폴더를 탐색합니다; 앨범 루트에서 어느 수준에서든 멈출 수 있습니다
9. 표시 이름(선택 사항)은 폴더 이름으로 기본 설정 → 완료를 탭합니다 (이렇게 하면 하나의 앨범이 생성됩니다)
10. 홈 탭에서 열고; 앨범을 전환하려면 다시 홈을 탭하세요

설정은 더 이상 전체 호스트 검사를 다시 실행하지 않으며, 여러 공유를 다중 선택하여 한 번에 여러 앨범을 만들 수 없습니다.

4.3 찾아보고 관리하기

1. 하단 내비게이션 → 홈 → 앨범 열기 (또는 홈을 다시 탭하고 선택기에서 전환)
2. 해당 소스 폴더를 찾아보기(그리드 / 목록)
3. 제목 표시줄은 폴더 / 타임라인을 전환합니다. 타임라인은 폴더별로 날짜별 사진과 동영상을 보여줍니다 (Basic). 첫 번째 열 때는 인덱스를 생성하며, 이후 방문에서는 캐시를 선호합니다. 인덱스가 약 24시간 이상 오래된 경우, 연결 후 조용히 새로 고침되며, 수동으로 새로 고침할 수도 있습니다. 타임라인에서 현재 보기에 가까운 폴더를 새로 고치려면 끌어당기기로 새로 고침(부분 새로 고침)을 할 수 있으며 전체 라이브러리 재스캔은 필요 없습니다.
4. 하위 폴더 안에서 타임라인으로 전환하면 해당 폴더의 범위만 표시됩니다
5. 사진을 탭하여 보기; 도구 모음에서 새로 고침할 수 있습니다. 타임라인에서 이름 변경 후, 인덱스는 새 이름을 따릅니다; 이후의 이동은 새 경로를 사용합니다
6. 타임라인 다중 선택은 시간을 맞추거나 (참조 사진과 일치) 또는 단일 사진의 시간을 수정할 수 있습니다 (날짜와 시간)
7. 홈 앨범 관리 화면에서 각 앨범은 타임라인 스캔 깊이(1–8 단계, 기본값 4; 앨범 루트는 0 단계)를 가집니다

앨범 링크 제거

• 홈 앨범 관리 화면에서: 카드를 길게 누르거나 ⋮ 을 탭 → 앨범 링크 제거
• 이것은 앱에서의 링크만 제거하며, 저장 장치의 파일을 삭제하지는 않습니다

다중 선택 이동 / 복사

• 대상 선택기에서는 홈 앨범을 표시 이름으로만 나열합니다(두 번째 줄 경로 없음). 그런 다음 하위 폴더를 입력할 수 있습니다.

4.4 원격 접근(선택 사항)

집을 떠난 후 Wi‑Fi, 호스트 유형에 맞는 원격 방법 하나를 선택하세요:

WebDAV (NAS에게 추천됨)

1. 홈 Wi‑Fi에서 먼저 호스트와 홈 앨범을 설정합니다 (§4.1–4.2)
2. NAS에서 WebDAV HTTPS를 활성화하고 DDNS 또는 공인 IP를 준비합니다
3. 호스트 편집 → 원격 액세스 = WebDAV → 외부 호스트와 포트 입력 → 연결 테스트 → 저장
4. (대부분의 가정용 NAS은 자체 서명 인증서를 사용합니다) 신뢰할 수 없는 HTTPS 인증서 허용을 활성화할 수 있습니다: 앱은 먼저 시스템 신뢰를 시도합니다; 실패하면 해당 호스트에 대해 인증서를 고정(TOFU)합니다—첫 번째 성공적인 연결이 지문을 저장합니다. 나중에 NAS 인증서가 변경되어 연결이 실패하면, 이 옵션을 껐다가 다시 켜서 인증서를 다시 고정하십시오
5. 집에 없을 때 홈 앨범 열기 (확인을 위해 홈 Wi‑Fi 끄기)

전체 단계 및 보안 참고 사항: WebDAV guide.

Tailscale (윈도우 / WebDAV 없음)

휴대폰이 100.x에서 집 SMB에 도달할 수 있도록 Tailscale을 안전한 터널로 사용하세요.

짧은 흐름:

1. 홈 Wi‑Fi에서 먼저 호스트와 홈 앨범을 설정합니다 (§4.1–4.2)
2. PC / NAS: Tailscale 설치 → 로그인 → 연결됨 → 그 컴퓨터의 Tailscale IPv4 (100.x) 복사
3. 전화: 설치 Tailscale → 같은 계정 → 연결됨
4. 집 앨범을 외출 중에 열기 → 메시지가 표시되면 Tailscale 열기 → PC 100.x 복사 → 앱으로 돌아가기 → 붙여넣기 → Tailscale IP 저장 후 재시도

일상: 앨범이 필요할 때 Tailscale을 엽니다. 앱을 나가거나 홈 화면으로 돌아가면 Wi‑Fi, 앱이 전력을 절약하기 위해 Tailscale 연결을 끊을지 묻습니다. 이미 LAN에 OpenVPN(또는 유사한 것)이 설치되어 있는 경우, 일반적으로 Tailscale이 필요하지 않습니다.

전체 안내, FAQ 및 노트: Tailscale guide.

IPv6 활성화 (선택 사항)

호스트 연결에서 활성화 IPv6(기본값은 꺼짐)을 전환할 수 있습니다:

• 꺼짐: 발견 및 연결은 IPv4 전용; IPv6 필드는 편집 시 숨겨짐; 저장된 IPv6는 유지됨
• 켜짐: 앱이 IPv6을 스캔/작성하고 연결 후보들 사이에서 사용할 수 있음
• 원격 액세스를 위해 §4.4에서 WebDAV / Tailscale를 사용하십시오

5. 사진 뷰어

전체 화면으로 보려면 로컬 또는 홈 갤러리에서 사진을 탭하세요. 다른 앱(Files, Downloads, Messages 등)에서도 Home Gallery로 열기가 가능합니다.

5.1 제스처

왼쪽 하단 모서리는 사진 날짜를 표시합니다: EXIF DateTimeOriginal / Digitized가 존재하면 날짜 + 시간을 표시하고, 그렇지 않으면 수정된 날짜 / 생성된 날짜 중 더 이른 날짜를 사용하여 날짜만 표시합니다 (일반 DateTime 태그는 무시되므로 나중 파일 시간이 잘못 사용되지 않습니다). 전체 화면 또는 슬라이드쇼에서는 숨겨집니다.

5.2 상단 도구 모음

현재 형식을 편집할 수 없는 경우, 편집 버튼은 표시되지 않습니다.

5.3 측면 / 하단 작업

화살표를 눌러 작업 행을 확장하세요(자동 축소 모드에서), 또는 설정에서 항상 표시로 설정할 수 있습니다.

세로: 아래쪽에 동작. 가로: 오른쪽에 동작.

5.4 Pro속성

속성 대화 상자가 표시됩니다:

• 파일 정보: 이름, 경로, 크기, 유형, 생성 날짜, 수정 시간
• EXIF (존재할 경우): 해상도, 캡처 설정, GPS 등

EXIF 없는 사진도 파일 정보가 표시됩니다; 생성 날짜는 항상 표시됩니다.

5.5 복사 / 이동

1. 복사 또는 이동을 누르세요
2. 폴더 브라우저(전체 화면 그리드)에서 목적지를 선택하세요
3. 빈 폴더는 기본적으로 숨김 상태입니다; 아직 파일이 없는 폴더를 선택하려면 빈 폴더 표시를 켜세요
4. 같은 행에는 새 폴더와 확인이 있습니다
5. 새 폴더 생성 후에는 목적지가 되며(비어 있어도 표시됨) 즉시 확인할 수 있습니다
6. 목적지에 이미 같은 이름이 있는 경우:
7. 덮어쓰기: 새 파일로 교체
8. 둘 다 유지: 원본을 유지; 새 파일에는 번호(photo (1).jpg)가 부여됩니다
9. 취소: 중단

로컬 다중 선택: 이동은 사진과 동영상에서 작동합니다; 선택에 동영상이 포함되면 복사 숨김(동영상 복사는 아직 구현되지 않음).

5.6 이미지 형식 및 제한

이 앱은 파일을 보기 또는 편집할 수 있는지 결정하기 위해 확장자와 MIME 유형을 사용합니다. 이 표는 로컬 갤러리와 홈 앨범에 적용됩니다(홈 저장소의 다른 파일은 일반 파일로 표시되며 뷰어에서 열 수 없습니다).

볼 수 있는 사진 형식

.jpg, .jpeg, .png, .gif, .webp, .bmp, .heic, .heif, .svg, .svgz

편집 가능한 사진 형식

뷰어에서 편집으로 들어갈 수 있는 형식은 다음과 같으며, 저장 후에도 동일한 형식을 유지합니다:

다른 보기 가능한 형식(.gif, .bmp, .heic, .heif, .svg, .svgz 등)에는 편집 버튼이 없으므로, 저장해도 형식을 변경하거나 파일을 손상시킬 수 없습니다.

SVG / SVGZ

기타 형식 참고 사항

비디오 형식

이 앱은 로컬 갤러리와 홈 앨범 모두에서 이러한 비디오 확장자를 인식합니다. 재생 세부 사항은 §5.7에 나와 있습니다.

.3gp, .avi, .flv, .m2ts, .m4v, .mkv, .mov, .mpeg, .mpg, .mp4, .qt, .rm, .rmvb, .swf, .ts, .vob, .webm, .wmv

설정 → 미디어 목록 필터에서는 참고용으로 이러한 비디오 확장자들도 나열됩니다.

5.7 동영상 재생

로컬 및 홈 앨범 비디오는 앱에서 스트리밍할 수 있습니다(홈 파일은 먼저 전체 다운로드할 필요가 없습니다). 슬라이드쇼는 §5.8입니다.

인식된 비디오 확장자

.3gp, .avi, .flv, .m2ts, .m4v, .mkv, .mov, .mpeg, .mpg, .mp4, .qt, .rm, .rmvb, .swf, .ts, .vob, .webm, .wmv

목록에 있다는 것은 앱이 파일을 비디오로 연다는 것을 의미합니다. 이것이 디코딩을 보장하는 것은 아니며; 이는 여전히 내부 코덱과 장치에 달려 있습니다.

전화 통화 중

코덱 제한: 동일한 확장자가 다른 코덱을 숨길 수 있습니다. 두 엔진이 모두 실패하면 오디오만 나오거나, 검은 화면이 표시되거나, 재생이 되지 않을 수 있습니다.

형식 요약

Cast 비디오를 TV에

로컬 또는 홈 앨범에서 비디오를 Cast하는 것은 Basic입니다 (사진 캐스트는 §5.9). 전화기와 TV는 동일한 LAN에 있어야 합니다. 일부 확장 기능(예: .avi, .wmv)은 Cast 버튼을 숨깁니다.

“이 비디오의 비트레이트가 너무 높습니다”라는 메시지는 트랜스코딩이 필요하지만 홈 파일이 다운로드되지 않았거나 트랜스코드 캐시가 없는 경우에만 나타납니다. 이로 인해 H.264가 차단되는 것은 아니라는 것이 확인되었습니다. 휴대폰에서 재생한 후, 로컬 파일이나 캐시가 존재하면 다시 캐스트를 시도하세요.

5.8 슬라이드쇼

로컬 또는 홈 갤러리에서 사진을 전화 화면에 자동 재생합니다. Basic 및 Pro에서 사용 가능합니다. Pro는 슬라이드쇼를 TV로 전송할 수도 있습니다(§5.9 참조). 비디오의 경우 비디오 플레이어를 사용하세요(§5.7).

시작하는 방법

선택한 항목에 사진이 없는 경우(예: 동영상만 있는 경우), '사진을 최소 하나 이상 선택하세요'라는 메시지가 표시되며 슬라이드쇼가 시작되지 않습니다.

재생

연주 중 제스처

일시 정지 후

시스템 뒤로가기: 슬라이드쇼가 실행 중일 경우, 첫 번째 누름은 슬라이드쇼를 종료하고; 두 번째 누름은 (현재 화면에 따라) 뷰어를 종료합니다.

5.9 Cast 사진을 TV로

Pro는 로컬 또는 홈 앨범 사진을 Google Cast TV / Chromecast로 전송할 수 있습니다. Basic는 여전히 사진 뷰어에 Cast 아이콘을 표시하며, 이를 탭하면 업그레이드 안내가 나타납니다.

전화기와 TV는 같은 LAN에 연결되어 있어야 합니다. 처음 사용할 때 지역 네트워크 권한을 허용하세요.

6. 사진 편집기

뷰어에서 편집을 탭하세요 (.jpg, .jpeg, .png, .webp만 이 버튼이 표시, §5.6 참고).

편집은 초안입니다. 두 개의 층이 있습니다:

1. 도구 안에서 아래쪽(세로) 또는 오른쪽(가로)을 조정합니다; ✓를 눌러 해당 단계를 작업 미리보기에 적용하거나, X를 눌러 단계를 취소하고 도구 선택기로 돌아갑니다.
2. 다시 도구 선택기로 돌아가서, 상단의 저장은 적용된 모든 단계를 파일에 기록합니다.

화면 방향: 세로 / 조정 / 자르기 모드로 들어가면 미리보기 공간을 위해 상단 제목 표시줄이 숨겨집니다; 시스템 뒤로 가기 버튼이나 툴바의 X를 누르면 해당 도구에서 나갑니다.

6.1 도구

세 가지 도구가 하단(세로) 또는 오른쪽(가로)에 나타납니다:

6.2 자르기

어두운 패널; 아이콘 행에서 항목을 선택하세요:

• 기울기: −15° ~ +15°, 눈금을 드래그; 초기화를 누르면 0으로 돌아갑니다
• 자동: 제안된 기울기는 자동을 탭할 때만 계산됩니다 (자르기를 입력할 때는 아님)
• 뒤집기 / 회전: 하단 확인 행 중간에 위치; 작업 중인 이미지에 즉시 적용됩니다 (이 자르기 단계를 확정하려면 나중에 ✓가 여전히 필요합니다)
• 자르기 상자를 드래그하여 이동; 모서리를 드래그하여 크기 조절. 3등분 가이드선은 드래그하는 동안에만 나타납니다
• 단계 적용하려면 ✓을(를) 탭하세요

6.3 조정

어두운 패널; 확인 행의 가운데가 네 가지 항목으로 전환됩니다:

• 오른쪽의 재설정은 현재 항목을 재설정합니다
• 회전/뒤집기에는 자르기(Crop)를 사용하세요
• 단계 적용하려면 ✓을(를) 탭하세요

6.4 초상화

어두운 패널; 도구를 사용하면 얼굴을 감지합니다(‘다시 감지’할 수 있음). 확인 행이 전환됩니다: 부드럽게, 밝기, 대비, 채도.

얼굴을 찾을 수 없을 때:

• 매끄러운 강도는 0%이며 제안이 표시되지 않습니다
• 원형 영역이 나타납니다: 한 손가락으로 드래그하여 이동하고, 슬라이더로 크기를 조정한 후 부드럽게 올리세요

얼굴이 발견되었을 때:

• 제안된 스무스는 가장 큰 얼굴이 프레임에서 차지하는 비율을 사용합니다 (가까운 샷은 더 높게, 그룹/멀리 있는 샷은 더 낮게) 그리고 '제안된 N%'를 표시합니다
• 얼굴 윤곽이 그려져 있습니다

단계를 적용하려면 ✓를 탭하세요.

6.5 저장 및 취소

편집기 미리보기(도구 선택기, 세로 모드, 조정)는 핀치 줌 및 더블 탭 줌(약 1×–3×)을 지원한 후 이동할 수 있습니다; 자르기는 미리보기를 확대하지 않으므로 제스처가 자르기 박스와 함께 유지됩니다.

7. 즐겨찾기

7.1 즐겨찾기 추가

로컬 또는 홈 앨범에서 도구 모음의 북마크 아이콘을 탭합니다. 하단에 ‘북마크됨’ 힌트가 표시됩니다.

동영상을 재생하는 동안 별표를 눌러 동영상 북마크(재개 위치 포함)를 추가하세요.

7.2 즐겨찾기 사용

1. 하단 바에서 북마크를 탭하세요 (패널을 전환하려면 해당 탭을 다시 탭하세요)
2. 패널에서 열 수 있습니다:
3. 폴더 즐겨찾기: 해당 폴더로 이동
4. 비디오 북마크: 플레이어를 열고 재개를 시도하세요

7.3 즐겨찾기 제거

북마크 패널에서 항목을 길게 누르기 → 확인 (폴더와 비디오 북마크도 동일하게 작동).

8. 홈 앨범에 업로드하기

1. 로컬 갤러리에서 다중 선택을 입력하고 사진 / 비디오를 선택하세요
2. 하단의 업로드 아이콘을 탭하세요
3. 홈 앨범(이름만)과 선택적 하위 폴더를 선택하세요(개인 백업 영역은 선택할 수 없습니다)
4. 확인

Pro그레스

• 진행 상황(N / M), 파일 이름, 바이트 막대를 보여줌
• 중지는 남은 파일을 취소합니다; 완료된 파일은 유지됩니다; 결과에는 성공 / 일부 성공 / 취소가 구분됩니다

같은 이름

• 목적지에 이미 동일한 이름이 있는 경우, 업로드는 name (1).ext, name (2).ext, …로 이름이 바뀌며, 덮어쓰지 않습니다

성공적으로 업로드한 후 로컬 삭제

• 모든 항목이 성공적으로 업로드되고 휴지통이 활성화된 경우에만, 앱이 로컬 사본을 휴지통으로 이동할지 묻습니다
• 휴지통으로 이동 또는 장치에 유지를 선택하세요; 휴지통 끄기는 성공 메시지만 표시합니다
• 앨범 백업은 이 기능을 제공하지 않습니다; 휴지통으로 이동한 후에도 해당 파일이 이미 앨범 백업에 있었다면 원격 백업 사본은 여전히 유지됩니다

9. 설정

더보기 → 설정을 엽니다.

9.1 호스트 연결

• 저장된 SMB 호스트 보기, 편집 또는 삭제
• 호스트 연결 관리에서 호스트 추가 (LAN 스캔 또는 수동 주소)
• 연결 노트는 온라인 WebDAV / Tailscale 원격 설정 페이지를 엽니다; 동일한 페이지에서 IPv6 활성화를 전환할 수 있습니다(기본적으로 비활성화, §4.1 / §4.4 참고)
• 설정 홈 화면은 호스트 SMB 추가를 반복하지 않습니다; 관리 페이지를 사용하세요

9.2 홈 앨범 (설정 블록)

• 설정된 홈 앨범 수를 보여줌
• 사진 캐스트 (Pro): 로컬/홈 사진을 TV로 캐스트합니다. Basic 스위치를 탭하면 업그레이드가 안내됩니다; Pro는 잠금 해제되어 있습니다 (뷰어 Cast 버튼 사용). 홈 비디오 스트리밍은 Basic이며 더 이상 설정 스위치가 필요하지 않습니다
• 세로 H.264 직접 전송: 비디오 Cast 호환 옵션(Basic); TV 화면이 회전된 경우에만 끄세요
• 홈 탭에서 앨범 추가/제거 (선택기/관리 화면)

9.3 로컬 갤러리 폴더

• 폴더 포함: 어떤 루트를 표시할지 (기본값 DCIM, Pictures)
• 폴더 제외: 특정 하위 폴더 건너뛰기

Basic 대 Pro (병렬 폴더)

Basic와 Pro은 설정에서 Documents와 같은 병렬 경로를 허용할 수 있습니다; 그 권한이 없으면 복원은 Pictures/…로 매핑될 수 있습니다(§9.7 참조).

참고 (안드로이드 플랫폼 제한): Android 11에서 시스템은 폴더 선택기로 전체 Download 루트를 승인하는 것을 허용하지 않습니다—“이 폴더 사용” 버튼이 회색으로 표시됩니다. 이는 앱 버그가 아닙니다. Documents(또는 유사한 항목)을 승인하거나, Download 아래에 하위 폴더를 만들고 해당 하위 폴더를 승인하세요.

두 보조금을 혼동하지 마세요

9.4 디스플레이

9.5 캐시

캐시 크기를 확인하고 캐시 지우기 (네트워크 썸네일, 이미지 디스크 캐시, 네트워크 비디오 스트림 캐시, 메모리 캐시). 원본은 손대지 않습니다; 다음 홈-앨범 탐색 시 캐시를 다운로드하거나 재구성해야 합니다.

9.6 미디어 목록 필터

로컬 및 홈 앨범 목록에서 폴더 이름, 파일 이름 또는 확장자를 숨깁니다. 내장된 사진/비디오 확장자 규칙은 읽기 전용 참조입니다.

설정은 다음과 같이 그룹화됩니다: 로컬 갤러리, 미디어 필터, 호스트 연결, 홈 앨범(네트워크 비디오 스트리밍 포함), 앨범 백업, 캐시, 문제 보고 / 진단 내보내기 등.

9.7 앨범 백업

앨범 백업은 로컬 갤러리에서 홈 저장소의 개인 영역(.HomeGallery/backup/{device}/)으로 한 방향으로 업로드되므로 전화기 실패 후 복원할 수 있습니다.

각 장치는 자체 폴더(모델, 선택적 표시 이름, 마지막 백업 시간)에 device_info.json을 저장합니다. 여러 사람이 동일한 백업 앵커를 공유할 때는 앨범 백업 설정에서 로컬 백업 ID → 표시 이름을 설정하세요; “기존 백업 연결” 목록에는 android_xxxx만 표시되는 대신 해당 이름/모델이 나타납니다.

만약 다른 공유로 전환하거나, 호스트를 변경하거나, 백업 앵커 폴더를 변경하면, 로컬 추적이 다시 시작됩니다: 동기화됨 / 실패 / 백업 전용 개수가 초기화됩니다. 보류 중인 백업 확인을 눌러 다시 스캔하세요 (새 대상에 이미 이 장치의 백업이 있는 경우, 항목이 전체 재업로드 없이 동기화된 것으로 맞춰질 수 있습니다).

Basic '공용 폴더에 업로드'와 달리, 백업 존은 앱에서 관리하며 기본적으로 일반 네트워크 탐색에서는 숨겨져 있고, 기본적으로 로컬 사본을 유지합니다.

백업 영역 탐색(큰 폴더 격자)

1. 더 보기 → 앨범 백업 → 백업 영역 탐색
2. 홈 앨범 폴더 모드(대형 그리드)에서 개인 백업 루트를 열고, 필요에 따라 폴더를 탐색합니다
3. 백업 전용 항목은 빨간 테두리가 있습니다. 길게 눌러 선택한 후 백업 구역에서 제거하고 추적도 삭제할 수 있습니다.
4. 백업 디스크에 존재하지만 로컬 인덱스 행이 없는 파일은 추적되지 않음으로 표시됩니다(보통 수동으로 복사되었거나 인덱스 재설정 후); Backup-only로 표시되기 전에 스캔/원격 인덱스를 실행하세요
5. 목록 스타일 복원 / 필터는 여전히 아래의 보기 백업 / 복원을 사용합니다

복원 (R1.1)

1. 더 보기 → 앨범 백업 (또는 설정의 앨범 백업) → 백업 / 복원 보기
2. 기본 필터 기기에서 누락됨 (이전에 백업되었지만, 로컬에서는 사라짐; 휴지통의 항목이 아니며, 이 앱에서 영구 삭제된 항목도 아님)
3. 모든 누락 복원을 탭하거나, 여러 항목을 선택한 후 선택 항목 복원 → 확인(파일 수, 크기, 경로 매핑 수) → 복원

(오래된 전화기를 연결한 후의 아이템은 보통 “백업 전용”이며; 기기에서 누락된 필터는 대기 중인 파일도 표시합니다)

1. 복원된 파일이 로컬 갤러리에 나타납니다

병렬 폴더 복원 경로(중요)

백업에 Documents/…:과 같은 병렬 경로가 포함되어 있는 경우

Basic와 Pro 모두 병렬 폴더를 승인할 수 있습니다(설정 → 로컬 갤러리 폴더 참조).

확인 대화 상자가 경로 매핑을 표시하면 일부 파일은 Pictures 아래에 저장됩니다. 장치 간 복원(R2)도 동일한 규칙을 사용합니다.

새 전화기 (R2) (기존 백업 연결 / 전체 복원 라이브러리; Basic 및 Pro)

1. 더보기 → 앨범 백업 → 백업 보기 / 복원
2. 기존 백업 연결을 탭 → 이전 전화기의 backup/{deviceId}/를 NAS에서 선택 (복원 소스만)
3. 인덱싱 후, 이 전화에 없는 파일에 대해 백업 전용 필터를 사용하세요
4. 다중 선택 또는 누락된 모든 항목 복원 (같은 병행 폴더 규칙: SAF 없이 Pictures/…으로 이동)
5. 이 전화기의 나중 백업은 여전히 자신의 폴더에 기록됩니다; 이전 전화기는 별도로 백업을 계속할 수 있습니다

앱 저장 공간을 지운 후(같은 전화기)

1. 백업 후, 먼저 설정 내보내기 (이것은 백업 deviceId도 기억합니다)
2. 앱 저장 공간을 지우기(또는 재설치) → 권한 다시 부여 → 가능한 한 빨리 설정 복원 (먼저 앨범 백업을 활성화하지 마세요, 그렇지 않으면 새로운 기기 아이덴티티가 생성될 수 있습니다)
3. 앨범 백업 열기 → 보류 중인 백업 확인: 앱이 홈 백업 존에 연결하고 NAS과 여전히 일치하는 로컬 파일을 동기화된 것으로 표시합니다—전체 재업로드 없음
4. 이미 다른 ID를 가진 다른 전화기에서 설정을 복원하면: 기록된 ID는 유지되며, 가져온 이전 deviceId는 연결된 복원 소스로 처리됩니다(색인/복원하려면 “기존 백업 연결” 사용).
5. 내보내기가 오래된 경우(deviceId이 없음), 백업 후 다시 내보내거나 "기존 백업 연결"로 오래된 폴더를 선택하세요

9.8 내보내기 및 설정 복원

이전 리팩터링 전의 오래된 (SambaProfile) 테스트 빌드를 사용한 경우, 앱 데이터를 지우거나 재설치한 후, 호스트와 홈 앨범을 다시 설정하세요. 이전 형식의 설정 파일은 가져오지 마세요.

9.9 문제 및 진단 보고

10. 자주 묻는 질문

Q1: 로컬 사진이 없나요?

• 사진 및 동영상 접근 권한이 허용되었는지 확인
• 설정 → 로컬 갤러리 폴더: 폴더가 포함된 폴더에 있는지 확인하세요

Q2: 집 저장소에 연결할 수 없나요?

• 전화기와 NAS / PC는 동일한 집 Wi‑Fi / LAN에 있어야 합니다
• 설정 → 호스트 연결: 주소, 계정, 비밀번호 확인
• NAS / PC(포트 445)에서 SMB가 활성화되어 있는지 확인
• 스캔에서 아무것도 발견되지 않으면: Wi‑Fi을 켜고 스토리지와 같은 LAN에 머문 후 다시 스캔하세요
• 멀리 있을 때 연결할 수 없음:
• NAS: 원격 액세스는 WebDAV 이어야 하며, 올바른 DDNS / 포트 → WebDAV guide
• Windows / 없음 WebDAV: Tailscale guide을(를) 참조하세요
• 기타 경우: Troubleshooting §E

Q3: 로컬 사진을 삭제하거나 편집할 때 시스템 권한 요청이 나타나나요?

Android 11+에서, 다른 앱에서 생성된 일부 미디어는 수정/삭제하려면 추가 권한이 필요합니다. 시스템 대화상자에서 허용하세요.

Q4: 초상화 / 매끈한 모습이 약해 보이나요?

• 얼굴이 감지되었는지 확인하거나, 원을 끌어다 놓고 슬라이더로 크기를 조절하세요
• 스무스 올리기
• 적용 (✓) 후 저장

Q5: 편집 후 품질이 떨어지나요?

인물 미리보기는 속도를 위해 낮은 해상도를 사용합니다; 저장은 원래 해상도로 처리합니다. 여전히 효과가 너무 강하면, 부드러움(Smooth)을 낮추세요.

Q6: 홈 앨범으로 복사/업로드가 느린가요?

속도는 네트워크 대역폭과 파일 크기에 따라 달라집니다. 안정적인 Wi‑Fi 연결을 사용하세요.

Q7: 왜 SVG는 볼 수 있지만 편집할 수 없는가?

SVG는 벡터입니다. 이 앱은 벡터를 편집하고 SVG로 저장할 수 없고, 래스터화된 비트맵만 볼 수 있으므로 편집은 숨겨져 있습니다. §5.6을 참조하세요.

Q8: GIF / HEIC에 편집 버튼이 없는 이유는 무엇인가요?

이 형식들은 볼 수는 있지만, 편집된 저장본은 원래 형식(GIF 애니메이션, HEIC 인코딩)을 유지할 수 없습니다. 손상을 방지하기 위해, 편집은 .jpg, .jpeg, .png, .webp에만 해당됩니다.

Q9: 로컬 갤러리에서 SVG 파일이 누락되었나요?

Android MediaStore가 이를 인덱싱했는지 확인하세요 (Download초가 일반적인 경우입니다). 시스템이 SVG를 미디어로 등록하지 않았다면, 이 앱은 이를 목록에 표시할 수 없습니다.

Q10: 영상이 목록에 있지만 재생되지 않나요?

• 확장이 §5.7에 있는지 확인하십시오
• 휴대폰에서: 앱이 내장 엔진(Media3 또는 호환성 엔진)을 시도합니다. 실패하면 다른 앱으로 엽니다. 동일한 파일을 다른 플레이어에서 테스트할 수도 있습니다.
• 네트워크 비디오: 네트워크를 확인하세요; 필요하면 설정에서 캐시를 지우고 다시 시도하세요

11. 권한

12. Basic 그리고 Pro

Home Gallery는 Basic와 Pro를 제공합니다. Basic는 광고가 없으며 이미 전체 사진/비디오 관리 기능을 포함하고 있습니다(로컬 및 홈 앨범, 타임라인, 홈 비디오 스트리밍, 휴지통, 병렬 폴더, 수동 앨범 백업 및 제외 폴더, 이전 전화 복원/연결 등). 추가 공간은 클라우드 할당량이 아닌 홈 스토리지에서 제공합니다. Pro는 선택적 일회성 구매로, 추가로 자동 앨범 백업(Wi‑Fi에서 백그라운드 업로드) 및 TV로의 사진 캐스팅 기능을 해제합니다.

Pro덕션 빌드는 인앱 구매를 통해 Pro를 잠금 해제합니다; 디버그 빌드는 테스트를 위해 설정에서 관련 기능을 전환할 수 있습니다.

12.1 Basic — 무료

12.2 Pro — 일회성 구매

Basic의 모든 것 위에:

12.3 관련 설정 스위치

성공적인 Pro 구매/복원 후, 한 번만 “당신은 Pro에 있습니다” 대화 상자가 나타납니다; 이후 실행 시(프로세스가 종료된 후를 포함) 다시는 나타나지 않습니다.

휴지통 옵션 (설정 → 로컬 갤러리 → 휴지통 옵션): 기본 삭제는 휴지통으로 이동 또는 영구 삭제; 휴지통 비우기 전에 확인; 만료 알림 (시스템이 약 하루 후 영구 삭제할 항목에 대한 일일 알림; Android 13+는 알림 권한 필요).

• 기본값 = 휴지통으로 이동: 로컬 갤러리/뷰어에서 삭제하면 휴지통으로 이동(복원 가능).
• 기본값 = 영구 삭제: 확인 후, 로컬 갤러리/뷰어에서 삭제하면 실제로 삭제되며, 그 삭제로 인해 휴지통에 들어가지 않아야 합니다. 휴지통에는 여전히 다른 이유로 항목이 표시될 수 있습니다:
• 완전히 성공적으로 업로드한 후, 로컬 사본을 휴지통으로 이동하도록 선택했습니다(기본 삭제 설정과 무관하게)
• 사진 편집은 덮어쓰기 전에 휴지통에 편집 전 백업을 보관합니다
• 다른 앱 / 시스템 갤러리가 항목을 공유 MediaStore 휴지통으로 이동했습니다
• 휴지통이 꺼져 있으면, 로컬 삭제는 항상 영구적입니다; 업로드가 성공해도 복사본을 휴지통으로 옮길지 묻지 않습니다.

12.4 업그레이드 방법

1. 더보기 → 설정 → Pro로 업그레이드 (또는 자동 백업, 사진 캐스트 등 시도할 때 나타나는 업그레이드 안내)
2. Google Play 일회성 구매를 완료하세요
3. 새 전화기나 재설치 후에는 설정에서 구매 복원을 사용하세요

12.5 Pro 자주 묻는 질문

Q: Basic가 편집, 삭제 및 업로드를 할 수 있나요?

네. Basic는 단순 보기용 앱이 아니라 완전한 사진 관리 프로그램입니다.

Q: 로컬 또는 홈 비디오에 Pro가 필요합니까?

아니요. 로컬 및 홈 비디오 재생은 Basic입니다. Pro은 자동 앨범 백업과 포토 캐스트를 잠금 해제합니다.

질문: 사진을 TV로 캐스팅하려면 Pro가 필요합니까?

네. Basic는 휴대폰에서 슬라이드쇼를 재생할 수 있습니다; TV 캐스트는 Pro가 필요합니다. 비디오 Cast는 Basic로 남아 있습니다.

Q: 비디오 캐스트에서 '비트레이트가 너무 높음'이라고 나오는 이유는 무엇인가요?

트랜스코드가 필요하지만 로컬 파일이나 트랜스코드 캐시가 아직 없는 경우에만. 일반적인 휴대폰 H.264는 직접 전송되며 비트레이트에 의해 차단되지 않습니다. HEVC 및 기타 TV 호환되지 않는 코덱은 먼저 준비됩니다. §5.7을 참조하십시오.

질문: 업로드는 백업과 어떻게 다른가요?

업로드는 파일과 홈 앨범 폴더(Basic 및 Pro)를 선택하는 것입니다. 휴지통이 켜져 있는 경우, 완전히 성공한 업로드는 공간을 절약하기 위해 로컬 사본을 휴지통으로 이동할 수 있습니다. 백업은 로컬 갤러리를 앱 관리 개인 백업 영역에 단방향으로 기록하고 기본적으로 로컬 사본을 유지합니다; 필요할 때 앱에서 복원할 수 있습니다.

Q: 앨범 백업은 Basic과 Pro에서 어떻게 다릅니까?

Basic은 수동 백업, 폴더 제외, 그리고 구형 전화 복원 / 연결을 지원합니다. Pro은 추가로 Wi‑Fi에서 자동 백그라운드 백업을 활성화할 수 있습니다.

Q: 백업은 양방향인가요?

아니요. 백업은 폰 → NAS입니다. NAS에서 백업 파일을 편집해도 폰에 다시 기록되지 않습니다. 복원은 앱에서 의도적으로 수행하는 동작입니다.

Q: Office Lens 파일은 Documents에 있습니다. Basic이 그것들을 볼 수 있나요?

예. Basic와 Pro은 설정 → 로컬 갤러리에서 Documents와 같은 병렬 폴더를 선택하고 승인할 수 있습니다.

Q: 복원할 때, Documents 및 다른 병렬 폴더들은 어디로 가나요?

그 폴더에 대해 SAF 없이: Pictures/ 아래의 매핑된 경로 (Documents/…로 돌아가지 않음). 해당 병렬 폴더가 허용된 경우: 원래의 상대 경로. 복원 확인 대화상자에는 매핑된 경로 수가 표시됩니다. §9.7을 참조하세요.

Q: Download 권한을 허용할 때 '이 폴더 사용'이 회색으로 표시되는 이유는 무엇인가요?

이것은 Android 11+ 시스템 제한입니다. 앱은 Download 루트에 대한 트리 권한을 얻을 수 없습니다. Documents를 선택하거나 Download 아래의 하위 폴더를 승인하세요. 앱은 “읽기 전용으로 Download 포함” 경로를 제공하지 않습니다(복사/복원 쓰기와 충돌하고 더 불편하기 때문입니다).

13. 버전 정보

더보기 → 정보 (또는 더보기 → 설정 → 정보)에서 다음을 볼 수 있습니다:

• 버전 (현재 1.2.5; 앱의 정보를 신뢰하세요)
• 제작일
• 사용자 안내서 (이 온라인 매뉴얼: https://jasoncschang-stack.github.io/homegallery-privacy/help/)
• 문제 신고
• 저작권

설정 → 지원을 선택하면 동일한 안내가 열립니다.

이 공개 가이드는 앱 1.2.5과 매뉴얼 1.50에 맞습니다.