Quick Start
This guide covers the essential features to get you started with Media Viewer in five minutes.
First-Time Setup
On first run, you'll need to create a password:
- Navigate to your Media Viewer URL (e.g.,
http://localhost:8080) - You'll be redirected to the setup page
- Enter a secure password (minimum 6 characters)
- Click Create Password
- You'll be automatically logged in
Logging In
For subsequent visits:
- Navigate to your Media Viewer URL
- Enter your password
- Click Login or press ++enter++
Browsing Your Library
After logging in, you'll see the main gallery view displaying your media files and folders.
Navigation
- Click a folder to open it
- Use the breadcrumb at the top to navigate back to parent folders
- Click the home icon to return to the root directory
Sorting and Filtering
Use the controls at the top of the gallery:
- Sort by: Name, Date, Size, or Type
- Sort order: Click the arrow icon to toggle ascending/descending
- Filter: Show All, Images only, Videos only, or Playlists only
Viewing Media
Images
Click any image thumbnail to open it in the lightbox viewer. From the lightbox:
- Use arrow keys or swipe to navigate between images
- Press ++escape++ to close
- Click the star icon to add to favorites
- Click the tag icon to manage tags
Videos
Click a video thumbnail to open it in the lightbox. Video controls appear on hover.
Using Favorites
Favorites provide quick access to frequently viewed items.
Adding Favorites
- Double-tap (mobile) or double-click (desktop) any item
- Or click the star icon on the item thumbnail
- Or open the item and click the star icon in the lightbox
Viewing Favorites
Favorites appear in a horizontal strip at the top of the gallery when you have items marked as favorites.
You can drag favorites to reorder them, and favorites from other folders remain available there for quick access.
Collections
Collections let you create ordered groups of images and videos without changing your folder structure.
Creating a Collection
- Click the collections button on an item
- Create a new collection or add the item to a recent one
- Open Collections from the header to browse or manage saved groups
Basic Tagging
Tags help organize your media into categories.
Adding Tags
- Click the tag icon on any item thumbnail
- Type a tag name in the input field
- Press ++enter++ or click Add
- Repeat for additional tags
Searching by Tag
- Click any tag to search for all items with that tag
- Or type
tag:tagnamein the search box
If your files already contain standard EXIF/XMP keywords, Media Viewer can also import those tags automatically during indexing.
Search
Use the search box at the top to find media:
- By name: Type any part of the filename
- By tag: Click any tag chip or use the search box
- By type: Use the filter dropdown
The search provides suggestions as you type. Press ++enter++ to see full search results.
Mobile Usage
Media Viewer is fully responsive and works on mobile devices.
Installing as an App
On supported devices, you can install Media Viewer as a Progressive Web App:
Android (Chrome, Edge, Samsung Internet):
- Open Media Viewer in your mobile browser
- Tap the three-dot menu (⋮)
- Tap "Add to Home Screen" or "Install App"
- Launch from your home screen for a full-screen experience
iOS (Safari):
- Open Media Viewer in Safari
- Tap the Share button (square with arrow)
- Tap "Add to Home Screen"
- Launch from your home screen for a full-screen experience
Touch Gestures
- Tap: Open item or folder
- Double-tap: Toggle favorite
- Long-press: Enter selection mode (bulk operations)
- Swipe: Navigate in lightbox
Next Steps
- Learn about Selection Mode for bulk operations
- Learn how to use Collections for ordered shortlists and albums
- Explore Tag Management for advanced organization
- Review Keyboard Shortcuts to speed up your workflow
- Set up Passkey Authentication for passwordless login