suno-cli

Download Suno song audio and cover image from the command line.

Features

• Download audio (og:audio) and cover image (og:image) from a Suno song URL
• Support single and batch URLs
• Support URL file input (--file / -f)
• Avoid overwriting existing files (auto suffix _1, _2, ...)
• Return non-zero exit code when any task fails (good for scripts/CI)

Installation

npm install -g suno-cli

or

bun install -g suno-cli

Usage

1) Single URL

suno https://suno.com/song/<song-id>

2) Multiple URLs (separate args)

suno <url1> <url2> <url3>

3) Multiple URLs (newline text)

suno "https://suno.com/song/<id-1>
https://suno.com/song/<id-2>
https://suno.com/song/<id-3>"

4) Load URLs from file

Create urls.txt:

# one URL per line
https://suno.com/song/<id-1>
https://suno.com/song/<id-2>

Then run:

suno --file urls.txt

Short flag:

suno -f urls.txt

5) Mixed input

suno <url1> --file urls.txt

Output

Files are saved to current working directory:

• <song_name>.mp3
• <song_name>_cover.jpg|jpeg|png

If filename already exists, it will create <song_name>_1.mp3, etc.

Exit Codes

• 0: all downloads succeeded
• 1: one or more downloads failed, invalid input, or runtime error

Development

bun install
bun run build
bun run start <url>
bun run dev <url>

Local deploy (global link):

bun run deploy

Built with Bun + TypeScript.