PhotosFS

For the Mac

Your Photos library, right in Finder

PhotosFS puts your Photos library on your Mac as a disk. Every photo and video on it is an ordinary file, so any app can open, copy or read it without exporting anything first.

Coming to the Mac App Store

Requires macOS 27 or later

A Finder window on the PhotosFS disk, showing February 2025 as a grid of photo thumbnails, with the path PhotosFS, by-date, 2025, 02 along the bottom.

Features

Folders by date and by album

Every photo sits in a folder for its year and month. Your albums appear as they are in Photos, inside the folders you keep them in, along with smart albums such as Favorites.

Edits, originals and pairs

Edited photos appear as you edited them, with the untouched original in an "original" folder beside them. Live Photo movies and the other half of a RAW+JPEG pair sit next to their still, so nothing the camera recorded is left out. Finder hides the Live Photo movies, so each photo appears once, while scripts and backups still get them.

Always in sync

When you import, edit or reorganise in Photos, the disk follows within moments, without remounting. Filenames stay the same from one day to the next, so scripts, bookmarks and backups keep working.

Ready for your tools

Open photos straight from Preview, Pixelmator, Lightroom or Final Cut, or work with them in Terminal with rsync, ffmpeg or exiftool. A photo that appears in several albums is the same file each time, so a backup copies it once.

Metadata for scripts

A metadata.jsonl file at the top of the disk lists every photo with its dates, size, dimensions, rating, caption, keywords, albums and path, one line each, ready for scripts and spreadsheets.

Read-only

Because the disk is read-only, nothing can be edited, moved or deleted through it, and PhotosFS only ever reads your library. Spotlight is kept away from the disk, so mounting it doesn't start a reindex of your whole collection.

iCloud photos when you open them

If you use Optimize Mac Storage, photos kept in iCloud still appear on the disk, and PhotosFS downloads one when you open it. Finder draws a progress bar under the file while it downloads, and the menu bar lists it.

Downloads stay in a cache, so a photo opens instantly the next time. You can set the cache size, clear it, or turn downloading off to work only with what is already on your Mac.

Finder icons on the PhotosFS disk. Photos on the Mac show thumbnails, photos in iCloud show a plain icon, and IMG_0204.HEIC shows a progress bar while it downloads.
Photos already on your Mac show thumbnails. IMG_0204.HEIC is downloading from iCloud.

Built on FSKit

The disk is a real file system, built on FSKit, Apple's framework for file systems that run as app extensions. There is no kernel extension to install and nothing to approve in Recovery. The file system runs as a sandboxed extension inside the app, which you switch on in System Settings, and the app reads your library through Apple's Photos framework.

Getting started

  1. Allow access to Photos. PhotosFS reads your library to show it as a disk, and never changes it.
  2. Turn on the extension in System Settings › General › Login Items & Extensions › File System Extensions.
  3. Choose the folder that contains your Photos library, usually your Pictures folder.

PhotosFS then builds its index once, in about two minutes for 30,000 photos, and mounts the disk. From then on it follows changes in Photos by itself.