← Back to blog

Media Viewer: The Browser-Based Gallery You Never Knew You Needed

Sakarto's Media Viewer lets you browse images and videos in any folder with masonry layouts, auto-scroll, play-all, and custom queues. Read-only, 100% local, and zero installation.

Sakarto Media Viewer interface showing masonry layout with images and videos

Most file managers show you a folder’s contents as a list of filenames with tiny thumbnails. If you want to actually see your photos—to appreciate them, to compare them, to decide which ones to keep—you’re forced to open each one individually or use a dedicated photo app that you have to install and configure.

Media Viewer is different. It’s a pure browser-based gallery tool that turns any folder on your computer into a visual browsing experience—complete with masonry layouts, auto-scroll, global video playback, and a custom queue system for curating collections. And crucially: it’s read-only. It cannot delete, move, or rename a single file. It’s purely for viewing, browsing, and organizing visually.

If you’ve ever wanted to sit back and watch your vacation videos scroll by, or build a “Best of” collection without actually moving files, Media Viewer is the tool you didn’t know you needed.


What makes Media Viewer different from other Sakarto tools?

Sakarto’s toolkit includes duplicate finders, bulk delete, bulk move, and bulk rename. Those tools are for acting on files. Media Viewer is for looking at them. It serves a completely different purpose:

ToolPurposeRead-only?What it does
Find Duplicate Images & VideosAnalysis✅ YesScans for visually similar files using 7 algorithms
Bulk DeleteAction❌ NoPermanently removes selected files
Bulk MoveAction❌ NoMoves selected files to a subfolder
Bulk RenameAction❌ NoRenames multiple files with patterns
Media ViewerBrowsing & CurationYesDisplays and organizes files visually — no modifications allowed

The key insight: Media Viewer opens folders with mode: "read"—not "readwrite". The browser enforces this at the OS level. You can browse, compare, queue, and enjoy your media, but you cannot change a single byte of any file. This makes it safe for any folder, regardless of its importance.


How the Media Viewer works: a technical overview

Let’s walk through what happens when you open a folder with Media Viewer.

Step 1: Choose file types and select a folder

Before you select a folder, you can choose to include Images, Videos, or both. This filters the files that are loaded, reducing memory usage and focusing the view.

When you click 📂 Select Folder, the browser’s File System Access API reads the folder recursively. Only image files (jpg, png, gif, webp, bmp) and video files (mp4, webm, mov, mkv, avi) are collected based on your file type selections. Other file types are silently skipped.

Step 2: Cards render in batches of 50

Media Viewer doesn’t wait for all files to be collected before showing anything. Cards are built synchronously and appended to the DOM in batches of 50, yielding to the event loop between batches. This means cards appear immediately as each batch completes—you can start browsing before the scan finishes.

Step 3: Lazy-load with a 300px lookahead

No image or video content is decoded at load time. Each card uses an IntersectionObserver with a 300px root margin. When a card scrolls within 300px of the viewport, its src is set and the media begins decoding. This keeps memory usage low even for folders with thousands of files.

Step 4: Aspect ratio detection

Once each image or video loads, its natural dimensions are read. The card is assigned one of three aspect ratio classes—aspect-portrait, aspect-landscape, or aspect-square—which controls its max-height in masonry mode.

Step 5: Videos auto-play on hover

Video cards have preload="none" at load time to avoid network overhead. When your mouse enters a video card, it plays. When it leaves, it pauses. Videos are muted by default so multiple hover-plays don’t create noise. Each video loops.


Layout modes: Grid vs. Masonry

Media Viewer offers two distinct layout modes, each suited to a different browsing style.

Grid layout (default)

In grid mode, cards are displayed in a uniform grid with fixed-width columns and equal-height thumbnails (200px). Images crop to fill with object-fit: cover. This is the most predictable layout—no shifting as images load.

Best for: Quick browsing of large folders, scanning through many images rapidly, and when you want consistent card sizes regardless of image proportions.

Masonry layout

In masonry mode, a CSS column-count layout preserves each image’s natural aspect ratio. Portraits display tall, landscapes display wide, and squares display perfectly square. A spacing slider (0–20px) controls the column gap.

Best for: Appreciating photos as they were composed, creating a Pinterest-style gallery, and when you want to see full images without cropping.

Tip: Combine Masonry with Hide file info and a spacing of 4–8px for a clean, edge-to-edge gallery experience.


Video features: hover-play and play-all

Media Viewer handles videos with two complementary playback modes:

Hover-play (individual)

Move your mouse over any video card and it plays immediately. Move away and it pauses. Videos are muted by default and loop when they reach the end.

Play All (global)

Click ▶️ Play All in the toolbar to start every video on the page simultaneously. Launches are staggered by 30ms per video to avoid browser throttling. Click ⏸️ Pause All to stop them all. The toolbar button toggles between Play All and Pause All based on the current playback state.

Mute toggle

Click 🔇 Videos in the toolbar to toggle global mute on all video elements. This affects both hover-play and Play All modes.

Tip: For a self-running video slideshow, set auto-scroll speed to 1–2, enable Play All, then start auto-scroll and go fullscreen on the browser tab.


Auto-scroll: hands-free browsing

Auto-scroll drives the page downward at a constant speed so you can lean back and watch images and videos scroll past without touching keyboard or mouse.

ControlWhat it does
⬇️ Auto-scrollStarts smooth continuous downward scrolling
⏸️ Stop scrollStops auto-scroll (button toggles)
Speed slider1–10: 1 is slowest, 10 is fastest. Speed 3–4 works well for images; speed 1–2 for videos where you want to watch each clip.
Manual scroll pauseMouse wheel or trackpad input pauses auto-scroll immediately. It automatically resumes 1 second after you stop manually scrolling.
Stops at bottomWhen the page reaches within 10px of the bottom, auto-scroll stops automatically with a “Reached bottom” toast.
EscapePress Escape to stop auto-scroll and deselect all files

Tip: Auto-scroll + Hide file info + Masonry + Play All = a self-running media gallery that feels like a curated presentation.


Custom Queues: build named collections

Queues let you curate a named collection of files from the folder—like a playlist for images and videos. Each queue gets its own tab in the sidebar with its own independent layout, spacing, and auto-scroll controls.

How to use queues

  1. Select files by clicking cards (blue border).
  2. Click 📂 Add to Queue in the toolbar.
  3. A modal appears. If queues already exist, you can add to an existing one or create a new one.
  4. Type a descriptive name—e.g., Nature, Favourites, To Print—and click Create New Queue.
  5. The new queue tab appears in the sidebar. Click it to view only the files you added.

Managing queues

  • Remove a file: Click the on any card in the queue to remove that file.
  • Delete a queue: Click the button next to the queue name in the sidebar.
  • Clear a queue: Click Clear All in the queue’s toolbar.
  • Add more files: Select files from the main All Files tab and add them to any existing queue.

Important: Queues are session-only

Queues exist only while the browser tab is open. Reloading the page clears all queues. Use Download List while viewing a queue to export the filenames and paths before reloading.

Queues can hold the same file in multiple queues. Select a file and add it to one queue, then select it again and add it to another. Files can appear in as many queues as you like.


Compare side-by-side

Ctrl+Click (Cmd+Click on Mac) any 2 or more cards to add them to the compare list (purple border). Click ⚖️ Compare in the toolbar. A modal opens showing each file side-by-side with:

  • The file itself (image or video with native controls)
  • File name
  • Dimensions (if available)
  • File size
  • File type
  • Full file path

Use it when: You have two similar shots and want to decide which one is better before adding to a queue, or you want to compare a high-quality original against a lower-quality version.


Step-by-step: Using Media Viewer

Step 1: Choose your file types

On the welcome screen, check 🖼️ Images and/or 🎬 Videos. If you only want to watch videos, uncheck Images to reduce the number of cards loaded.

Step 2: Select a folder

Click 📂 Select Folder. A native folder picker opens (Chrome/Edge). Or drag and drop a folder directly onto the page. The folder is opened read-only—nothing in it can be modified.

Step 3: Choose a layout and browse

Use the 📊 Grid / 🧱 Masonry buttons above the results to switch layout. In Masonry mode, use the Spacing slider to adjust the gap (0–20px). Check Hide file info to show only the media for an immersive look.

Step 4: Play videos and auto-scroll

Hover over any video card to play it. Click ▶️ Play All to launch every video at once. Click ⬇️ Auto-scroll and set a comfortable speed—then sit back and let the gallery scroll automatically.

Step 5: Preview full-size

Click the 🔍 or ▶️ icon on any card to open a full-size modal. Images scale to fit the screen. Videos open with native controls including fullscreen.

Step 6: Compare files side-by-side

Ctrl+Click two or more cards, then click ⚖️ Compare in the toolbar. A modal opens showing each file side-by-side with metadata.

Step 7: Create a custom queue

Select files you want to group, click 📂 Add to Queue, give the collection a name, and click Create. The new tab appears in the sidebar.


Privacy: your files never leave your device

Media Viewer is one of the most privacy-safe tools in Sakarto’s toolkit:

  • Opened in read-only mode. The File System Access API call uses mode: "read". The browser enforces this at the OS level—write operations are not possible.
  • Zero network activity after page load. All images and videos are decoded locally. No data leaves your device at any point.
  • Folder access is scoped and session-only. Permission covers only the folder you selected, lasts only while the tab is open, and is revocable from browser site settings.
  • No preferences are persisted. Media Viewer saves nothing to localStorage. Every session starts fresh with default settings.

Frequently asked questions (Media Viewer specific)

“Can this tool delete, move, or rename my files?”

No. Media Viewer opens folders with mode: "read"—a read-only permission that the browser enforces at the OS level. No write operation of any kind is possible. For file operations, use Bulk Delete, Bulk Move, or Bulk Rename.

”My images look cropped in grid mode. Can I see them uncropped?”

Yes—switch to Masonry layout. In grid mode, images are cropped to a fixed height using object-fit: cover. Masonry mode preserves natural proportions. You can also click the 🔍 icon to see any image at full size in a modal.

”Auto-scroll stops and starts on its own. Is that a bug?”

No—that’s the manual-scroll detection working as designed. When the tool detects wheel or trackpad input, it pauses auto-scroll for 1 second to let you look at something, then resumes. To stop auto-scroll permanently, click the ⏸️ Stop scroll button or press Escape.

”Some videos won’t play even after clicking Play All.”

Browsers impose limits on the number of simultaneously active media elements. If you have dozens of videos visible, some may be blocked. Try scrolling so fewer video cards are in view when you click Play All, or hover individual video cards to play them one at a time.

”My queues disappeared when I reloaded. How do I save them?”

Queues are session-only—they live in memory and are cleared on reload. To preserve a queue’s contents, switch to the queue tab and click Download List before reloading. This exports a text file with all filenames and paths.

”Can I add the same file to multiple queues?”

Yes. Select a file and add it to one queue, then select it again and add it to another. Files can appear in as many queues as you like. The badge on the main grid card reflects only the first queue the file belongs to.

”The masonry layout looks uneven. Why?”

CSS column masonry fills top-to-bottom within each column based on alphabetical file order. Uneven column heights are normal and become more balanced as more images load. If evenness is important, use grid mode instead.

”How do I watch a video in fullscreen?”

Click the ▶️ icon on any video card to open the modal player with native browser controls. From there, use the fullscreen button in the video player controls. On desktop you can also press F while the video is focused.

”Does this work on Firefox or Safari?”

The File System Access API (folder picker, recursive reading) is only available in Chrome 86+ and Edge 86+. Firefox and Safari can use the fallback file input to select individual files, but folder selection and drag-and-drop may not work fully. The viewing experience itself works in all modern browsers.


Final thoughts

Media Viewer is the unexpected star of Sakarto’s organizer suite. It doesn’t find duplicates, delete files, or rename anything. It just lets you browse, enjoy, and curate your images and videos in a way that most file managers simply don’t.

It’s particularly effective for:

  • Browsing large photo collections. Masonry layout + Hide file info = a clean, immersive gallery.
  • Watching vacation videos. Play All + Auto-scroll = a self-running video slideshow.
  • Curating selections. Queues let you build collections without moving files.
  • Comparing similar shots. Side-by-side compare helps you decide which image to keep.
  • Reviewing folders before cleanup. Browse first, then switch to Bulk Delete or Bulk Move when you’re ready to act.

And because it’s read-only, you can use it on any folder without worry. No accidental deletions, no moved files—just a pure viewing experience.

If you’ve ever wanted to sit back and scroll through your photos like a gallery, Media Viewer is the tool that makes it happen.

Ready to browse your media?

January 23, 2026
⏱ 13 min read
🇬🇧 English