Jellyfin
Входит в Macro DeckУправляйте приложениями и телевизорами Jellyfin с панели, показывайте, что играет, и реагируйте на начало и остановку воспроизведения.
Два виджета «Музыкальный проигрыватель», воспроизводящие трек, один в стиле «Полная обложка», другой в стиле «Маленькая обложка», оба с названием и логотипом Jellyfin в заголовке
- Управление воспроизведением и громкостью в приложениях, браузерах и на телевизорах Jellyfin
- Поиск и запуск фильма, эпизода, песни или альбома
- Триггеры начала, паузы, продолжения и остановки воспроизведения
- Виджеты «Музыкальный проигрыватель» и «Сеансы Jellyfin»
- Подключение нескольких серверов, у каждого свои переменные
Интеграция Jellyfin подключает Macro Deck к одному или нескольким медиасерверам Jellyfin и работает с их сеансами: приложениями Jellyfin, браузерами и телевизорами, которые вошли в систему и воспроизводят медиа. Плагин Jellyfin для этого не нужен. Вход выполняется с ключом API, который позволяет Macro Deck видеть все сеансы на сервере и управлять ими, или с именем пользователя и паролем, и тогда доступны только сеансы, которыми может управлять этот аккаунт.
Что можно делать
- Воспроизводить, ставить на паузу, останавливать, переключать, переходить к позиции или перематывать вперёд и назад на заданное число секунд.
- Задавать громкость, выключать и включать звук, настраивать перемешивание и повтор на клиенте.
- Искать на сервере фильм, эпизод, песню или альбом и запускать его на устройстве с помощью действия Воспроизвести медиа.
- Показывать на клиенте Jellyfin сообщение с заголовком.
- Показывать, что играет, в виджете Музыкальный проигрыватель, а воспроизведение на ваших серверах в виджете Сеансы Jellyfin.
- Запускать автоматизацию, когда воспроизведение начинается, ставится на паузу, продолжается или останавливается, когда меняется элемент или подключается клиент.
Несколько примеров:
- Кнопка Toggle Play/Pause для телевизора в гостиной, а рядом Перемотка назад, чтобы повторить последние 10 секунд.
- Автоматизация по триггеру Воспроизведение начато для телевизора, которая приглушает свет, если
{{ event.itemType }}равноMovie, и вторая по триггеру Воспроизведение остановлено, которая снова делает свет ярче. - Кнопка, которая показывает на телевизоре «Ужин готов» с помощью действия Показать сообщение.
Серверы и устройства
Каждый добавленный сервер появляется в двух вариантах везде, где выбирается проигрыватель. Вариант с названием сервера следует за тем сеансом, который последним что-то воспроизводил. Вариант Сервер · Устройство, например Home · Living Room TV, всегда обращается к этому устройству и показывается как неподключённое, пока устройство выключено. Macro Deck помнит устройства 30 дней после того, как видел их в последний раз.
В Jellyfin 10.11 и новее Macro Deck следит за сервером в реальном времени через WebSocket. Если сервер не отправляет живые обновления, Macro Deck вместо этого запрашивает сеансы каждые две секунды. Если сервер пропадает, Macro Deck продолжает попытки в фоне и после нескольких неудач сообщает об этом на странице Jellyfin в разделе Интеграции. Не каждый клиент Jellyfin поддерживает все команды: команда, которую клиент не может выполнить, завершается с сообщением.
Что понадобится
- Сервер Jellyfin, доступный по сети с компьютера, где работает Macro Deck.
- Ключ API из панели управления Jellyfin (рекомендуется) или имя пользователя и пароль Jellyfin.
- Jellyfin 10.11 или новее для живых обновлений. Без них Macro Deck запрашивает сеансы каждые две секунды.
Настройка
Шаг 1: Создайте ключ API в Jellyfin
Откройте панель управления Jellyfin и перейдите в API Keys. Создайте новый ключ и скопируйте его. Если вы предпочитаете входить с аккаунтом пользователя, пропустите этот шаг.
Шаг 2: Добавьте настройку в Macro Deck
В Macro Deck нажмите Интеграции на боковой панели и выберите Jellyfin. На вкладке Обзор нажмите Добавить настройку в разделе Настройка. Если включить переключатель в правом верхнем углу, откроется тот же диалог, а интеграция включится после завершения настройки.
Шаг 3: Введите данные сервера
В диалоге Подключение к Jellyfin заполните:
- Название настройки: название этого сервера, например
Home. Оно используется в названиях проигрывателей и переменных. - Адрес сервера: адрес с портом и базовым путём, если он есть, например
http://192.168.1.10:8096. - Войти с помощью: выберите Ключ API или Имя пользователя и пароль, затем введите Ключ API либо Имя пользователя и Пароль.
Нажмите Продолжить. Macro Deck проверяет подключение перед сохранением.
- Название настройки: название этого сервера, например
Шаг 4: Проверьте подключение
Новая настройка показывает статус Подключено в разделе Настройка на странице Jellyfin. Повторите эти шаги для каждого следующего сервера.
Шаг 5: Добавьте действие на кнопку
На странице Панель нажмите на кнопку, которую хотите использовать. Панель должна быть разблокирована: если кнопка в правом верхнем углу называется Заблокировать, панель разблокирована. Откроется редактор, в котором выбран триггер Короткое нажатие. Нажмите + Добавить действие, слева в диалоге Добавить действие выберите Jellyfin и затем действие, например Toggle Play/Pause. Укажите сервер или устройство, которым оно управляет, и нажмите Сохранить.
Шаг 6: Нажмите кнопку
Включите что-нибудь на клиенте Jellyfin и нажмите кнопку на панели. Воспроизведение на этом клиенте встанет на паузу или продолжится.
Действия20
Назначьте их на кнопку или запускайте из цепочки действий.
- Play
- Продолжает воспроизведение на клиенте.
- Pause
- Ставит воспроизведение на клиенте на паузу.
- Toggle Play/Pause
- Переключает между воспроизведением и паузой и показывает состояние воспроизведения на кнопке.
- Остановить
- Останавливает воспроизведение на клиенте.
- Next Track
- Переходит к следующему элементу.
- Previous Track
- Переходит к предыдущему элементу.
- Refresh State
- Сразу считывает текущее состояние воспроизведения.
- Seek
- Переходит к позиции в текущем элементе, в секундах.
- Перемотка вперёд
- Перематывает текущий элемент вперёд, по умолчанию на 30 секунд.
- Перемотка назад
- Перематывает текущий элемент назад, по умолчанию на 10 секунд.
- Set Volume
- Задаёт громкость клиента от 0 до 100%.
- Volume Up
- Повышает громкость на 10%.
- Volume Down
- Понижает громкость на 10%.
- Выключить звук
- Выключает звук клиента.
- Включить звук
- Снова включает звук клиента.
- Переключить звук
- Выключает или включает звук клиента.
- Toggle Shuffle
- Включает, выключает или переключает перемешивание.
- Set Repeat Mode
- Задаёт режим повтора Off, Repeat Track или Repeat Album/Playlist.
- Показать сообщение
- Показывает на клиенте сообщение с заголовком на заданное число секунд.
- Воспроизвести медиа
- Ищет фильм, эпизод, песню или альбом и запускает его на клиенте вместо того, что там играет.
Триггеры9
Кнопка или цепочка действий может реагировать на эти события.
- Воспроизведение начато
- Сеанс начал что-то воспроизводить.
- Воспроизведение приостановлено
- Воспроизведение в сеансе поставлено на паузу.
- Воспроизведение продолжено
- Приостановленное воспроизведение в сеансе продолжилось.
- Воспроизведение остановлено
- Сеанс остановил воспроизведение.
- Изменился воспроизводимый элемент
- Сеанс перешёл к другому фильму, эпизоду или треку.
- Сеанс подключён
- Клиент Jellyfin открыл сеанс на сервере.
- Сеанс отключён
- Сервер закрыл сеанс клиента.
- Подключено
- Macro Deck подключился к серверу.
- Отключено
- Macro Deck потерял подключение к серверу.
Переменные7
Показывайте эти значения на кнопках и виджетах или используйте их в условиях.
jellyfin_active_sessions- Сеансы, которые воспроизводят или стоят на паузе, на всех серверах вместе.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- Есть ли у Macro Deck связь с каждым сервером и сколько на нём идёт сеансов.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- Играет ли что-то на устройстве, стоит ли на паузе и загружено ли. Запись в переменную воспроизведения или паузы запускает воспроизведение или ставит паузу.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- Название, сериал, альбом (или сезон) и тип медиа элемента на каждом устройстве.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- Позиция и длительность в секундах и прогресс в процентах. Запись в позицию или прогресс переходит к этой точке.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- Пользователь, клиент и устройство каждого сеанса, а также перекодирует ли сервер медиа.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- Громкость и состояние звука каждого устройства, если оно их сообщает. Запись в них задаёт громкость или выключает звук.
Виджеты2
Добавляйте их на свою панель в окне выбора виджета.
- Музыкальный проигрыватель
- Показывает, что играет на сервере или устройстве, с обложкой, прогрессом и кнопками воспроизведения, паузы и переключения. Строки подстраиваются под песни, эпизоды и фильмы.
- Сеансы Jellyfin
- Показывает, что играет на одном или всех ваших серверах, с обложкой или постером, кто смотрит, на каком устройстве и сколько уже просмотрено.
Часто задаваемые вопросы
Что лучше: ключ API или имя пользователя и пароль?
Рекомендуется ключ API: тогда Macro Deck видит все сеансы на сервере и управляет ими. С именем пользователя и паролем видны только сеансы, которыми может управлять этот аккаунт. Пароль используется один раз для входа и не сохраняется: Macro Deck хранит только токен доступа, который выдаёт Jellyfin.
Можно ли подключить несколько серверов?
Да. Добавьте по одной настройке на каждый сервер. У каждой свои переменные, названные по настройке, и каждая показывает, подключена ли она.
Почему команда не выполняется на телевизоре или в браузере?
Не каждый клиент Jellyfin поддерживает все команды. Macro Deck отправляет только то, что клиент заявляет как поддерживаемое, поэтому команда, которую он не может выполнить, завершается с сообщением. Громкость и выключение звука обычно работают только в приложениях Jellyfin, а не во вкладке браузера.
Что происходит, когда сервер недоступен?
Macro Deck продолжает попытки в фоне и после нескольких неудач показывает проблему Сервер Jellyfin недоступен на странице Jellyfin в разделе Интеграции. Действия для этого сервера завершаются с сообщением, пока он не вернётся.
Какие триггеры использовать: Jellyfin или «Музыкальный проигрыватель»?
Триггеры музыкального проигрывателя, например Воспроизведение начато в разделе Музыкальный проигрыватель, тоже срабатывают для Jellyfin: один раз для сервера и один раз для устройства. Для автоматизаций лучше подходят триггеры Jellyfin: они срабатывают один раз на устройство и передают пользователя и тип медиа.
Ещё в группе «Музыка и звук»
Spotify
Входит в Macro DeckУправляйте воспроизведением Spotify, отмечайте понравившиеся треки, работайте с плейлистами и показывайте на панели, что сейчас играет.
YouTube Music Desktop App
Входит в Macro DeckУправляйте YouTube Music Desktop App с панели: воспроизведение, громкость, оценки и то, что сейчас играет.
WebNowPlaying
Входит в Macro DeckУправляйте музыкой и видео в браузере и показывайте, что играет, с помощью расширения WebNowPlaying.
SoundPad
Входит в Macro DeckВоспроизводите звуки из списка SoundPad, управляйте записью и показывайте на панели играющий звук.
Voicemeeter
Входит в Macro DeckУправляйте усилением, звуком, маршрутизацией и макрокнопками Voicemeeter, Banana или Potato прямо с панели.