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 зі своєї панелі.