Русский

Управление светом сцены с игрового контроллера

Загрузить InputConfig в Mac App StoreЭто приложение полностью бесплатное. Создавать учётную запись не нужно. Нет подписок, нет сложных загрузок, и ничего не заблокировано. Оптимизировано для Apple Silicon.

С контроллера Xbox или PlayStation на Mac можно управлять DMX-светом сцены без лишнего приложения-моста. InputConfig превращает контроллер в MIDI-устройство, а приложения для света, которыми пользуются на Mac, QLC+, Lightkey и MagicQ, уже умеют слушать MIDI. Сожмите курок, и свет плавно поднимается. Нажмите кнопку, и включается сцена.

Это началось с вопроса на Reddit: кто-то хотел управлять световой установкой с контроллера Xbox, и ответ оказался простым, это уже работает. От контроллера в руках до света на стойке вы пройдете примерно за полчаса. Когда впервые нажатие курка поднимает настоящий свет, оторваться от контроллера трудно.

Версия InputConfig 1.7, ожидаемая в октябре 2026 года, будет полностью доступна на русском языке.

Шаги

  1. Подключите контроллер и откройте InputConfig.
  2. Скачайте пресет Lighting Desk с этой страницы, дважды щелкните по нему, чтобы добавить в InputConfig, и включите его.
  3. Откройте приложение для света (QLC+, Lightkey или MagicQ) и выберите InputConfig как MIDI-вход.
  4. Подключите USB-DMX интерфейс или узел Art-Net или sACN и подключите к нему приборы в приложении для света.
  5. Назначьте каждое управление: в QLC+ используйте Auto Detect на ползунке или кнопке Virtual Console, в Lightkey щелкните правой кнопкой по сигналу или ползунку и добавьте триггер, затем двиньте нужное управление на контроллере.
  6. Сделайте кнопки сцен переключателями, а два бампера мигающими, и держите под рукой кнопку затемнения и кнопку остановки всего.

Соберите все необходимое

  • Контроллер. Xbox, PlayStation, Switch Pro, 8BitDo, любой, который видит InputConfig. Если он появляется в приложении, здесь он работает. Начиная с InputConfig 1.6, джойстики, штурвалы и педали читают каждую ось в полном разрешении, так что рычаг газа или педаль тоже могут быть ползунком.
  • InputConfig. Бесплатно в Mac App Store.
  • Приложение для света. QLC+ бесплатен, с открытым исходным кодом и работает нативно на Apple silicon. Lightkey только для Mac и удобен. MagicQ от ChamSys тоже работает, но его MIDI-вход есть не в каждой версии, так что сначала проверьте документацию ChamSys.
  • Что-то, что управляет светом. USB-DMX интерфейс (Enttec DMX USB Pro использует драйвер, который уже встроен в macOS) или узел Art-Net или sACN в вашей сети.

Если света пока нет, QLC+ показывает каждый прибор на экране, так что можно собрать и проверить все до подключения чего-либо. InputConfig и QLC+ оба бесплатны. Возможно, придется купить только интерфейс или узел.

Как устроены части

InputConfig создает на вашем Mac MIDI-порт с именем InputConfig. Любое другое приложение видит его точно так же, как MIDI-контроллер, подключенный кабелем. Он никогда не покидает ваш Mac, так что настройки сети не нужны и драйвер ставить не надо. Всю работу делают два типа сообщений:

MIDI CC (Control Change)
Курок или стик посылает плавное значение от 0 до 127, когда вы его двигаете. Курок в покое стоит на 0, что идеально для диммера: отпустили, и ползунок опущен до конца.
MIDI-ноты
Кнопка посылает note on, пока ее держат, и note off, когда отпускают. Приложение для света решает, означает ли это переключить сцену или мигать, только пока держат.

Курки это ползунки, кнопки это сцены, а приложение для света решает, что означает каждое из них.

Настройте контроллер в InputConfig

Самый быстрый старт это пресет Lighting Desk на этой странице. Все идет по MIDI-каналу 1:

УправлениеПосылаетПодходит для
Правый курокCC 1Главный диммер
Левый курокCC 2Скорость строба, дым или цвет
Правый стик вверхCC 3Третий ползунок
A, B, X, YНоты с 36 по 39Сцены с 1 по 4
LB, RBНоты 40, 41Вспышки
КрестовинаНоты с 42 по 45Следующий сигнал, предыдущий, бегущие огни
StartНота 46Затемнение
BackНота 47Остановить все
Пресет Lighting Desk в редакторе со строками MIDI CC на курках и строками MIDI-нот на кнопках.
Figure 1. Курки посылают CC 1 и CC 2, а кнопки посылают ноты с 36 по 47, все на канале 1.
  • Вы: Откройте скачанный файл, чтобы добавить его в InputConfig, и включите.
  • InputConfig: Посылает эти CC и ноты на порт InputConfig. Стик, который посылает CC, доходит до полного диапазона от 0 до 127, когда проходит мертвую зону, так что ползунок правого стика поднимается до конца.
  • Проверка: На контроллере PlayStation задайте пресету цвет световой полосы: выберите его на боковой панели и нажмите на полосу света над рисунком контроллера в Live Visualizer. Один взгляд на контроллер тогда покажет, что схема освещения работает.

Чтобы собрать свой, добавьте строку, нажмите Scan, двиньте управление, затем выберите выход MIDI CC или MIDI Note. Инструмент MIDI CC помогает увидеть, какие номера уже заняты.

Подключите в QLC+

Шаг 1: Выберите вход и выход

  • Вы: Откройте вкладку Inputs/Outputs. На вселенной 1 отметьте InputConfig как MIDI-вход, а в качестве выхода выберите DMX-интерфейс или Art-Net.
  • QLC+: Слушает порт InputConfig на этой вселенной.
  • Проверка: Двиньте курок, и индикатор входа вселенной реагирует.

Шаг 2: Назначьте ползунки и сцены

  • Вы: В Virtual Console добавьте ползунок для диммера. В его свойствах включите Auto Detect у внешнего входа, затем потяните правый курок. Кнопки для сцен добавьте так же: привяжите сцену, включите Auto Detect, нажмите A.
  • QLC+: Привязывает каждый элемент к управлению, которое вы двинули, и растягивает диапазон MIDI от 0 до 127 до диапазона DMX от 0 до 255, так что полное нажатие действительно полное.
  • Проверка: Ползунок следует за курком, а A включает сцену.

Шаг 3: Настройте поведение кнопок

  • Вы: Сделайте кнопки сцен Toggle Function on/off, а кнопки LB и RB Flash Function. Назначьте Start на Toggle Blackout, а Back на Stop All Functions.
  • QLC+: Переключает сцены, а сцены вспышки горят, только пока вы держите бампер.
  • Проверка: Отпустите бампер, и его вспышка гаснет.

Подключите в Lightkey

  • Вы: Откройте окно External Control, нажмите MIDI и выберите InputConfig в меню Input. Затем щелкните правой кнопкой по сигналу или ползунку, выберите add trigger и нажмите кнопку или двиньте курок, который хотите использовать.
  • Lightkey: Запоминает управление прямо там.
  • Проверка: Сигнал запускается с контроллера. Настройка целого шоу занимает пару минут.

Двигайте головы кнопками, а не стиком

Панорамирование и наклон можно поставить на стик, и для больших движений это очень весело. Ограничение: у MIDI CC всего 128 шагов, так что медленные точные движения могут выглядеть немного ступенчато. Для шоу сохраняйте позиции в приложении для света, ставьте их на кнопки и пусть эффекты самого приложения ведут движение.

Держите под рукой кнопку паники

Свет работает вживую, поэтому планируйте момент, когда что-то пойдет не так. Поднимайтесь по лестнице, начиная с самого простого шага:

  1. Затемнение. Start, подальше от кнопок, по которым будете колотить.
  2. Остановить все. Back, которая называется View на контроллере Xbox и Create на DualSense.
  3. Остановить InputConfig. Back также входит в собственную аварийную остановку InputConfig по умолчанию: обычное нажатие отправляет Stop All приложению для света, а удержание вместе с Start в течение трех секунд останавливает сам InputConfig, который отправляет note off для каждой ноты, которую держит, и останавливает весь вывод.

Если хотите разнести эти две функции, переместите аварийную остановку на другую кнопку в настройках, General. Для настоящего шоу используйте кабель вместо Bluetooth и заранее зарядите контроллер. Bluetooth подходит для репетиций. Кабель это одной заботой меньше.

Другие способы

У меня здесь свой интерес, поэтому вот и другие пути:

  • Chataigne. Бесплатный, читает игровой контроллер напрямую и посылает DMX, Art-Net или OSC. Отлично, если нужен только свет, и мост, если когда-нибудь понадобится. OSCulator, который часто рекомендовали для этого, закрылся в конце 2024 года.
  • Собственный HID-плагин QLC+. Читает контроллеры, но в документации он указан для Windows и Linux.
  • InputConfig. Имеет больше смысла, когда тот же контроллер должен еще управлять клавишами, мышью или музыкой на вашем Mac, или когда нужна одна настройка, которая работает во всех приложениях.

MIDI-клавиатура или блок фейдеров могут работать одновременно. Приложение для света видит их и InputConfig как отдельные входы. Для OSC вместо MIDI см. игровой контроллер в OSC на Mac.

Коротко

  • Добавьте пресет Lighting Desk. Курки это ползунки, кнопки это сцены, на MIDI-канале 1.
  • Выберите InputConfig как MIDI-вход. Сделайте это в QLC+, Lightkey или MagicQ, затем выучите каждое управление.
  • Переключайте сцены, мигайте бамперами. Затемнение и остановка всего на Start и Back.
  • Для шоу используйте кабель. Сначала зарядите и контроллер.

Любое приложение для света, которое понимает MIDI, можно вести с контроллера.

Вопросы

Нужен ли OSCulator или другое приложение-мост?

Нет, для QLC+, Lightkey или MagicQ. Они читают MIDI-порт InputConfig напрямую. Если вам рекомендовали OSCulator, он закрылся в конце 2024 года, поэтому, если мост все же понадобится, я бы использовал Chataigne.

Работает ли это с контроллером PlayStation или Switch?

Любой контроллер, который видит InputConfig, работает, потому что приложение для света видит только MIDI.

Можно ли одновременно использовать MIDI-клавиатуру или блок фейдеров?

Ваше приложение для света видит InputConfig и остальные MIDI-устройства как отдельные входы, так что смешивать их можно как угодно.

Это бесплатно?

InputConfig бесплатен, и QLC+ тоже. Возможно, придется купить только USB-DMX интерфейс или узел Art-Net, чтобы подключить настоящий свет.

Ещё на русском

Подробные руководства на английском

Кто это пишет. Ryleigh Newman разрабатывает InputConfig и каждый день управляет своим Mac с помощью геймпада, потому что руки плохо слушаются. Эта страница переведена с английского. Если на Mac выбран русский язык, основные кнопки и меню приложения показываются по-русски; на этой странице они названы так же, с английским названием в скобках. Остальная часть приложения и сайта на английском языке.

Эта страница на других языках: English, Čeština, Dansk, Deutsch, Español, Français, עברית, Magyar, Italiano, 日本語, Norsk, Polski, Português, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt

Загрузить InputConfig в Mac App StoreБесплатно. macOS 14 или новее. Без учётной записи, ничего не покидает ваш Mac. Исходный код на GitHub.