Skip to content

Install Phytograph

Phytograph runs on macOS (Apple Silicon and Intel), Windows 10/11, and Linux (x64).

Download

Get the latest installer from the GitHub Releases page.

Platform File
macOS (Apple Silicon, M1/M2/M3/M4) Phytograph-arm64.dmg
macOS (Intel) Phytograph-x64.dmg
Windows 10/11 Phytograph-Setup.exe
Linux (x64) Phytograph-x86_64.AppImage

Install on macOS

  1. Double-click the .dmg file.
  2. Drag the Phytograph icon into your Applications folder.
  3. Eject the disk image and launch Phytograph from Applications or Spotlight.

The first launch takes about 30 seconds while the bundled scientific Python environment unpacks itself. Subsequent launches are instant.

Phytograph is signed with an Apple Developer ID and notarized by Apple, so it opens with a normal double-click — no security warning.

If macOS still says the app can't be opened

Older or unsigned builds may show "Phytograph can't be opened because Apple cannot check it for malicious software". Right-click the app in Applications, choose Open, and click Open in the dialog. You only need to do this once.

Install on Windows

  1. Double-click Phytograph-Setup.exe.
  2. If SmartScreen warns you, click More info → Run anyway.
  3. Follow the installer prompts.
  4. Launch Phytograph from the Start menu.

Install on Linux

Phytograph ships as an AppImage, which runs on most distributions without installing anything:

bash chmod +x Phytograph-x86_64.AppImage ./Phytograph-x86_64.AppImage

As with macOS, the first launch takes about 30 seconds while the bundled Python environment unpacks itself.

AppImage prerequisites

The AppImage needs FUSE to mount itself. Most desktop distributions ship it; on a minimal install run sudo apt install libfuse2 (Debian/Ubuntu) or your distribution's equivalent. Alternatively, extract and run without FUSE: ./Phytograph-x86_64.AppImage --appimage-extract-and-run.

What gets installed

Phytograph ships as a single self-contained application bundle. It includes its own Python environment with all scientific libraries (open3d, scipy, pyhelios) embedded. You don't need to install Python, Conda, or anything else separately.

The app stores its preferences and recent files list in:

  • macOS: ~/Library/Application Support/Phytograph/
  • Windows: %APPDATA%\Phytograph\
  • Linux: ~/.config/Phytograph/

What's next

Open the app and continue to Your first import.