Homeassistant Musicassistant YoutubeMusic token 갱신 추출 등록 방법

홈어시스턴트에서 유튜브 뮤직 사용 연동 하는 방법

 

 

 

https://github.com/music-assistant/beta.music-assistant.io/blob/main/docs/music-providers/youtube-music.md#installing-the-po-token-addon

beta.music-assistant.io/docs/music-providers/youtube-music.md at main · music-assistant/beta.music-assistant.io

 

뮤직어시스턴트에서 유튜브 뮤직이 연결이 해제 됐길래 다시 연결해 보려고 자료를 찾아보던 중

앞으로는 유튜브 뮤직 프로바이더를 연동하려면

 

위의 깃허브 주소에서 별도의 에드온을 하나 더 설치해줘야 한다고 합니다.

 

---

PO Token Generator 에드온 설치

 

As of Nov 2024, Google has removed OAuth authentication from YT Music. This means using this (somewhat cumbersome) method of cookie authentication is the only way to get YT Music working.

 

2024년 11월부터 Google은 YouTube Music에서 OAuth 인증을 제거했습니다. 즉, 이 (다소 번거로운) 쿠키 인증 방식을 사용하는 것이 YouTube Music을 작동시키는 유일한 방법입니다.

 

 

As of March 2025, Google has implemented a new security mechanism called 'PO Tokens' (Proof of Origin). Music Assistant will not be able to resolve stream urls for your music without a valid PO Token. Luckily, we can automatically generate this for you, but you will need to install an add-on (also available as a docker image) for this.

 

2025년 3월부터 Google은 'PO 토큰'(원점 증명)이라는 새로운 보안 메커니즘을 구현했습니다. 유효한 PO 토큰이 없으면 Music Assistant에서 음악의 스트리밍 URL을 확인할 수 없습니다. 다행히 저희가 자동으로 생성해 드릴 수 있지만, 이를 위해서는 애드온(도커 이미지로도 제공)을 설치해야 합니다.

 

 

 

 

 

위의 깃허브에서 하라는데로 쿠키를 복사하시면 됩니다.

 

그냥 로그인 이후 아무 쿠키값 찾아서 그대로 복사하면 됩니다.

 

username에는 구글 이메일 주소 또는 브랜드 계정을 입력하면 되고 

 

 

토큰값은 아래와 같은 쿠키값을 통째로 붙여 넣으면 됩니다

 

 

 

그리고 ITunes Podcast Search 를 추가해주면 potcast에서 검색해서 들을수 있습니다.

 

 

 

홈어시스턴트에서 musicassistant를 사용하면 편리하고 좋다. 꼭 사용해야 될 에드온인 것 같습니다.

 

 

01-White-Noise-10min.mp3

9.17MB

 

 

---

251219 뮤직어시스턴트 연동 관련 내용 추가

 

뮤직어시스턴트는 에드온 개발중에서 가장 핫하고 유저들에게도 가장 인기있는 에드온 인거 같습니다.

뮤직어시스턴트 개발을 하시는분들은 현재 이걸 유료화 할 목적이 있는것 처럼 보입니다.

 

최근 뮤직어시스턴트에서는 로그인/프로필 기반 기능이 추가되고 있고 이런 부분은 SaaS/유료화를 염두에 두고 개발되는 경우가 많습니다.

 

지극히 개인적인 저의 생각으로는

프로젝트 코어는 무료로 남겨두되, 고급 기능(예: 원격 스트리밍, 클라우드 동기화, 가족 사용자 관리 등)은 

정기적 지불을 유도하는 구독형 서비스로 바뀔 수도 있을것 같습니다.

 

즉 일부는 무료, 일부는 유료로 전환될 가능성이 존재하기 때문에, 무료를 좋아하신다면 너무 뮤직어시스턴트에 의존하는 자동화는 비권장 드립니다.

 

그래도 좋은 기능을 열심히 개발하고 계신 개발자들이 어떤 기능들을 유료로 전환할지 향후 비교하는 글을 작성하도록 하겠습니다.

 

자 여기까지가 유료화에 대한 저의 생각이였고요

 

---

뮤직어시스턴트에는 여러가지 프로바이더를 지원합니다.

한국 사람들은 유튜브 프리미엄 구독자들이 많이 때문에 유튜브 뮤직으로 노래를 같이 듣고 계신분들이 있습니다.

유튜브 뮤직은 다른 프로바이더보다 시장에서 부족한점이 많다고 생각하지만 나름 유저가 사용법만 잘알고 있다면 스포티파이나, 멜론 같은 프로바이더 처럼 동일하게 사용할수 있는거 같습니다.

 

최근 구글 보안 정책으로 인해 쿠키 재사용이 보안이 강화 되었습니다.

이에 따라서 본문 상단에 설명 드린 방식으로 토큰을 연동하여야 하는데요

 

이게 뮤직어시스턴트 베타버전에서는 빠르게 대응이 가능한 부분이지만

일반 버전에서는 연동이 되지 않아서 저는 요즘 배타버전을 사용중입니다.

 

 

NIGHILY 버전 에드온의 경우, 새로운 UI와 새로운 기능들이 존재하여, 빠르게 접해볼수 있지만, 사용이 불안정해서 현재 사용하지 않고 베타버전으로 정착해서 사용중입니다.

 

그래서 뭐~ 빨리 알려달라고요?

 

네네 그래서 결론은 베타버전에서 연동을 진행하셔야 된다는 말입니다.

 

그럼 본문의 상단에서 쿠키의 정보들을 고대로 복사해서 배타버전에서 사용하신다면 잘 연동되고 사용이 되신다는 뜻입니다.

 

---

 

자 그럼 여기서 쿠키 세션 토큰 이란 개념을 알고 가시면 좋은데요

 

쿠키란 브라우저가 서버에게 나 누구인지 계속 알려주기 위해 저장하는 작은 정보 입니다.

 

특징은 브라우저(클라이언트)에 저장됩니다.

 

HTTP 헤더의 형태는 이런식입니다.

 

Cookie: SID=abcd1234; HSID=xyz789;

 

세션은 서버쪽에 있는 로그인 상태 정보 입니다.

 

 

토큰이란 내가 인증됨을 증명하는 독립적인 증표를 의미 합니다.

 

HTTP 헤더의 형태는 이런식 입니다.

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...

 

토큰(OAuth, JWT)의 특징은 서버에 세션을 저장안하고 토큰 자체에 권한 정보를 포함합니다.

 

즉 쿠키든 토큰이든 탈취가 된다면, 패스워드를 알고 있지 않아도 로그인 한 상태의 권한이 탈취가 되게 됩니다.

패스워드를 변경해도 연결된 기기를 로그아웃 처리하지 않는다면 계속 로그인 정보를 탈취하게 되는겁니다.

 

자 그러니까 쿠키, 토큰 , API키 등은 탈취되면 안되겠지요???

 

일단 여기까지가 쿠키 세션 토큰에 대한 간단한 개념을 설명 드렸습니다.

 

 

 

 

---

뮤직어시스턴트 연동 꿀팁

 

보통 장기 액세스 토큰은 중복 로그인을 허용하고

쿠키/세션의 경우에는 중복로그인을 검사할 수 있지만, 중복 로그인을 허용해서 쓰는곳이 많습니다.

유튜브 뮤직의 경우에도 중복로그인을 허용해주기 때문에 뮤직어시스턴트를 사용할수 있는겁니다.

 

자 그럼 여기서 문제.

새로운 로그인을 할때마다 새로운 쿠키가 발급되는데

그 새로운 쿠키를 가지고 여러곳에서 사용하면 어떻게 될까요??

 

당연히 유튜브뮤직 쪽에서는 불법적인 접근이라고 판단할 겁니다.

 

즉 브라우저 시크릿모드에서 신규 로그인하셔서 쿠키정보를 얻어 내시고, (로그아웃하지말고) 브라우저 창을 닫으세요

 

해당 쿠키는 오피셜로는 만료기간이 6개월 정도까지라고 하니 한번 해두면 6개월은 쓰실수 있을겁니다.

 

깃허브 가이드에는 browser 라고 필터걸어서 그 쿠키값을 사용하라고 되어 있는데, 로그인 이후의 쿠키는 브라우저에 전부 저장되기 때문에 꼭 그 쿠키값만 사용해야 되는것이 아닙니다.

 

 

이해 되셨을까요??

 

 

---

자동화 꿀팁

 

자 그럼 이제 유튜브 뮤직을 연동해서 어떻게 사용하고 있는지 소개가 빠질수 없겠지요?

저는 라디오 프로바이더는 AI가 추천해준 이걸 쓰고 있습니다. 

 

 

자동화는 이런식으로 구성했습니다.

 

1분 51초가 되면 노래 재생하고

 

현재 배타버전에서 10분이 지나면 대기큐에 노래가 꺼지기 때문에 10분이 지나면 정지하고 다시 노래를 틀어주는 방식입니다.

 

 

 

 

 

이런식으로 노래를 재생하면 되는데요

 

 

 

 

해당 정보는 플레이리스트 Show info에 들어가서 

 

 

하단 Provider details 에 정보가 있습니다.

 

 

---

유튜브 뮤직 쿠키값 가져오는 방법

 

쿠키 추출을 어떻게 복사 하는지 알려드리겠습니다

 

 

크롬 브라우저 창에서 F12를 누릅니다.

그럼 네트워크 탭이 있습니다. 여기서 F5를 눌러 페이지를 새로 받아 옵니다.

 

 

그럼 왼쪽에 있는 index-어쩌구.js 

favicon.svg 이러면서 쭈르르 목록들이 보이시죠?

하나하나 눌러보시면

헤더 정보를 보실수 있습니다.

 

거기서 Response Headers에 적힌 Set-Cookie 정보는 아니구요

Request Headers 에 적힌 빨간색으로 적힌 부분을 마우스로 드레그해서 우측 마우스를 눌러 복사를 누르시면 됩니다.

 

 

 

복사한 값을 메모장에 저장해주시고 브라우저를 닫습니다.

 

뮤직어시스턴트 프로바이더에서 유튜브뮤직을 추가해주시고 Login Cookie 에 붙여넣기 해주시면 됩니다.

 

 

 

 

이상으로 마무리 하겠습니다.

 

행복한 스마트홈 되세요~