Browsing Media
Media Viewer provides an intuitive interface for navigating and viewing your media library.
Gallery View
The gallery displays your media in a responsive grid layout. The number of columns adjusts based on your screen size.
Item Types
Items in the gallery are indicated by visual cues:
| Type | Indicator |
|---|---|
| Folder | Folder icon or folder thumbnail |
| Image | Image thumbnail |
| Video | Image thumbnail with play icon overlay |
| Playlist | List icon |
Item Information
On desktop, each item displays:
- Thumbnail or icon
- File name
- Type badge (folder, image, video, playlist)
- File size (for files) or item count (for folders)
- Tags (up to 3 visible, with +N indicator for more)
On mobile, items show a compact view with the name overlaid on the thumbnail.
Quick actions are revealed differently by input style:
- Desktop: hover exposes inline controls such as favorite, tag, download, and collect
- Touch: the gallery stays focused on tap, double-tap, and long-press; use selection mode for bulk actions and the lightbox for single-item tag or collection work
Navigation
Opening Items
- Folders: Click to enter the folder
- Images: Click to open in lightbox
- Videos: Click to open in lightbox
- Playlists: Click to open in playlist player
Folder Navigation
Use these methods to navigate between folders:
- Click folders in the gallery to enter them
- Click breadcrumb segments to jump to parent folders
- Press ++escape++ to go to the parent folder (when no overlay is open)
- Use browser back/forward buttons
Sorting
Control the display order using the sort controls:
Sort Fields:
- Name: Alphabetical order
- Date: By modification date
- Size: By file size
- Type: Grouped by file type
Sort Order:
Click the arrow icon to toggle between ascending and descending order.
Filtering
Use the filter dropdown to show specific media types:
- All: Show all items
- Images: Show only images
- Videos: Show only videos
- Playlists: Show only playlists
Lightbox
The lightbox provides a full-screen viewing experience for images and videos.
Opening the Lightbox
Click any image or video thumbnail to open it in the lightbox.
Lightbox Controls
| Control | Action |
|---|---|
| Left/Right arrows | Navigate to previous/next item |
| Close button (X) | Close lightbox |
| Star icon | Toggle favorite |
| Tag icon | Open tag manager |
| Play icon | Toggle video autoplay |
| Loop icon | Toggle video loop |
| Layers icon | Open collections drawer |
| Download icon | Download current file |
The lightbox groups these top-left actions into a single toolbar so favorites, tags, autoplay, loop, and collections stay aligned across desktop and mobile layouts.
The top-left toolbar in the lightbox. Left to right: favorite, tag, autoplay, loop, and collections.
Auto-Hide Interface
After 3 seconds of viewing, control buttons and interface elements automatically fade away for an unobstructed view. Tap or click anywhere on the image or video to show or hide them. On desktop, moving your mouse shows controls automatically. Navigation arrows remain visible based on your settings.
You can configure the clock to always stay visible (even when other controls fade) in Settings → Library → "Always Keep Clock Visible".
The Library tab lets you configure the clock style and default gallery sort order.
Navigation in Lightbox
- Keyboard: Use ++left++ and ++right++ arrow keys
- Mouse: Click the left/right edges of the screen
- Touch: Swipe left or right
Closing the Lightbox
- Press ++escape++
- Click the X button
- Click outside the media
Display Settings
Display preferences are stored per browser and persist across sessions.
Open Settings (⚙️ icon) and navigate to the Library tab.
Clock
| Setting | Options | Description |
|---|---|---|
| Show Clock | On / Off | Display the current time in the lightbox and playlist player |
| Time Format | 12-hour / 24-hour | Choose AM/PM or 24-hour format |
| Always Keep Clock Visible | On / Off | Keep the clock visible even when other controls fade out |
Default Sort Order
| Setting | Options | Description |
|---|---|---|
| Sort By | Name / Date Modified / Size | Default field used to sort gallery items |
| Sort Direction | Ascending / Descending | Default sort direction for the gallery |
The sort preference is applied when you open a folder for the first time; changing the sort in the gallery header overrides it for that session.
Infinite Scroll
The gallery uses infinite scroll to load content as you browse. As you scroll down, additional items load automatically. A loading indicator appears while new items are being fetched.
If infinite scroll is unavailable, pagination controls appear at the bottom of the gallery.
Resume Your Place
When you come back to a long folder, Media Viewer can offer a compact resume chip beside the scrubber so you can jump back near the same part of the gallery.
The resume chip stays lightweight and points back to your saved position on the scrubber.
Tap Resume previous position to return near where you left off, or dismiss the chip to clear the saved checkpoint for that folder. The prompt is saved per folder, expires automatically after a week, and disappears as soon as you open an item in the lightbox.
Mobile Considerations
Touch Gestures
- Tap: Open item
- Double-tap: Toggle favorite
- Long-press: Enter selection mode and reveal bulk Tag, Favorite, and Collect actions
- Swipe (in lightbox): Navigate between items
Landscape Mode
When viewing videos in landscape orientation, the interface adapts to maximize the viewing area. Controls appear on tap and auto-hide after a few seconds.
Installing as PWA
For the best mobile experience, install Media Viewer as a Progressive Web App:
- Open Media Viewer in Safari (iOS) or Chrome (Android)
- Tap the share button (iOS) or menu button (Android)
- Select "Add to Home Screen"
- Launch from your home screen
The PWA provides:
- Full-screen experience without browser chrome
- Faster loading
- Offline access to cached thumbnails