shkim/suno-helper
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Align Suno metadata with music library layout

Browse Source
This commit is contained in:
DESKTOP-KSVGT20\shkim
2026-05-01 23:31:11 +09:00
parent 96a54a3eca
commit b769b62b19
4 changed files with 259 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+7 -5
View File
@@ -69,13 +69,15 @@ WAV 다운로드는 SUNO 계정 권한, 변환 준비 상태, CDN 접근 정책
정리 포맷:
```text
\\VaultOfData\AKAMedia\음악\처리됨\SUNO\곡 제목 [clipId앞12자리]\01 곡 제목.flac
\\VaultOfData\AKAMedia\음악\처리됨\SUNO\곡 제목 [clipId앞12자리]\cover.jpg
\\VaultOfData\AKAMedia\음악\처리됨\SUNO\곡 제목 [clipId앞12자리]\metadata.json
\\VaultOfData\AKAMedia\음악\처리됨\SUNO\곡 제목\01 곡 제목.flac
\\VaultOfData\AKAMedia\음악\처리됨\SUNO\곡 제목\01 곡 제목.lrc
\\VaultOfData\AKAMedia\음악\처리됨\SUNO\곡 제목\cover.jpg
\\VaultOfData\AKAMedia\음악\처리됨\SUNO\곡 제목\album.nfo
\\VaultOfData\AKAMedia\음악\처리됨\SUNO\곡 제목\metadata.clipId앞12자리.json
```
동기화 비교 키는 곡 제목이 아니라 SUNO clip id입니다. 같은 제목의 곡이 여러 개 있어도 `metadata.json`의 `id`와 폴더명의 id 조각으로 구분합니다.
동기화 비교 키는 곡 제목이 아니라 SUNO clip id입니다. 같은 제목의 곡이 여러 개 있어도 폴더명/앨범명은 깨끗하게 `곡 제목`으로 유지하고, `metadata.*.json`의 `id`와 FLAC 내부 comment 태그로 구분합니다.
로컬 처리기는 manifest에 저장된 WAV URL만 다운로드합니다. MP3/audio fallback은 사용하지 않습니다. 이후 ffmpeg로 FLAC 변환하면서 기존 라이브러리 방식에 맞춰 title, artist, album, album_artist, track, disc, genre/style, lyrics-XXX, Suno clip id, cover art를 메타데이터로 넣습니다.
로컬 처리기는 manifest에 저장된 WAV URL만 다운로드합니다. MP3/audio fallback은 사용하지 않습니다. 이후 ffmpeg로 FLAC 변환하면서 기존 라이브러리 방식에 맞춰 title, artist, album, album_artist, track, disc, genre/style, lyrics-XXX, Suno clip id, cover art를 메타데이터로 넣습니다. 앨범명은 폴더명과 같은 `곡 제목`입니다.
로그는 `companion-logs` 폴더에 저장됩니다.