Skip to content

Installation Desktop

Ashley Davis edited this page Jun 14, 2026 · 2 revisions

Installing the Photosphere Desktop App

The Photosphere Desktop app is a graphical application for managing your media file database on Windows, macOS, and Linux.

Prerequisites

Photosphere requires FFmpeg and ImageMagick to import photos and videos. See Required-Tools for platform-specific instructions.

Step 1: Download

  1. Go to the Photosphere releases page.
  2. Find the latest numbered version (or the latest nightly build).
  3. Download the installer or archive for your platform:
Platform File
Windows (installer) photosphere-desktop-*-win-x64.exe
Windows (portable) photosphere-desktop-*-win-x64.zip
macOS Apple Silicon (installer) photosphere-desktop-*-mac-arm64.dmg
macOS Apple Silicon (portable) photosphere-desktop-*-mac-arm64.zip
macOS Intel (installer) photosphere-desktop-*-mac-x64.dmg
macOS Intel (portable) photosphere-desktop-*-mac-x64.zip
Linux (Debian/Ubuntu) photosphere-desktop-*-linux-amd64.deb
Linux (portable) photosphere-desktop-*-linux-x64.zip

The * is the version number (for example 0.0.8).

Windows

Run the .exe installer and follow the prompts, or extract the .zip archive and run photosphere.exe directly.

Windows Security Warning: Because the app is not signed by a registered Microsoft developer, Windows SmartScreen may show "Windows protected your PC". Click More info, then Run anyway to continue.

macOS

Open the .dmg file, drag Photosphere to your Applications folder, and launch it from there.

macOS Security Warning: If you see "cannot be opened because the developer cannot be verified", right-click the app and choose Open, then confirm. Alternatively, remove the quarantine attribute from the terminal:

xattr -cr /Applications/Photosphere.app

This is required because macOS Gatekeeper quarantines downloaded binaries not signed by a registered Apple developer.

Linux

Debian/Ubuntu: Double-click the .deb file to open it in your software installer and click Install. Or install it from the terminal:

sudo dpkg -i photosphere-desktop-*-linux-amd64.deb

Other distributions: Extract the .zip archive and run the photosphere executable directly.

Next Steps

Clone this wiki locally