YouTube Music Desktop App
Входить до Macro DeckКеруйте YouTube Music Desktop App зі своєї панелі: відтворення, гучність, оцінки й те, що грає.
Два віджети «Музичний програвач», що відтворюють трек, один у стилі «Повна обкладинка», другий у стилі «Мала обкладинка», обидва з назвою та логотипом YouTube Music Desktop App у заголовку
- Відтворення, пауза, перемикання, перемотування, перемішування, повтор і гучність
- Ставте «Подобається», «Не подобається» або скидайте оцінку поточного треку
- Запускайте відео чи плейлист за посиланням або ідентифікатором
- Живі оновлення через Companion Server застосунку
- Віджет «Музичний програвач» і змінні для треку, виконавця й прогресу
Інтеграція YouTube Music Desktop App під’єднує Macro Deck до YouTube Music Desktop App (YTMDesktop), настільного застосунку для YouTube Music. Вона використовує Companion Server застосунку, вбудований у версію 2.0.6 і новіші. Ви один раз дозволяєте Macro Deck у застосунку, і відтоді він сам під’єднується щоразу, коли застосунок працює.
Що можна робити
- Відтворювати, ставити на паузу, перемикати, перемотувати, вмикати чи вимикати перемішування, задавати режим повтору й змінювати гучність.
- Вимикати чи вмикати звук застосунку.
- Ставити поточному треку «Подобається» або «Не подобається», скидати його оцінку або перемикати «Подобається» чи «Не подобається».
- Запускати трек з поточної черги чи одного з ваших плейлистів або вибирати його під час натискання кнопки.
- Запускати певне відео чи плейлист за посиланням YouTube Music, посиланням youtu.be, ідентифікатором відео або плейлиста.
- Показувати, що грає, у віджеті Музичний програвач з обкладинкою, прогресом і кнопками відтворення й перемикання.
- Реагувати потоком, коли треку ставлять «Подобається», «Не подобається» або скидають оцінку.
Кілька прикладів:
- Кнопка Toggle Play/Pause, яка показує, чи музика грає або стоїть на паузі.
- Кнопка вподобання з дією Оцінити трек у режимі Перемкнути «Подобається», підпис якої прив’язано до
ytmdesktop_like_status. - Кнопка з дією Відтворити відео або URL, яка запускає ваш плейлист для зосередження за його посиланням YouTube Music.
- Повзунок, прив’язаний до
ytmdesktop_volume, який слідує за гучністю застосунку й змінює її, поки ви його тягнете.
Як це працює
Macro Deck тримає живе з’єднання з Companion Server, тож зміни, зроблені в застосунку, одразу з’являються на панелі. Коли застосунок закривається, Macro Deck пробує знову через 5 секунд і після кожної невдалої спроби чекає довше, але не більше хвилини. Змінна ytmdesktop_is_connected показує, чи застосунок доступний. Якщо доступ вилучено в застосунку, проблема YouTube Music Desktop App відхилив авторизацію на сторінці інтеграції попросить виконати налаштування знову. Типово Macro Deck шукає застосунок на тому самому комп’ютері. У розділі Додаткова конфігурація налаштування можна вказати адресу іншого комп’ютера. Можна налаштувати один YouTube Music Desktop App.
Що потрібно
- YouTube Music Desktop App 2.0.6 або новіший. Версія 1 не має Companion Server.
- Companion Server, увімкнений у застосунку в розділі Settings > Integrations.
- Companion Authorization, увімкнений на час налаштування Macro Deck.
Як налаштувати
Крок 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, ідентифікатором відео або плейлиста.
Тригери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 поточного треку.
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 або новіша і що Companion Server увімкнено в розділі Settings > Integrations. Потім знову натисніть Продовжити.
Чому налаштування знову просить увімкнути Companion Authorization?
Застосунок приймає нові запити на авторизацію, лише поки ввімкнено Companion Authorization, і сам вимикає його після того, як ви дозволили застосунок. Увімкніть його, натисніть Продовжити і протягом 30 секунд натисніть Allow.
Що станеться, коли я закрию застосунок?
Змінна ytmdesktop_is_connected матиме значення false, віджет «Музичний програвач» покаже, що YouTube Music не запущено, а дії завершуватимуться повідомленням, що застосунок не під’єднано. Коли ви знову запустите застосунок, Macro Deck сам під’єднається протягом хвилини.
Більше в категорії «Музика та звук»
Spotify
Входить до Macro DeckКеруйте відтворенням Spotify, додавайте пісні до улюблених, керуйте плейлистами й показуйте, що грає, на своїй панелі.
WebNowPlaying
Входить до Macro DeckКеруйте музикою й відео в браузері та показуйте, що грає, через розширення WebNowPlaying.
Jellyfin
Входить до Macro DeckКеруйте застосунками й телевізорами Jellyfin зі своєї панелі, показуйте, що відтворюється, і реагуйте на початок чи зупинку відтворення.
SoundPad
Входить до Macro DeckВідтворюйте звуки зі списку SoundPad, керуйте записами й показуйте поточний звук на панелі.
Voicemeeter
Входить до Macro DeckКеруйте підсиленням, вимкненням звуку, маршрутизацією й макрокнопками Voicemeeter, Banana або Potato зі своєї панелі.