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 Desktop App (YTMDesktop), приложению YouTube Music для компьютера. Она использует Companion Server приложения, встроенный в версию 2.0.6 и новее. Вы один раз разрешаете доступ 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 секунд и после каждой неудачной попытки ждёт дольше, но не более минуты. Переменная 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 и кодом. Проверьте, что коды совпадают, и нажмите Allow в течение 30 секунд. Когда диалог в 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- 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, и само выключает его, после того как вы разрешили доступ какой-либо программе. Включите его, нажмите Продолжить и нажмите Allow в течение 30 секунд.
Что происходит, когда я закрываю приложение?
Переменная 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 прямо с панели.