웹사이트를 숨은 브라우저로 띄우지 않고, 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.0Chrome 탭Pear Desktop 3.12.0
재생 중 메모리약 130MB496MB638MB
Windows 다운로드11MB–107MB
설치 크기36MB–397MB
내부에 브라우저 실행아니오예예

다만 완전히 웹 없이 돌지는 않는다. Google·Spotify 로그인과 가사 확인은 임시 시스템 웹뷰 창(Windows는 WebView2)을 연다. 앱을 켠 뒤 첫 곡은 YouTube 플레이어 준비로 5초쯤 걸리고, 그다음부터는 바로 시작한다.

구성 요소

부분쓰는 것
UIegui(즉시 모드 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 이전은 매칭이 애매한 곡을 사용자에게 물어본 뒤 비공개 재생목록을 만든다. 중간에 끊겨도 이어서 진행한다.

설치

플랫폼방법
Windowsytm-rs-setup-<버전>.exe. 관리자 권한 없이 현재 사용자에 설치. ARM PC만 -arm64
macOS 11+Apple Silicon·Intel용 DMG. 공증되지 않아 첫 실행 때 우클릭 → 열기, 또는 xattr -dr com.apple.quarantine /Applications/ytm-rs.app
Linuxlinux/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 릴리스 노트만 근거로 했다. 직접 설치하거나 실행해 보지는 않았다.

관련 노트