Troubleshooting - ashleydavis/photosphere GitHub Wiki

For more detailed usage instructions, see the Getting Started Guide.

"Command not found"

• Make sure the binary is executable (chmod +x psi)
• Check that it's in your PATH or use the full path to the binary

"Cannot be opened" (macOS)

• Run xattr -c ./psi to remove quarantine attributes
• Make sure you downloaded the correct architecture (x64 vs arm64)

"Tool not found" errors

• Install FFmpeg and ImageMagick using the instructions above
• Make sure they're in your system PATH
• Run psi tools to diagnose tool detection issues

Permission denied

• Make sure you have write permissions to the database directory
• Run with sudo only if absolutely necessary