YouTube Music Desktop App
Macro Deck에 포함덱에서 YouTube Music Desktop App의 재생, 볼륨, 평가를 제어하고 재생 중인 곡을 확인하세요.
헤더에 YouTube Music Desktop App 이름과 로고가 있고 트랙을 재생 중인 전체 커버 스타일과 작은 커버 스타일의 음악 플레이어 위젯 두 개
- 재생, 일시 정지, 건너뛰기, 탐색, 셔플, 반복, 볼륨
- 현재 트랙에 좋아요, 싫어요 또는 평가 지우기
- 링크나 ID로 동영상 또는 재생 목록 시작
- 앱의 Companion Server를 통한 실시간 업데이트
- 트랙, 아티스트, 진행률을 위한 음악 플레이어 위젯과 변수
YouTube Music Desktop App 연동은 Macro Deck을 YouTube Music용 데스크톱 앱인 YouTube Music Desktop App(YTMDesktop)에 연결합니다. 버전 2.0.6 이상에 내장된 앱의 Companion Server를 사용합니다. 앱에서 Macro Deck을 한 번 허용하면, 그 후로는 앱이 실행될 때마다 Macro Deck이 스스로 연결합니다.
할 수 있는 일
- 재생, 일시 정지, 건너뛰기, 탐색, 셔플 켜기 또는 끄기, 반복 모드 설정, 볼륨 변경.
- 앱 음소거 또는 음소거 해제.
- 현재 트랙에 좋아요나 싫어요를 표시하거나, 평가를 지우거나, 좋아요나 싫어요를 켜고 끕니다.
- 현재 대기열이나 내 재생 목록의 트랙을 시작하거나, 버튼을 누를 때 고릅니다.
- YouTube Music 링크, youtu.be 링크, 동영상 ID 또는 재생 목록 ID로 특정 동영상이나 재생 목록을 시작합니다.
- 음악 플레이어 위젯에 커버, 진행률, 재생 및 건너뛰기 버튼과 함께 재생 중인 곡을 표시합니다.
- 트랙에 좋아요나 싫어요가 표시되거나 평가가 지워지면 흐름으로 반응합니다.
활용 예:
- 음악이 재생 중인지 일시 정지되었는지 보여 주는 Toggle Play/Pause 버튼.
- 좋아요 전환 모드의 트랙 평가가 들어 있고 라벨이
ytmdesktop_like_status에 연결된 좋아요 버튼. - 동영상 또는 URL 재생으로 YouTube Music 링크에서 집중용 재생 목록을 시작하는 버튼.
ytmdesktop_volume에 연결되어 앱의 볼륨을 따라가고, 드래그하면 볼륨을 바꾸는 슬라이더.
동작 방식
Macro Deck은 Companion Server와 실시간 연결을 유지하므로 앱에서 바꾼 내용이 덱에 바로 나타납니다. 앱이 닫히면 Macro Deck은 5초 후에 다시 시도하고, 시도가 실패할 때마다 최대 1분까지 더 오래 기다립니다. ytmdesktop_is_connected 변수는 앱에 접속할 수 있는지 보여 줍니다. 앱에서 접근 권한이 제거되면 연동 페이지에 YouTube Music Desktop App이 인증을 거부함 문제가 표시되어 설정을 다시 실행하라고 안내합니다. 기본적으로 Macro Deck은 같은 컴퓨터에서 앱을 찾습니다. 설정의 고급 설정에서 다른 컴퓨터의 주소를 입력할 수 있습니다. YouTube Music Desktop App은 하나만 설정할 수 있습니다.
준비물
- YouTube Music Desktop App 2.0.6 이상. 버전 1에는 Companion Server가 없습니다.
- 앱의 Settings > Integrations에서 켠 Companion Server.
- Macro Deck을 설정하는 동안 켜 둔 Companion Authorization.
설정하기
1단계: YouTube Music Desktop App 설치
YouTube Music Desktop App 2.0.6 이상을 설치하고 시작하세요. Macro Deck의 설정 대화 상자에 앱의 릴리스 페이지 링크가 있습니다.
2단계: Companion Server 켜기
YouTube Music Desktop App에서 Settings > Integrations로 이동하세요. Companion Server와 Companion Authorization을 켜세요. Macro Deck을 허용하고 나면 앱이 인증을 자동으로 다시 끕니다.
3단계: Macro Deck에서 설정 시작
Macro Deck의 사이드바에서 연동을 클릭하고 YouTube Music Desktop App을 클릭하세요. 개요 탭의 구성 섹션에서 설정을 클릭하세요. 오른쪽 위의 스위치를 켜도 같은 대화 상자가 열리며, 설정을 마치면 연동이 켜집니다. Companion Server 켜기 대화 상자에는 채울 필드가 없습니다. 앱이 다른 컴퓨터에서 실행 중이면 고급 설정을 켜고 그 컴퓨터의 주소를 입력하세요. 포트는
9863으로 두세요. 계속을 클릭하세요.4단계: 앱에서 Macro Deck 허용
이제 대화 상자에 인증 코드와 함께 Macro Deck 허용이 표시됩니다. 계속을 클릭하면 YouTube Music Desktop App에 Macro Deck과 코드가 표시된 승인 창이 열립니다. 코드가 일치하는지 확인하고 30초 안에 Allow를 클릭하세요. Macro Deck의 대화 상자에 **설정이 완료되었습니다.**가 표시되면 완료를 클릭하세요.
5단계: 버튼에 액션 추가
덱 페이지에서 사용할 버튼을 클릭하세요. 덱의 잠금이 해제되어 있어야 하며, 오른쪽 위 버튼에 잠금이라고 표시되어 있으면 해제된 상태입니다. 짧게 누르기가 선택된 상태로 편집기가 열립니다. + 액션 추가를 클릭하고 액션 추가 대화 상자 왼쪽에서 YouTube Music Desktop App을 선택한 다음 Toggle Play/Pause나 트랙 평가 같은 액션을 고르세요. 그런 다음 저장을 클릭하세요.
6단계: 버튼 누르기
YouTube Music Desktop App에서 곡을 재생하고 덱에서 버튼을 누르세요. 재생이 일시 정지되거나 다시 시작됩니다.
액션17
버튼에 넣거나 흐름에서 실행하세요.
- Play
- 재생을 다시 시작합니다.
- Pause
- 재생을 일시 정지합니다.
- Toggle Play/Pause
- 재생과 일시 정지를 전환하고, 버튼에 재생 상태를 표시합니다.
- Next Track
- 다음 트랙으로 건너뜁니다.
- Previous Track
- 이전 트랙으로 건너뜁니다.
- Refresh State
- 현재 재생 상태를 즉시 읽습니다.
- Set Volume
- 앱의 볼륨을 0~100%로 설정합니다.
- Volume Up
- 볼륨을 10% 높입니다.
- Volume Down
- 볼륨을 10% 낮춥니다.
- Seek
- 현재 트랙의 특정 위치(초)로 이동합니다.
- Toggle Shuffle
- 셔플을 켜거나 끄거나 전환하고, 켜져 있는지 표시합니다.
- Set Repeat Mode
- 반복을 Off, Repeat Track, Repeat Album/Playlist 중 하나로 설정합니다.
- Play Track
- 현재 대기열의 트랙을 재생하거나, 액션이 실행될 때 고르라고 묻습니다.
- Play Playlist
- 내 재생 목록 중 하나를 재생하거나, 액션이 실행될 때 고르라고 묻습니다.
- 트랙 평가
- 현재 트랙에 좋아요나 싫어요를 표시하거나 평가를 지우거나, 좋아요나 싫어요를 켜고 끕니다.
- 음소거
- 앱을 음소거하거나, 음소거를 해제하거나, 전환합니다.
- 동영상 또는 URL 재생
- YouTube Music 링크, youtu.be 링크, 동영상 ID 또는 재생 목록 ID로 동영상이나 재생 목록을 시작합니다.
트리거8
버튼이나 흐름이 이 이벤트에 반응할 수 있습니다.
- 평가 변경됨
- 현재 트랙에 좋아요나 싫어요가 표시되었거나 평가가 지워졌습니다. 특정 평가로 한정할 수도 있습니다.
- 트랙 변경됨
- 다른 트랙이 재생되기 시작했으며, 제목, 아티스트, 앨범을 함께 제공합니다(음악 플레이어 아래).
- 재생 시작됨
- 재생이 시작되었거나 다시 시작되었습니다(음악 플레이어 아래).
- 재생 일시 중지됨
- 재생이 일시 정지되었습니다(음악 플레이어 아래).
- 재생 중지됨
- 재생이 중지되었습니다(음악 플레이어 아래).
- 볼륨 변경됨
- 볼륨이 바뀌었으며, 새 값과 이전 값을 함께 제공합니다(음악 플레이어 아래).
- 플레이어 연결됨
- 앱에 접속할 수 있게 되었습니다(음악 플레이어 아래).
- 플레이어 연결 끊김
- 앱에 더 이상 접속할 수 없습니다(음악 플레이어 아래).
변수21
버튼과 위젯에 이 값을 표시하거나 조건에 사용하세요.
ytmdesktop_is_connected- Macro Deck이 앱에 연결되어 있는지 여부입니다.
ytmdesktop_current_track_name- 현재 트랙의 제목입니다.
ytmdesktop_current_artist- 현재 트랙의 아티스트입니다.
ytmdesktop_current_album- 현재 트랙의 앨범입니다.
ytmdesktop_album_art_url- Macro Deck에 있는 현재 커버의 주소입니다.
ytmdesktop_playback_state- 재생 상태입니다:
playing,paused또는stopped. ytmdesktop_is_playing- 지금 음악이 재생 중인지 여부입니다.
ytmdesktop_current_position- 트랙이 재생된 시간(초)입니다. 설정하면 그 위치로 이동합니다.
ytmdesktop_track_duration- 현재 트랙의 길이(초)입니다.
ytmdesktop_progress_percentage- 트랙이 재생된 정도(퍼센트)입니다.
ytmdesktop_volume- 앱의 볼륨(퍼센트)입니다. 슬라이더 등으로 설정할 수도 있습니다.
ytmdesktop_is_muted- 앱이 음소거되었는지 여부입니다.
ytmdesktop_like_status- 현재 트랙의 평가입니다:
like,dislike또는indifferent. ytmdesktop_is_liked- 현재 트랙에 좋아요가 표시되어 있는지 여부입니다.
ytmdesktop_shuffle_enabled- 셔플이 켜져 있는지 여부입니다.
ytmdesktop_repeat_mode- 반복 모드입니다:
off,track또는context. ytmdesktop_is_live- 현재 항목이 라이브 스트림인지 여부입니다.
ytmdesktop_media_type- 현재 항목의 종류입니다:
audio,video,uploaded또는podcast. ytmdesktop_ad_playing- 지금 광고가 재생 중인지 여부입니다.
ytmdesktop_video_id- 현재 트랙의 YouTube ID입니다.
ytmdesktop_device_name- 재생 소스로 표시되는 이름입니다.
위젯1
위젯 선택기에서 덱에 추가하세요.
- 음악 플레이어
- YouTube Music Desktop App이 재생하는 트랙, 아티스트, 커버를 진행률 및 재생, 일시 정지, 건너뛰기 버튼과 함께 표시합니다.
자주 묻는 질문
브라우저의 YouTube Music에서도 동작하나요?
아니요. 이 연동은 YouTube Music Desktop App과만 통신합니다. 브라우저 탭의 YouTube Music에는 브라우저 확장 프로그램과 함께 WebNowPlaying 연동을 사용하세요.
Macro Deck이 다른 컴퓨터의 앱을 제어할 수 있나요?
네. 설정 중에 고급 설정을 켜고 YouTube Music Desktop App이 실행 중인 컴퓨터의 주소를 입력하세요.
설정에서 앱에 접속할 수 없다고 나옵니다. 어떻게 해야 하나요?
YouTube Music Desktop App이 실행 중인지, 버전이 2.0.6 이상인지, Settings > Integrations에서 Companion Server가 켜져 있는지 확인하세요. 그런 다음 계속을 다시 누르세요.
설정에서 Companion Authorization을 다시 켜라고 하는 이유는 무엇인가요?
앱은 Companion Authorization이 켜져 있을 때만 새 인증 요청을 받으며, 앱을 하나 허용하면 이 설정을 자동으로 끕니다. 설정을 켜고 계속을 누른 다음 30초 안에 Allow를 클릭하세요.
앱을 닫으면 어떻게 되나요?
ytmdesktop_is_connected 변수가 false가 되고, 음악 플레이어 위젯에 YouTube Music이 실행 중이 아니라고 표시되며, 액션은 앱이 연결되어 있지 않다는 메시지와 함께 실패합니다. 앱을 다시 시작하면 Macro Deck이 1분 안에 스스로 다시 연결합니다.
음악 및 오디오의 다른 연동
Spotify
Macro Deck에 포함Spotify 재생을 제어하고, 곡에 좋아요를 표시하고, 재생 목록을 관리하고, 재생 중인 곡을 덱에 표시하세요.
WebNowPlaying
Macro Deck에 포함WebNowPlaying 확장 프로그램으로 브라우저에서 재생 중인 음악과 동영상을 제어하고 재생 중인 내용을 표시하세요.
Jellyfin
Macro Deck에 포함덱에서 Jellyfin 앱과 TV를 제어하고, 재생 중인 내용을 표시하고, 재생이 시작되거나 멈출 때 반응하세요.
SoundPad
Macro Deck에 포함SoundPad 목록의 사운드를 재생하고, 녹음을 제어하고, 재생 중인 사운드를 덱에 표시하세요.
Voicemeeter
Macro Deck에 포함덱에서 Voicemeeter, Banana, Potato의 게인, 음소거, 라우팅, 매크로 버튼을 제어하세요.