Skip to main content

​
Prerequisites

Before installing the Camera Workflow extension, ensure you have:
  • macOS (Apple Silicon or Intel)
  • Raycast installed (download here)
  • Homebrew package manager (recommended for dependencies)

​
System Dependencies

The extension requires external tools for media processing. Install them using Homebrew: 
brew install ffmpeg imagemagick
This installs:
  • ffmpeg and ffprobe: Video conversion and analysis
  • magick (ImageMagick): Image conversion and processing
The extension will check for these dependencies on launch and show a clear error if any are missing.

​
Installation Methods

​
Verify Installation

After installation, verify everything is working:
1

Open the extension

Press ⌘ Space and search for “Prepare Library for Backup”. Press Enter to launch.
2

Check dependency status

The form should show:
✅ Dependencies ready (embedded media-converter)
If you see warnings about missing dependencies:
⚠️ Missing dependencies: ffmpeg, magick
Install the missing tools using Homebrew (see System Dependencies).
3

Test with dry-run

Select a test folder, enable Dry Run, and run a test conversion to verify everything works.

​
Troubleshooting

The extension cannot find ffmpeg or ImageMagick in your PATH.Solution:
  1. Install the dependencies: 
    brew install ffmpeg imagemagick
  2. Restart Raycast to pick up the new PATH: 
    killall Raycast && open -a Raycast
  3. If the issue persists, verify the tools are installed: 
    which ffmpeg ffprobe magick
The embedded Go binary is missing from the extension assets.Solution for Store Installation:Reinstall the extension from the Raycast Store.Solution for Development:Rebuild the binaries:
make raycast-binaries
The extension currently only supports macOS (Apple Silicon and Intel).Solution:If you’re on Linux or Windows, use the CLI interface instead:
make build
./media-converter /source /destination
Raycast may not inherit your shell’s full PATH, especially if you use custom shell configurations.Solution:The extension performs exhaustive PATH resolution, but if dependencies are in unusual locations, you may need to:
  1. Install via Homebrew (which places binaries in standard locations)
  2. Or, symlink the tools to a standard location: 
    ln -s /path/to/ffmpeg /usr/local/bin/ffmpeg
ln -s /path/to/magick /usr/local/bin/magick

​
Configuration

The extension uses the same configuration as the CLI tool. You can create a config file to set default values:
~/.media-converter.yaml
# Default conversion settings
photo_format: avif
photo_quality_avif: 80
photo_quality_webp: 85
video_codec: h265
video_crf: 28
jobs: 4
Command-line arguments (passed via the Raycast form) override config file settings.

​
Next Steps

Learn the Workflow

Understand the guided workflow and conversion process

Build docs developers (and LLMs) love

Get started for freeTalk to us