Installation

Installation

Prerequisites

Before installing Photosphere CLI, install the required media processing tools. See Required-Tools for platform-specific installation instructions.

Install Photosphere CLI

Step 1: Download

1. Go to the Photosphere releases page
2. Download the appropriate binary for your platform:
   • Linux: psi-linux-x64 or psi-linux-arm64
   • Windows: psi-windows-x64.exe
   • macOS: psi-macos-x64 or psi-macos-arm64

Step 2: Make Executable (Linux/macOS)

After downloading, you need to make the binary executable:

# Rename for convenience (optional)
mv psi-linux-x64 psi        # Linux
mv psi-macos-x64 psi        # macOS

# Make executable
chmod +x psi

# Verify permissions
ls -la psi

You should see permissions like -rwxr-xr-x.

Step 3: Remove Quarantine (macOS Only)

macOS blocks unsigned binaries by default. Remove the quarantine attribute:

xattr -c ./psi

This is safe for trusted software like Photosphere CLI.

Step 4: Move to PATH (Optional)

For system-wide access, move the binary to a directory in your PATH:

# Linux/macOS
sudo mv psi /usr/local/bin/

# Or create a local bin directory
mkdir -p ~/bin
mv psi ~/bin/
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Windows: Move psi.exe to a folder in your PATH, or add its location to your PATH environment variable.

Verify Installation

Test that everything works:

# Check that Photosphere CLI is working
psi --version

# Verify required tools are detected
psi tools

The psi tools command will check that FFmpeg and ImageMagick are properly installed and accessible.

Next Steps

• Getting-Started-CLI - Detailed guide for using Photosphere
• Command-Reference - Complete list of CLI commands