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