Files
suno-helper/README.md
T
2026-05-01 15:58:52 +09:00

43 lines
2.6 KiB
Markdown

# ChatGPT to Suno Tampermonkey Helper
ChatGPT가 만든 `Version A/B/C` 형식의 SUNO 프롬프트를 파싱해서 SUNO 입력칸에 붙여넣는 Tampermonkey userscript입니다.
## 설치
1. Chrome에 Tampermonkey를 설치합니다.
2. 아래 설치 URL을 엽니다.
3. Tampermonkey 설치 화면에서 `Install`을 누릅니다.
설치 URL:
```text
https://git.mokaya.org/shkim/suno-helper/raw/branch/master/chatgpt-suno-tampermonkey.user.js
```
수동 설치가 필요하면 Tampermonkey 대시보드에서 새 스크립트를 만들고 `chatgpt-suno-tampermonkey.user.js` 내용을 붙여넣어 저장합니다.
## 자동 업데이트
스크립트 메타데이터의 `@updateURL` / `@downloadURL`이 공개 Gitea raw URL을 바라봅니다. 이후 `@version`을 올려서 `master` 브랜치에 push하면 Tampermonkey가 업데이트를 감지합니다.
현재 repo는 `private=false` 공개 상태입니다. 다만 Gitea 서버가 비로그인 사용자에게 저장소 보기를 막도록 설정되어 있으면 raw URL도 로그인 화면으로 이동하므로, 완전한 공개 자동 업데이트를 쓰려면 서버 설정에서 비로그인 저장소 보기가 허용되어야 합니다.
## 사용법
1. ChatGPT 답변 페이지에서 `Version A/B/C` 형식이 감지되면 오른쪽 위에 작은 `ChatGPT -> Suno` 패널이 나타납니다.
2. 원하는 버전의 `S1` 또는 `S2` 버튼을 눌러 슬롯에 저장합니다.
3. SUNO Create 페이지로 이동합니다.
4. 오른쪽 아래 `Suno Prompt Paste` 패널에서 슬롯을 고르고 `선택 슬롯 붙여넣기`를 누릅니다.
SUNO 화면 구조가 바뀌어 자동 입력이 실패하면, 패널의 `Title`, `Style of Music`, `Lyrics`, `Exclude` 버튼으로 개별 값을 클립보드에 복사해서 수동으로 붙여넣을 수 있습니다.
## SUNO 다운로드
SUNO 곡 상세/플레이어 화면에서 `WAV + 커버 + 메타 다운로드`를 누르면 현재 페이지에서 감지된 곡 정보를 기준으로 아래 파일을 다운로드합니다.
- `{title}.wav`: clip id가 감지되면 `https://cdn1.suno.ai/{clipId}.wav` 후보를 내려받습니다.
- `{title}.cover.*`: 페이지에서 감지된 앨범아트 URL을 내려받습니다.
- `{title}.metadata.json`: title, clip id, audio/image URL, 감지된 원본 메타데이터, 현재 페이지 URL을 저장합니다.
WAV 다운로드는 SUNO 계정 권한, 변환 준비 상태, CDN 접근 정책에 따라 실패할 수 있습니다. 이 경우 metadata JSON의 `detectedAudioUrls`, `detectedImageUrls`, `detectedIds`를 보고 실제 페이지에서 어떤 URL이 잡혔는지 확인할 수 있습니다.