suno-web-cli

A CLI tool for generating and downloading AI music from Suno — directly from your terminal.

No API key required. It automates the Suno web UI via a real browser (Playwright), so all you need is a Suno account.

Quick Start

Step 1 — Install Node.js

Requires Node.js 18 or later.

node -v   # should print v18.x.x or higher

Download the LTS version from https://nodejs.org/ if needed.

Step 2 — Install suno-web-cli

npm install -g suno-web-cli

This will also download the Chromium browser automatically (~200 MB, one-time).

Step 3 — Log in to Suno (first time only)

suno login

A browser window opens. Sign in with Google, Discord, Apple, or any supported method. Once logged in, the terminal will confirm success.

Your session is saved locally, so you won't need to log in again unless it expires.

Step 4 — Create a song

suno create --lyrics "Starlight falling on the city tonight" --style "pop, cinematic, female vocal"

That's it.

Commands

| Command | Description | |---|---| | suno login | Open browser for Suno login | | suno create | Generate a new song | | suno download <url> | Download a song as MP3 | | suno status | Check login session state | | suno status -v | Show detailed session info |

suno create — Options

| Option | Description | Required | |---|---|---| | --lyrics "..." | Song lyrics (inline) | Required unless --instrumental | | --lyrics-file <path> | Read lyrics from a file | Alternative to --lyrics | | --style "..." | Music style (e.g. "lo-fi, chill, guitar") | Optional | | --title "..." | Song title | Optional (Suno auto-generates if omitted) | | --instrumental | Generate without vocals | Optional | | --headless / --no-headless | Show or hide the browser window (default: headless) | Optional |

Examples

With a title:

suno create --title "Midnight Drive" --lyrics "Neon lights blur past" --style "synthwave, 80s"

Lyrics from a file:

suno create --lyrics-file ./my-lyrics.txt --style "lo-fi, chill"

Instrumental only:

suno create --instrumental --style "jazz, acoustic guitar"

Show the browser while generating:

suno create --lyrics "test" --style "pop" --no-headless

suno download — Options

Download any public Suno song as an MP3 by its share URL.

suno download https://suno.com/s/VYOu1lTN0vlAm0s4

The file is saved as <Song Title>.mp3 in the current directory. If a file with that name already exists, it is saved as <Song Title> (1).mp3, (2).mp3, and so on.

| Option | Description | |---|---| | <url> | Suno share URL (e.g. https://suno.com/s/...) | | -o, --output <path> | Custom output path (default: ./<song-title>.mp3) | | --no-headless | Show the browser window during download |

Examples

# Save to current directory with song title as filename
suno download https://suno.com/s/VYOu1lTN0vlAm0s4

# Save to a specific path
suno download https://suno.com/s/VYOu1lTN0vlAm0s4 -o ~/Music/my-song

FAQ

Do I need a Suno account?

Yes. Sign up for free at https://suno.com. Free accounts receive daily credits.

How many credits does one song cost?

Each create call generates 2 songs and costs 10 credits.

I'm getting a "Not logged in" error

Run suno login again. Your session may have expired.

Something went wrong — how do I debug?

A screenshot is automatically saved to ./artifacts/ at the time of any error.

For verbose logs:

SUNO_LOG_LEVEL=debug suno create --lyrics "test" --style "pop"

Does this work on Windows and Linux?

Yes. Any OS with Node.js 18+ is supported.

Uninstall

npm uninstall -g suno-web-cli

License

MIT

suno-web-cli

터미널에서 Suno로 AI 음악을 만들고 다운로드하는 도구.

별도 API 키 없이 웹 브라우저 자동 제어(Playwright) 방식으로 동작한다. Suno 계정만 있으면 된다.

빠른 시작

1단계 — Node.js 설치

Node.js 18 이상이 필요하다.

node -v   # v18.x.x 이상이면 OK

2단계 — suno-web-cli 설치

npm install -g suno-web-cli

설치 시 Chromium 브라우저가 자동으로 다운로드된다 (~200MB, 최초 1회).

3단계 — Suno 로그인 (최초 1회)

suno login

브라우저 창이 열린다. Google, Discord, Apple 등 원하는 방법으로 로그인한다. 세션이 저장되므로 만료 전까지 다시 로그인할 필요 없다.

4단계 — 곡 만들기

suno create --lyrics "별빛이 쏟아지는 밤에 너를 떠올려" --style "K-pop, ballad, female vocal"

명령어 정리

| 명령어 | 설명 | |---|---| | suno login | 브라우저를 열어 Suno 로그인 | | suno create | 곡 생성 | | suno download <url> | 노래 MP3 다운로드 | | suno status | 로그인 상태 확인 | | suno status -v | 상세 상태 확인 |

suno create — 옵션

| 옵션 | 설명 | 필수 | |---|---|---| | --lyrics "가사" | 곡 가사 (직접 입력) | --instrumental이 아니면 필수 | | --lyrics-file <경로> | 가사를 파일에서 읽기 | --lyrics 대신 사용 가능 | | --style "스타일" | 음악 스타일 (예: "K-pop, ballad, female vocal") | 선택 | | --title "제목" | 곡 제목 | 선택 (미지정 시 Suno 자동 생성) | | --instrumental | 가사 없이 인스트루멘탈 생성 | 선택 | | --headless / --no-headless | 브라우저 헤드리스 모드 on/off (기본: on) | 선택 |

사용 예시

# 제목 지정
suno create --title "밤하늘" --lyrics "별빛이 쏟아지는 밤" --style "K-pop, ballad"

# 가사 파일 사용
suno create --lyrics-file ./my-lyrics.txt --style "Lo-fi, chill"

# 인스트루멘탈
suno create --instrumental --style "Jazz, acoustic guitar"

# 브라우저 보면서 생성
suno create --lyrics "테스트 가사" --style "Pop" --no-headless

suno download — 옵션

공개된 Suno 노래를 MP3로 다운로드한다.

suno download https://suno.com/s/VYOu1lTN0vlAm0s4

현재 디렉토리에 <노래 제목>.mp3로 저장된다. 같은 이름의 파일이 이미 있으면 (1), (2) 순으로 번호가 붙는다.

| 옵션 | 설명 | |---|---| | <url> | Suno 공유 URL (https://suno.com/s/...) | | -o, --output <경로> | 저장 경로 지정 (기본: ./<노래 제목>.mp3) | | --no-headless | 다운로드 중 브라우저 창 표시 |

자주 묻는 질문

Suno 계정이 필요한가요? 네. https://suno.com 에서 무료 가입 가능하며, 무료 계정도 매일 크레딧이 제공된다.

곡 하나에 크레딧이 얼마나 드나요? 1회 생성 시 2곡이 만들어지며 10 크레딧이 소모된다.

"Not logged in" 에러가 납니다 suno login을 다시 실행한다. 세션이 만료되었을 수 있다.

에러가 나면 어떻게 하나요? ./artifacts/ 폴더에 에러 시점의 스크린샷이 자동 저장된다.

디버그 로그:

SUNO_LOG_LEVEL=debug suno create --lyrics "테스트" --style "Pop"

Windows / Linux에서도 되나요? 된다. Node.js 18 이상이면 OS 무관하게 동작한다.

삭제

npm uninstall -g suno-web-cli