Folderstream app icon

Folderstream

macOS photo browser

Native SwiftUI app macOS 14+

Your folders. Your photos. No import ceremony.

Folderstream turns any folder into a clean, full-window photo library on macOS. Browse instantly, move through images with the keyboard, keep organizing in Finder, and stream the same library to DLNA devices on your network.

Browsing
Folder-first sidebar and lazy thumbnail grid
Playback
Fullscreen photos and inline video playback
Sharing
Built-in DLNA streaming for local devices
Folderstream showing a sidebar-based folder browser and image grid

Instant library

Open a folder and browse without importing, indexing, or changing your file structure.

Live updates

Folderstream watches the library tree and refreshes when files or folders change.

Why Folderstream

Built for people who keep their photo library in folders, not in a black box.

The app is based on the repository’s actual capabilities: hierarchical folder navigation, QuickLook thumbnails, keyboard-driven fullscreen viewing, live file-system sync, and an optional DLNA media server.

Folder navigation

Browse like Finder, not like an import queue

The sidebar mirrors your directory structure and keeps subfolders visible and collapsible without hiding where your files actually live.

Photo detail

Fullscreen viewing with keyboard control

Open any image or video into a full-window viewer, move with the arrow keys, and jump back to the grid with Escape.

Read-only by design

No hidden writes, no surprise file changes

Folderstream is a browser, not a file manager. Your library stays organized in Finder, and the app simply reflects what is already on disk.

Local streaming

Share the same library over DLNA

Start the built-in server and compatible TVs, media players, and apps on your network can discover and stream your media.

Fullscreen photo viewer in Folderstream

Immersive viewing

From grid to fullscreen in one click.

The viewer fills the window for photos and videos, keeping the experience focused and lightweight. The repository also shows support for metadata popovers and inline AVPlayer playback.

Keyboard flow

Left and right arrows move between media. Escape returns to the grid.

Mixed media

Photos and videos live in the same browser instead of separate tools.

Metadata panel shown over a photo in Folderstream
Inspect image details without leaving the viewer.
Folderstream browsing a folder of gymnastics competition photos
QuickLook-powered thumbnails keep dense folders readable.
Folder rename interaction in the Folderstream sidebar
Keep your existing folder structure visible while browsing.

Workflow

Simple by design.

  1. 1

    Open any photo folder

    Choose a directory from the toolbar, drag it onto the window, or open it from the dock.

  2. 2

    Browse while Finder stays the source of truth

    Navigate subfolders in Folderstream, then rename, move, or sort files in Finder. The app refreshes when the library changes on disk.

  3. 3

    Optionally stream everywhere

    Enable the built-in DLNA server and browse the same library from compatible TVs and local media players.

Folderstream browsing another folder with the toolbar actions visible

Security

Scoped access and local-network sharing

The app is sandboxed and uses com.apple.security.files.user-selected.read-write, which means file access is tied to folders the user selects.

The optional DLNA feature uses additional network entitlements for local discovery and streaming. When enabled, compatible devices on the same network can discover the server and browse the selected library.

If DLNA sharing is not turned on, the app functions as a local desktop browser for your folder-based media library.

FAQ

Common questions

Does Folderstream import or reorganize my library automatically?

No. Folderstream opens an existing folder as your library. It browses your current structure and does not require an import step or reorganize files for you.

Does the app write metadata files into my photo folders?

Folderstream is designed as a read-only browser for the selected folder tree. It does not reorganize your library or depend on sidecar database files inside your photo folders.

Can I browse videos too, or only photos?

Both. The project includes photo browsing, fullscreen viewing, and inline video playback with AVPlayer controls.

Can I move or rename folders from inside the app?

No. Folderstream is intentionally a browser, not a file manager. Make those changes in Finder and the app will refresh to match the file system.

What happens when files change on disk?

Folderstream watches the library tree with FSEvents and refreshes automatically, with a debounce to avoid excessive reloads.

Can I stream the library to a TV or another player?

Yes, if you enable the built-in DLNA server. Compatible devices on the same local network can discover and stream the shared media library.

Folderstream

A photo browser for people who already know where their files live.

Native macOS UI, no hidden library format, Finder-first organization, and optional network streaming when you want your archive beyond the Mac.

Built with SwiftUI and AVKit
Copyright © Grok Software Unipessoal Lda.