웹사이트를 숨은 브라우저로 띄우지 않고, UI는 egui로, 오디오는 rodio로 직접 처리한다. 그래서 가볍다. 데이터는 music.youtube.com이 쓰는 웹 API를 그대로 쓰는 비공식 클라이언트라서, YouTube 쪽 변경에 언제든 깨질 수 있다.
개요
grapedjuice가 만든 Windows·macOS·Linux용 YouTube Music 앱이다. GPL-3.0이고 코드는 전부 Rust다. 저장소는 2026-10-06에 생겼고 최신 버전은 v0.3.3(2026-11-14)이다. 2026-11-16 수집 기준 ★403, 포크 37이다. 기여자는 작성자 외에 여러 명이 있고, v0.3.3의 Linux 수정 대부분은 외부 기여자(@Sukooo)가 했다.
같은 “YouTube를 다른 껍데기로 보기” 계열인 2026-10-11-github-iv-org-invidious는 서버에 올리는 웹 프런트엔드다. ytm-rs는 로그인한 개인 계정으로 쓰는 로컬 데스크톱 앱이다.
왜 가벼운가
README가 내세우는 비교다. 같은 Windows 11 PC에서 노래 한 곡을 재생하며 쟀다고 한다(작성자 측정).
| ytm-rs 0.3.0 | Chrome 탭 | Pear Desktop 3.12.0 | |
|---|---|---|---|
| 재생 중 메모리 | 약 130MB | 496MB | 638MB |
| Windows 다운로드 | 11MB | – | 107MB |
| 설치 크기 | 36MB | – | 397MB |
| 내부에 브라우저 실행 | 아니오 | 예 | 예 |
다만 완전히 웹 없이 돌지는 않는다. Google·Spotify 로그인과 가사 확인은 임시 시스템 웹뷰 창(Windows는 WebView2)을 연다. 앱을 켠 뒤 첫 곡은 YouTube 플레이어 준비로 5초쯤 걸리고, 그다음부터는 바로 시작한다.
구성 요소
| 부분 | 쓰는 것 |
|---|---|
| UI | egui(즉시 모드 GUI), 아이콘 Lucide |
| 오디오 | rodio + Symphonia. 다음 곡을 미리 받아 둔다 |
| 탐색·검색·라이브러리 | music.youtube.com의 내부 웹 API |
| 로그인 스트림 URL 해독 | yt-dlp의 EJS solver를 QuickJS에서 실행 |
| 함께 듣기 릴레이 | server/의 별도 Cloudflare Worker(workers-rs, Durable Objects) |
| 로그인 정보 보관 | Windows Credential Manager, macOS Keychain, Linux keyring |
함께 듣기 릴레이에는 오디오가 지나가지 않는다. 무엇을 어디까지 재생 중인지만 전달하고, 참가자마다 YouTube Music에서 직접 스트리밍한다. 로컬에서 돌리려면 server/에서 npx wrangler dev --local 후 YTM_JAM_SERVER=ws://127.0.0.1:8787로 앱을 띄운다.
주요 기능
| 분류 | 내용 |
|---|---|
| 듣기 | 홈 피드·믹스·차트·검색, 좋아요·재생목록·기록·업로드(파일 드래그), 팟캐스트(선택) |
| 재생 | 큐·라디오·셔플·크로스페이드, 음량 정규화, 10밴드 EQ, 재생 속도(음정도 같이 변함), 출력 장치 선택 |
| 음질 | Premium이면 Opus 약 256kbps, 아니면 약 130kbps |
| 노래 우선 | 공식 뮤직비디오를 앨범 녹음으로 재생. SponsorBlock 표시를 따라 말·스킷 구간 건너뜀 |
| 다운로드 | 커버·태그가 붙은 .m4a로 저장, 오프라인 재생 |
| 가사 | Better Lyrics 확장과 같은 단어 단위 가라오케 가사. 여러 소스 자동 대체, 로마자 표기·번역, 곡별 타이밍 보정 |
| 외형 | 테마 30종(Better Lyrics 커뮤니티 테마 27종 이식 + 자체 3종), 앨범 아트 애니메이션 배경, theme.conf로 전체 색 지정(wallust·pywal 연동) |
| 함께·연동 | 최대 16명 동시 청취(jam), Spotify 재생목록·좋아요 이전, Last.fm·ListenBrainz 스크로블, Discord Rich Presence |
| 데스크톱 | 시스템 미디어 컨트롤, 트레이, 미니 플레이어(Ctrl+M), 전역 단축키, 백그라운드 자동 업데이트·Nightly 채널 |
Spotify 이전은 매칭이 애매한 곡을 사용자에게 물어본 뒤 비공개 재생목록을 만든다. 중간에 끊겨도 이어서 진행한다.
설치
| 플랫폼 | 방법 |
|---|---|
| Windows | ytm-rs-setup-<버전>.exe. 관리자 권한 없이 현재 사용자에 설치. ARM PC만 -arm64 |
| macOS 11+ | Apple Silicon·Intel용 DMG. 공증되지 않아 첫 실행 때 우클릭 → 열기, 또는 xattr -dr com.apple.quarantine /Applications/ytm-rs.app |
| Linux | linux/install.sh를 curl로 받아 실행해 ~/.local/lib/ytm-rs에 설치, 또는 .deb(자동 업데이트 없음) |
| 포터블 | 세 플랫폼 모두. 설정은 앱 옆 data 폴더, 로그인은 여전히 시스템 저장소 |
소스 빌드는 cargo build --release다. Linux는 WebKitGTK·ALSA·GTK 개발 패키지가, macOS는 번들 스크립트(macos/bundle.sh)가 더 필요하다.
개인정보·외부 통신
PRIVACY.md는 앱 자체가 분석·텔레메트리·크래시 리포트를 보내지 않는다고 밝힌다. 대신 기능마다 어느 서비스에 무엇이 가는지 적어 두었다.
- 가사를 찾을 때 Better Lyrics 서버에 곡 ID·제목·아티스트·앨범·길이가 간다. 번역·로마자를 켜면 가사 줄도 간다. Better Lyrics가 못 하면 Google Translate로 간다.
- SponsorBlock에는 영상 ID 해시의 앞 4글자만 보낸다. 어떤 영상을 듣는지는 모른다.
- 함께 듣기 릴레이(
ytm-rs-jam.grapedjuice.workers.dev)는 방 코드·표시 이름·큐·재생 상태를 받는다. 방이 끝나면 지운다. - Spotify 이전은
code.thetadev.de에서 공개 파일 하나를 받아 온다. - GitHub에서 업데이트를 받는다. Premium이 없는 계정으로 연령 제한 곡을 틀면 yt-dlp도 받는다(Node.js 필요).
주의할 점
- 비공식 클라이언트다. README도 YouTube Music이나 다른 서비스가 바뀌면 재생·로그인·가사가 영향을 받을 수 있다고 적었다. 내부 API를 쓰고 스트림을 해독하고 곡을 내려받는 방식이 YouTube 약관과 맞는지는 저장소가 다루지 않는다.
- 메모리 비교표는 작성자가 한 PC에서 0.3.0으로 잰 값이다. 독립 측정이 아니다.
- 테마는 CSS 테마를 네이티브로 옮긴 것이라 원본과 세부가 다르다. 재배포할 수 없는 폰트(SF Pro 등)는 비슷한 오픈 폰트로 바꿨다.
- macOS 빌드는 공증되지 않았고, jam 링크가 macOS에서는 아직 앱을 열지 못한다.
- 이 노트는 README·PRIVACY.md·v0.3.3 릴리스 노트만 근거로 했다. 직접 설치하거나 실행해 보지는 않았다.
관련 노트
- 2026-10-11-github-iv-org-invidious — YouTube를 광고·추적 없이 보는 셀프 호스팅 웹 프런트엔드
- 2026-10-11-github-iv-org-invidious-companion — Invidious의 YouTube 스트림 수급 서비스. 스트림 해독 문제를 다른 방식으로 푼다
- 2026-10-04-github-longbridge-gpui-kit — 또 다른 Rust 네이티브 데스크톱 UI 프레임워크(GPUI). egui 비교 문서가 있다
- 2026-08-10-github-mintdotgg-bookshelf — 연출 중심의 로컬 음악 플레이어
- moc-multimedia