Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation and ffmpeg

Install the CLI

With Cargo

If you have a Rust toolchain, install the published crate from crates.io:

cargo install rs-suno

This builds and installs the suno binary into ~/.cargo/bin. Make sure that directory is on your PATH.

Pre-built binaries

Pre-built binaries are attached to each GitHub release. The following platforms are published:

PlatformAssetNotes
Linux x86_64suno-vX-x86_64-linux.tar.gzstatically linked (musl)
Linux aarch64suno-vX-aarch64-linux.tar.gzstatically linked (musl)
Windows x86_64suno-vX-x86_64-windows.zipnative MSVC
Windows aarch64suno-vX-aarch64-windows.zipnative MSVC

Download the archive for your platform, extract the suno binary, and place it somewhere on your PATH.

Each archive ships a matching .sha256 checksum and a build-provenance attestation. The binaries are unsigned, so Windows may show a SmartScreen “unknown publisher” prompt on first run; verify the download against its .sha256 and attestation if you want to confirm its integrity.

Container image

The official Linux amd64 and arm64 image includes ffmpeg and CA certificates:

podman run --rm ghcr.io/teh-hippo/rs-suno:latest version

Read Containers for persistent config and library mounts, token handling, host scheduling, and Proxmox VE deployment.

Verify the install

suno version

This prints the build version and target, the resolved config path, and the detected ffmpeg:

suno 0.1.0 (x86_64-unknown-linux-gnu)
config: /home/alice/.config/suno/config.toml
ffmpeg: 6.1.1 (detected at /usr/bin/ffmpeg)

If the last line reads ffmpeg: not found on PATH, install ffmpeg as below.

ffmpeg

rs-suno shells out to ffmpeg for two jobs:

  • transcoding the server-rendered lossless audio to FLAC or ALAC, and
  • transcoding a clip’s video preview to an animated WebP cover when you pass --animated-covers.

You therefore need an ffmpeg build with FLAC, ALAC (the alac encoder and the ipod/MP4 muxer), and animated-WebP (libwebp_anim) support. Most distribution packages include all of them. suno runs the first ffmpeg it finds on your PATH.

Install ffmpeg

PlatformCommand
Debian, Ubuntusudo apt install ffmpeg
Fedorasudo dnf install ffmpeg
Archsudo pacman -S ffmpeg
macOS (Homebrew)brew install ffmpeg
Windows (winget)winget install Gyan.FFmpeg

Check ffmpeg has what you need

Confirm ffmpeg is on your PATH and can encode the formats:

ffmpeg -hide_banner -encoders | grep -E 'flac|alac|libwebp'

You should see the flac and alac audio encoders and the libwebp/libwebp_anim video encoders. FLAC (the default) or ALAC output needs ffmpeg; the WebP encoder is only needed if you use --animated-covers. MP3 and WAV downloads do not need ffmpeg for the audio itself, but FLAC and ALAC do, so keeping a full ffmpeg build is the simplest path.

Next steps

With the binary and ffmpeg in place, set up your token in Authentication, then create a config with suno config init.