AIMP HTTP Remote Control Server для Bitfocus Companion

[slv.team]

Плеер: v5.40.2716 и новее.
Тип: Удаленное управление
Платформа: Windows 32-бит, 64-бит

Плагин для удаленного управления плеером в Bitfocus Companion.

Теперь Вы можете управлять плеером при помощи своего Elgato Stream Deck или эмулятора (веб-кнопки).

Обновление 07.06.2026
Изменения:
1. Добавлена 32-битная версия плагина, обе версии теперь упакованы в aimppack
2. Настройки плагина интегрированы в графический интерфейс плеера
3. Добавлен выбор сетевого интерфейса
4. Добавлена функция настройки политики доступа

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

Функционал:
 - Управление воспроизведением, play/pause, stop, следующий и предыдущий трек;
 - Управление громкостью, регулировка с шагом 20%, отдельная функция полного выключения MUTE;
 - Навигация по плейлистам и трекам (фокус), совмещена с фокусированием в интерфейсе плеера;
 - Отображение информации о плейлисте, треке, длительности;
 - Включение и отключение автоматического перехода на следующий файл;
 - Включение и отключения повтора и перемешивания;
 - Воспроизведение определенного трека из коллекции (позволяет проиграть заранее выбранный трек, независимо от фокуса, к примеру фанфары, звонки и подобные звуки);
 - Воспроизведение определенного плейлиста.


Подключение:
Необходимо установить плагин в плеер, в Bifocus Companion импортировать соответствующий модуль.

Настройка:
В настройках плагина необходимо выбрать интерфейс и порт, к которому будет подключаться модуль Companion. При необходимости настроить политику доступа: разрешить подключение с определенного ip адреса или пула ip адресов.

1. Сетевой интерфейс: в выпадающем списке выберите необходимый сетевой интерфейс вашего устройства, в скобках будет указан назначенный ip адрес интерфейса. Примечание: 127.0.0.1 – localhost, используется в случае, если AIMP и Companion работает на одном и том же устройстве, при
этом в настройках модуля тоже должен быть указан 127.0.0.1, 0.0.0.0 – подключение по всем интерфейсам, включая внешние ip адреса. Рекомендуем использовать управление только в локальной сети. Обратите внимание, что для стабильной работы рекомендуется назначать устройствам постоянные ip адреса на маршрутизаторе для сохранения настроек подключения.
2. Порт: 19122 по стандарту, можете установить любой

3. Политика доступа (необязательно).
Поставьте галочку и пропишите ip адреса, с которых будет возможно подключение - адрес устройства, на котором запущен Companion.

Нажмите Применить, в строке Server будет указан ip адрес и порт, на котором запущен сервер. Именно эти данные необходимо использовать в настройках модуля Companion.



4. Добавление модуля в Companion

4.1. На вкладке модули (Modules) импортируйте скачанный модуль



4.2. Далее в соединениях (Connections) найдите AIMP и добавьте (add)



4.3. Далее в настройках соединения укажите ip адрес устройства с AIMP (AIMP API HOST), порт, если меняли и время обновления. По умолчанию время обновления 80 мс, чем меньше это параметр, тем быстрее будет обновляться информация в модуле. Не задавайте параметр менее 50 мс, это может значительно увеличить нагрузку на ПК. Если используете дома просто для прослушивания музыки – будет достаточно и 500 мс.



4.4. Добавление кнопок

Перейдите на вкладку кнопок (Buttons), и справа посмотрите доступные пресеты (Presets), просто перетащите их на страницу.



Информация в пресетных кнопках уже обновляется переменными (Variables) из AIMP

Список всех доступных переменных можно посмотреть во вкладке Variables


Скачать плагин можно по ссылке: https://github.com/slv-tech/AIMP-HTTP-Remote-Control-Server

Скачать модуль можно по ссылке: https://github.com/bitfocus/companion-module-aimp-audioplayer

Надеемся, что плагин в будущем можно будет скачать в каталоге дополнений AIMP, а модуль в каталоге Bitfocus Companion.

Примечания по использованию ПО Elgato для использования Stream Deck с родной утилитой или использования Stream Deck Mobile:

Есть несколько способов использования контроллера Stream Deck - с родным приложением Elgato Stream Deck, а также с Bitfocus Companion, при этом необходимо обратить внимание, что обе утилиты не могут работать одновременно с устройством, если у Вас при автозагрузке первым запускается Companion - он и будет подхватывать ваш контроллер. Для одновременного использования родной утилиты и Companion необходимо в Companion добавить Elagato Stream Deck Plugin, и отключить автоматическую инициализацию контроллера в Surfaces. Далее в родной утилите необходимо добавить из магазина Bitfocus Companion Plugin, и только теперь Вы сможете добавить кнопки из Companion в утилиту Elgato как Companion Button, если все вместе открыто на одном устройстве. Если Companion работает на другом устройстве - настройте плагин в родной утилите, плагин подключается к Companion как устройство через Satellite - утилита для удаленного подключения контроллера к Companion. В случае плагина для родной утилиты ее отдельно скачивать не нужно - она есть как составляющая плагина. При настройке кнопок Companion в родной утилите не забудьте, что Вы должны указать адрес каждой кнопки - страница/строка/колонка (прим. 1/0/1).

В случае багов и предложений пишите на GitHub:
https://github.com/slv-tech/AIMP-HTTP-Remote-Control-Server/issues
https://github.com/slv-tech/Companion-Aimp-Module/issues

[Soolo]

AIMP 5.40 x64
Попробовал настроить плагин, но не получается заставить его работать

Настройка плагина в АИМП:


Настройка Companion:


Пробую подключиться через приложение Elgato Stream Deck Mobile
Все устройства в одной сети. Elgato Stream Deck Mobile корректно подключается и управляет компьютером, если установить Stream Deck
Но не может подключиться к Bitfocus Companion. Может оно и не должно?

При попытке открыть http://192.168.2.161:19122 (на компьютере или смартфоне) или http://127.0.0.1:19122 (на компьютере) браузер выдаёт {"error":{"code":"NOT_FOUND"}}
Через страницу http://192.168.2.161:8000/tablet (на компьютере или смартфоне) могу управлять АИМПом

Подскажите, как можно с помощью этого плагина управлять АИМПом на Андроиде не через браузер, а через приложение Elgato Stream Deck Mobile или любое другое?

Физической клавиатуры Elgato Stream Deck к сожалению не имею для тестов

[Artem]

При попытке открыть http://192.168.2.161:19122 (на компьютере или смартфоне) или http://127.0.0.1:19122 (на компьютере) браузер выдаёт {"error":{"code":"NOT_FOUND"}}

На сколько я вижу, плагин лишь выступает сервером для команд. Сам по себе он UI не генерирует.
Можешь сделать запрос такого вида: http://127.0.0.1:19122/api/player/volume - он выдаст тебе ответ в виде JSON-а.

Вот тут можешь подсмотреть список поддерживаемых команд:
https://github.com/slv-tech/AIMP-HTTP-Remote-Control/tree/main#api-эндпоинты

Но это больше техническая информация, не для конечного пользователя

[Soolo]

На сколько я вижу, плагин лишь выступает сервером для команд. Сам по себе он UI не генерирует.
Можешь сделать запрос такого вида: http://127.0.0.1:19122/api/player/volume - он выдаст тебе ответ в виде JSON-а.

Вот тут можешь подсмотреть список поддерживаемых команд:
https://github.com/slv-tech/AIMP-HTTP-Remote-Control/tree/main#api-эндпоинты

Но это больше техническая информация, не для конечного пользователя

Тут я разобрался, что порт :19122 это теническая прослойка, мой запрос в браузере и ответ на него просто подтверждает, что прослойка работает.
Но я дальше настраивал Bitfocus Companion (в моём случае это уже порт :8000) по инструкции автора плагина, и вот Bitfocus Companion почему-то не захотел использовать эту прослойку для управления плеером.
Или я ошибся в настройке.

[Artem]

Но я дальше настраивал Bitfocus Companion (в моём случае это уже порт :8000) по инструкции автора плагина, и вот Bitfocus Companion почему-то не захотел использовать эту прослойку для управления плеером.

У меня заработало, я тыкал вот сюда:


и тогда команда отрабатывает. Единственное, что показалось неочевидным: кнопка play/pause не работает, если плеер на стопе. Для запуска трека есть отдельная кнопка.

[Artem]

Надеемся, что плагин в будущем можно будет скачать в каталоге дополнений AIMP,

Я записал вам две иссуи на гите, в остальном плагин вроде рабочий. Спасибо!

[Soolo]

У меня заработало, я тыкал вот сюда:

Сегодня удалил все кнопки и заново их настроил - заработало, что за чудеса вчера были, не понял

[Soolo]

Добавил в приложение Stream Deck на Винде плагин Bitfocus Companion Plugin
Как-то странно помогло: могу добавить одну единственную кнопку "плей/пауза", больше ничего
Кнопка работает, управлет плеером и меняет свою картинку в зависимости от состояния проигрывания
Разобрался, можно править конфигурацию кнопки и функционал меняется
Запутано, но работает

[slv.team]

Я записал вам две иссуи на гите, в остальном плагин вроде рабочий. Спасибо!

Здравствуйте, отработали по обеим - посмотрите, как будет время.

Изменения добавлены в описание

[slv.team]

Примечания по использованию ПО Elgato для использования Stream Deck с родной утилитой или использования Stream Deck Mobile:

Есть несколько способов использования контроллера Stream Deck - с родным приложением Elgato Stream Deck, а также с Bitfocus Companion, при этом необходимо обратить внимание, что обе утилиты не могут работать одновременно с устройством, если у Вас при автозагрузке первым запускается Companion - он и будет подхватывать ваш контроллер. Для одновременного использования родной утилиты и Companion необходимо в Companion добавить Elagato Stream Deck Plugin, и отключить автоматическую инициализацию контроллера в Surfaces. Далее в родной утилите необходимо добавить из магазина Bitfocus Companion Plugin, и только теперь Вы сможете добавить кнопки из Companion в утилиту Elgato как Companion Button, если все вместе открыто на одном устройстве. Если Companion работает на другом устройстве - настройте плагин в родной утилите, плагин подключается к Companion как устройство через Satellite - утилита для удаленного подключения контроллера к Companion. В случае плагина для родной утилиты ее отдельно скачивать не нужно - она есть как составляющая плагина. При настройке кнопок Companion в родной утилите не забудьте, что Вы должны указать адрес каждой кнопки - страница/строка/колонка (прим. 1/0/1).

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