SqueezeboxRPC: контроллер для медиасервера Logitech по протоколу RPC

Это альтернативный адаптер, использующийJSON/RPC -протокол для получения данных и отправки команд на медиасервер Logitech/Lyrion ( LMS ) для управления подключенными устройствами, такими как

• нативный Squeezebox ,
• Raspberry Pi с дополнительным аудиомодулем и небольшими прошивками на базе Linux, такими как PicorePlayer или Max2Play .
• WiiM Multiroom Audio ( может взаимодействовать с сервером LMS/Lyrion )
• с плагинами Chromecast, AirPlay илиUPnP/DLNA -Устройства

ОнLMS - Сервер может управлять/предоставлять очень большие музыкальные коллекции на жестких дисках илиNAS подключайтесь к различным потоковым сервисам, например:Spotify ,Deezer ,Soundcloud ,shoutcast ,tunein ,napster ,pandora ,tidal и многое другое

Оглавление

• Документация виджета VIS 1
• Документация виджета VIS 2
• Список изменений
• Лицензия

Функции

• большая часть данных , которыеLMS — Услуги доступны в адаптере.
• подробная информация о состоянии проигрывателя, названии песни, исполнителе, альбоме, обложке, плейлисте.
• множество функций управления для воспроизведения, паузы, остановки, перемотки вперед.
  перемотка назад, повтор, перемешивание, воспроизведение любимого, переход ко времени
  (абсолютные и относительные значения), перейти к индексу плейлиста (абсолютные и относительные значения),
  Кнопки включения/выключения и предустановки
• Все избранные и все подуровни с сервера
• В компонент iobroker-vis включено множество виджетов .
  Создание собственных пользовательских интерфейсов управления (выбор проигрывателя, выбор избранных треков, управление группами синхронизации, кнопки воспроизведения/паузы, перемотки вперед/назад, выбора режима повтора и режима перемешивания).

Установка

• Установите пакет
• Создайте экземпляр
• Настройте экземпляр, указав IP-адрес медиасервера Logitech/Lyrion и порт (обычно 9000).
• запустить/перезапустить экземпляр

Конфигурация

Основные настройки

Для работы режима WebSocket требуется экспериментальный плагин LMS WebSocket . Он передает команды и уведомления по одному и тому же соединению, поэтому настройки Telnet в этом режиме игнорируются. Обычный опрос плеера остается включенным в качестве резервного варианта на случай отсутствия или неполноты уведомлений. URL-адреса WebSocket HTTP(S) преобразуются в WS(S), и/ws Добавляется автоматически, если указан только корневой URL-адрес.

Настройки таймера

Короткие интервалы обновления увеличивают количество запросов, отправляемых в систему управления обучением (LMS).

Настройки производительности

Отключите ненужную информацию, чтобы уменьшить количество запросов к LMS и обработку адаптера.

Настройки объявлений

Для локальных файлов объявлений LMS должна иметь доступ к настроенному веб-адресу ioBroker. URL-адреса объявлений HTTP(S) передаются непосредственно в LMS и не требуют этой настройки. Команды FadeTools отправляются только при включении этой опции. Без FadeTools все значения громкости устанавливаются напрямую и проверяются с помощью LMS.

Настройки отладки

Отладка, и особенно бессмысленное логирование, как правило, должны оставаться отключенными и включаться только во время диагностики проблемы.

Обновлять

• После установки или обновления иногда может потребоваться
  Для выполнения следующей команды, если возникли проблемы в vis-1, выполните следующую команду.

iobroker upload squeezeboxrpc

Поиск неисправностей

Игроки SLIMP3

Сообщается, что старые версии плееров SLIMP3 могут не подключаться к серверу, пока адаптер ищет новые серверы. Отключение поиска в разделе «Конфигурация экземпляра -> Настройки производительности -> Поиск других серверов LMS» должно позволить плееру подключиться.

При наличии штатов

Сервер

дополнительно предусмотрена кнопка для обновления избранного.

Избранное

Для каждого избранного все атрибуты доступны только для чтения.

Доступны все подкаталоги (подразделы) избранного.

Игроки

Для каждого игрока в режиме отображается возможность изменения значения. Выполненное действие описывается в атрибуте.

Плейлист фактически предоставляет следующие атрибуты, если они доступны.LMS Некоторые атрибуты зависят от типа песен (поток/файл/...). Все атрибуты доступны только для чтения.

дополнительные определенные кнопки:

Настройки объявления определяют его громкость и, при необходимости, интеграцию с плагином LMS FadeTools . При включении адаптер отправляетfadeout stop ожидает заданную длительность затухания, а затем возобновляет воспроизведение, используяfadein play При отключении этой функции автоматически устанавливаются предыдущие и анонсирующие тома. Для локальных файлов необходимо настроить базовый URL-адрес веб-экземпляра ioBroker (например,http://192.168.1.10:8082 Хост LMS должен иметь доступ к этому URL-адресу. Удаленные потоки восстанавливаются без перемотки, поскольку они, как правило, не поддерживают позицию воспроизведения.

Примечания к точкам данных в зависимости от настройки TPE2 в LMS.

В зависимости от настроек, точкам данных передаются разные MP3-теги. Названия, написанные заглавными буквами, — это названия MP3-тегов.

Следует также отметить, что после изменения системы управления обучением (LMS) необходимо обновить всю библиотеку.
Поиск и индексация должны быть выполнены заново, а песню необходимо остановить и перезапустить.
прежде чем система управления обучением (LMS) предоставит другие данные.

Дополнительная документация по API

Для получения более подробной информации посетите документацию по интерфейсу командной строки:

https://github.com/oweitman/LMS-CLI-Documentation/blob/master/LMS-CLI.md

Виджеты

Адаптер включает в себя соответствующие наборы виджетов для обоих поколений визуализации. Каждый виджет содержит информацию о своем назначении, изображение предварительного просмотра, все параметры конфигурации, поддерживаемые кодом, и соответствующие примечания во время выполнения:

• Полная документация по виджету VIS 1
• Полная документация по виджетам VIS 2

Оба набора виджетов используют виджет «Плееры» в качестве центрального источника выбора. Сначала настройте этот виджет, затем выберите его в элементах управления, отображении значений, избранном, плейлисте, подробной информации о плейлисте, браузере и группе синхронизации. Ссылки VIS 2 могут работать в разных представлениях.

.plentry {
    border: 1px #505050 groove;
    margin: 1px 0px;
    padding: 5px;
    background-color: #202020;
}
.plrefresh {
    padding: 5px;
}
.plentry:hover {
    background-color: #404040;
}
.plrefresh svg {
    color: #cccccc;
}
.plrefresh svg:hover {
    color: #ffffff;
    filter: drop-shadow(0px 0px 1px #87ceeb);
}

.plentry {
    border: 1px #b0b0b0 groove;
    margin: 1px 0px;
    padding: 5px;
    background-color: #c0c0c0;
}
.plrefresh {
    padding: 5px;
}
.plentry:hover {
    background-color: #e0e0e0;
}
.plrefresh svg {
    color: #444444;
}
.plrefresh svg:hover {
    color: #000000;
    filter: drop-shadow(0px 0px 1px #87ceeb);
}

Команды SendTo

getPlayerNames

Возвращает имена всех игроков, зарегистрированных в данный момент в адаптере. Возвращаемые имена — это отредактированные имена, использованные ниже.squeezeboxrpc.<instance>.Players .

async function main() {
    const playerNames = await sendToAsync('squeezeboxrpc.0', 'getPlayerNames', {});
    console.log(JSON.stringify(playerNames));
}
main();

Пример результата:

["Living_room", "Kitchen"]

cmdGeneral

Эта команда может использоваться для отправки любой команды на сервер LMS для получения ответа.

Пример:

Все плейлисты:

async function main() {
    let data = await sendToAsync('squeezeboxrpc.0', 'cmdGeneral', {
        playerid: '',
        cmdArray: ['playlists', '0', '999', 'tags:us'],
    });
    console.log(JSON.stringify(data));
}
main();

Все избранные:

Эта команда используется адаптером внутри системы для загрузки избранных элементов.

async function main() {
    let data = await sendToAsync('squeezeboxrpc.0', 'cmdGeneral', {
        playerid: '',
        cmdArray: ['favorites', 'items', '0', '999', 'want_url:1', 'item_id:'],
    });
    console.log(JSON.stringify(data));
}
main();

Дополнительные параметры и подробное описание возможностей интерфейса командной строки (CLI) приведены в следующей документации:

Разработка

вис-1

• запустить dev-сервер с помощьюdev-server watch --noStart
• Запуск адаптера с конфигурацией запуска "Запуск адаптера ioBroker по умолчанию"
• Запустите скрипт отслеживания в каталоге виджетов с помощьюnpm run watch
• открыть редактор vis-1 или среду выполнения
• Если вы внесете изменения в виджет vis-1, подождите несколько секунд, пока изменения будут загружены на dev-сервер.
• В vis-1 перезагрузите страницу vis-1.
• Если в файле squeeboxrpc.html произошли изменения, необходимо перезапустить адаптер vis-1.

вис-2

• Для отладки виджета vis-2 необходимо запустить vis-2 во втором окне vis-2.
• Для установки и запуска следуйте инструкциям по адресу https://github.com/ioBroker/ioBroker.vis-2#development-and-debugging
• Запуск адаптера с конфигурацией запуска "Запуск адаптера ioBroker по умолчанию"
• Запустите сервер разработки Vite в каталоге src-widgets с помощьюnpm run start
• В административной панели iobroker, во вкладке «Объекты», в экспертном режиме отредактируйте объект.system.adapter.squeezeboxrpc.0
• Измените common.visWidgets.vis2vis-squeezeboxrpc.url с vis2squeezeboxrpc/customWidgets.js на http://localhost:4173/customWidgets.js — это адрес сервера VITE.
• Откройте vis в режиме редактирования или выполнения с помощью конфигурации запуска "vis2 edit 3000" или "vis2 runtime 3000".
• Если вы внесете изменения в код виджета vis-2, произойдет автоматическая перезагрузка страницы или вы нажмете клавишу F5 в браузере.

финальный тест времени выполнения

• останавливатьсяdev-server и ваш адаптер в VS Code
• Создайте производственную сборку и загрузите её на сервер разработки с помощью команды сборки.dev-server upload
• запустить iobroker с помощьюnpm run start
• Отмените изменение в параметре system.adapter.squeezeboxrpc.0 до исходного значения.
• Откройте vis-1 или vis-2 в режиме редактирования или во время выполнения.

дополнительное тестирование на реальном сервере iobroker

• В корневом каталоге создайте файл пакета npm, содержащий следующее:npm pack
• В iobroker на вкладке admin/adapter в экспертном режиме нажмите кнопку cat.
• В диалоговом окне выберите вкладкуfrom file
• выберите созданный файл пакета
• нажмите установить
• Если что-то не работает, при запуске оболочки.iobroker upload all

Все

• добавить виджет круговой ручки, управляемый игроком
• Игра перестанет воспроизводиться, если кнопка «Избранное» будет нажата повторно. Не реализовано.
• дополнительное тестирование/исправление
• Дополнительные возможности настройки для включения/выключения функций с целью повышения эффективности использования памяти и производительности.
• добавить виджет плейлиста
• добавить виджет просмотра для просмотра вLMS -Меню
• уменьшить зависимость от других пакетов (squeezenode)
• cmdGeneral für Server.
• Добавить возможность подключения по Telnet для получения push-уведомлений от сервера с целью оптимизации опроса.
• Реализовать состояние команд для передачи индивидуальных команд пользователю (через JSON) на сервер и плеер.
• Реализуйте больше функций управления (выбор позиции воспроизведения в плейлисте, перемотка вперед, перемотка назад, переход к определенной временной позиции в песне, повтор песни, воспроизведение в случайном порядке).
• Добавить плейлист в playerdata в виде массива JSON.
• Добавить обложку (логотип станции/обложку плейлиста) для избранных
• добавить больше уровней (подкаталогов) избранного
• автообнаружение медиасервера Logitech

Changelog

3.0.1 (2026-09-08)

• fix little regressions

3.0.0 (2026-09-07)

• complete rework of the LMS API
• add experimental websocket support, only usable with LMS 9.2 build after 5.9.2026

2.0.2 (2026-09-07)

• fix io-package.json

2.0.1 (2026-09-05)

• fix package-lock
• fix tests

2.0.0 (2026-09-05)

• power/connected state fixed
• players button font size fixed
• bring back fade in/out for Announcement with additional LMS plugin

Older entries are in CHANGELOG_OLD.md.

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Copyright (c) 2019-2026 oweitman