Getting Started

Photo Export is a native macOS app that exports your Apple Photos library to local or external storage. Browse two ways: a Timeline view organized by year and month, or a Collections view that lists your Favorites, every album you’ve created in Photos, and any iCloud shared albums you participate in. (Smart albums other than Favorites aren’t included. Shared albums export at reduced quality — see Features → Shared albums.)

Prerequisites

macOS 15.0 or later
iCloud Photos enabled — Photo Export reads your local Photos library via Apple’s PhotoKit framework. It sees exactly what the built-in Photos app sees. For your iCloud photos to appear, iCloud Photos must be turned on: go to System Settings → Apple Account → iCloud → Photos and make sure it’s enabled.

Download

Photo Export is available through two channels:

Mac App Store — Automatic updates, trusted distribution. Your purchase supports development of an open-source project.
GitHub Releases (free) — Download the latest .dmg from the GitHub Releases page. Open the DMG and drag Photo Export to your Applications folder.

Both versions are identical in functionality, signed and notarized by Apple.

First launch

1. Grant Photos access

On first launch, macOS will prompt for Photos library access. Allow access to let the app read your photo and video library.

The access screen, Auto Export Settings and manual export failures give the same instruction: turn on Photos access for Photo Export in System Settings → Privacy & Security → Photos. If you deny access, choose Open System Settings on the authorization screen to get there. Return to Photo Export: it checks access again and continues to onboarding or your library. Follow any relaunch instruction macOS itself presents.

2. Choose an export destination

An onboarding screen will guide you through selecting the folder where photos and videos will be exported. This can be:

A folder on your Mac (e.g. Desktop, Documents, or a dedicated backup folder)
An external USB or Thunderbolt drive
A network volume (if mounted)

The folder needs to be writable. The app remembers your choice across launches using a security-scoped bookmark.

3. Start exporting

Once the destination is set, you’ll see the main window with a Timeline / Collections segmented control above the sidebar and a thumbnail grid in the center.

Timeline — browse year by year, month by month. Click a month to see its photos. Click Export Month in the grid header to export that month, or Export All in the toolbar to queue the entire library.
Collections — see your Favorites at the top, then every album and folder from Photos beneath. Click an album to see its photos, then Export Favorites or Export Album in the grid header. The toolbar’s Export All Albums action queues Favorites and every user album, including nested albums; Shared Albums are excluded. A single selected Shared Album gets Export Shared Album instead, and multiple sidebar selections switch the toolbar to Export N Items for that selection. To export a folder subtree, use Export 1 Album / Export N Albums in the folder’s content pane; selected child tiles narrow that action to their albums. Albums under Photos folders preserve their hierarchy on disk (e.g. Collections/Albums/Trips/Iceland/).

A few extras that work in both views:

Settings → Advanced (Cmd+,) controls what lands on disk. Include originals adds a _orig companion for any photo or video edited in Photos so you keep a copy of the original bytes. Convert HEIC to JPEG re-encodes HEIC captures as JPEG on export, useful for destinations that don’t understand HEIC. Separate videos into a subfolder routes standalone videos into a videos/ subfolder so a backup doesn’t mix photos and .MOV files. All three are off by default. The onboarding flow exposes the first two inline on first launch.
Edited videos render through Photos and may take longer than copying — especially for 4K or iCloud-only originals. The export progress strip may briefly show (downloading…) while Photos prepares the source, then (rendering…) while the edit is applied.
File → Import Existing Backup… (Cmd+Shift+I) rebuilds local state to match the destination on disk. It adopts any files that are already there as exported — in the year/month folders and in the Favorites, album and shared-album folders — and prunes records for files that have since been deleted — useful both on a fresh install and when you’ve manually cleared part of a backup folder.

Export progress appears in a strip at the top of the content column, below the toolbar. Use the toolbar controls to pause, resume, or cancel. Import progress appears in its own sheet.

If the selected month already has paused work, clicking Export Month also resumes the existing queue with its original settings. This continues all work already queued, including other months, without adding the same unfinished photos again. New photos added since that queue was prepared can be included in a later export.

4. (Optional) Turn on Auto Export

If you want Photo Export to keep your backup folder in sync automatically — adding new photos as they appear in Apple Photos without you clicking Export — open Photo Export → Settings… (Cmd+,) and head to the Auto Export tab. Enable the toggle and pick at least one category to back up (Timeline, Favorites, or Albums). For a hands-off setup, also turn on Open Photo Export at login.

The full walkthrough — what triggers a run, how retry works, what the status icons mean — lives in the Auto Export guide.

Troubleshooting

“Export folder is unavailable. Reconnect the drive or network share to export.” — Reconnect the selected backup drive or network share. This warning appears in the main window and Export help text, whether Auto Export is on or off; you do not need to choose a different destination.
“Export folder access needs restoring. Reconnect the drive, then choose the same folder if needed.” — Reconnect first. If access still needs renewing, use Choose Folder… to reselect the same backup folder. The app also shows this recovery when a stored bookmark cannot be restored.
“Is this your previous backup folder?” — Photo Export asks this when it can’t reach the folder you used before, so it can’t tell whether the one you picked is the same. Same Folder keeps your export history and immediately checks it against the folder (the same check as Import Existing Backup): files already there are recognized, missing ones are exported again, and nothing is exported twice. If none of your previously exported files are in the folder, your history is kept unchanged, nothing is exported, and the app asks you to choose the folder that has your earlier exports or use this one as a new folder. New Folder starts an empty history and exports everything to the folder.
“Export folder is read-only. Allow write access or choose a writable folder.” — Right-click the folder, choose Get Info, and make sure you have write permission. Import Existing Backup can still read a read-only folder.
Photos permission denied — Choose Open System Settings, enable access for Photo Export under Privacy & Security → Photos, then return to the app. It checks access again when you return.
Export stuck near 100% — Use Help → Save Diagnostic Report… to write a text file listing every photo whose export is in failed or in-progress state, including the underlying error message. If a previous Auto Export run was interrupted by the operating system (rare, but possible on very large libraries), the report also names which scope was in flight at the time. Attach the file to a GitHub issue so the cause is visible.
Unexpected _orig files in my backup — If Photos can’t provide the edited version of an asset (Edited resource unavailable in the diagnostic report), the app writes the original file with an _orig suffix so you still have a backup of the asset. The diagnostic report flags these assets.

Upgrading from an earlier version

If you’ve been running Photo Export 1.2.3 or earlier: your previously-exported files and Photos library access carry over untouched — Photo Export never deletes, overwrites, or moves files at your destination, on upgrade or otherwise. The Auto Export guide’s “Upgrading” section covers the new UI surfaces, how existing export records migrate automatically, the recovery flow if you see a “Destination Has Unresolved Issues” banner, and the channel-switch flow if you’re moving between Mac App Store and GitHub builds.

Updates and distribution channels

Photo Export is distributed through two channels. Both versions are identical in functionality.

Mac App Store users receive updates automatically through the App Store.
GitHub Releases users should check the Releases page for new versions.

Both builds can be installed on the same Mac simultaneously — they use separate bundle identifiers and separate data (export history, bookmarks, preferences).

Switching between channels

If you want to move from one channel to the other:

Install the new channel’s build
Select the same export folder you used before
Go to File > Import Existing Backup… (Cmd+Shift+I) — this scans the destination folder, matches exported files to your Photos library, and rebuilds the export history so future exports skip already-exported assets

Without step 3, the new build treats the destination as fresh and may create duplicate files.

Build from source

If you prefer to build from source or want to contribute:

git clone https://github.com/valtteriluomapareto/photo-export.git
cd photo-export
open photo-export.xcodeproj

Press Run (Cmd+R) with the photo-export scheme selected. Requires Xcode at or above the version in .xcode-version, which CI and releases use.

See the Contributing guide for more details on development setup, running tests, and linting.