README.md

suno-cli

A command-line tool for downloading content from Suno.

Installation

You can install the CLI tool globally using npm:

npm install -g suno-cli

Or using bun:

bun install -g suno-cli

Usage

Single URL Download

Download a single song:

suno <suno_url>

For example:

suno https://app.suno.ai/your-song-url

Multiple URLs Download

Download multiple songs by providing URLs separated by newlines within quotes:

suno "<suno_url1>
<suno_url2>
<suno_url3>"

For example:

suno "https://app.suno.ai/your-first-song-url
https://app.suno.ai/your-second-song-url
https://app.suno.ai/your-third-song-url"

The tool will download:

• Cover image (if available)
• Audio file

Files will be saved in your current working directory.

Development

To install dependencies:

bun install

To run locally:

bun run start <suno_url>

To watch for changes during development:

bun run dev <suno_url>

To deploy locally:

bun run deploy

This will build the project and create a global link, allowing you to use the suno command globally.

Building

To build the CLI:

bun run build

This project uses Bun as its JavaScript/TypeScript runtime.