Вот небольшое оглавление для удобства и возможности быстрого перехода:

• Причины и что вообще побудило к созданию этой системы
• Возможности системы
• Как всё работает
• Скачать, настроить, использовать

Причины и что вообще побудило к созданию этой системы

Обычно текст песен на экране показывается совершенно разными способами, начиная от ручного прокручивания первого попавшегося сайта или показа презентации в PowerPoint с заранее заготовленными слайдиками и заканчивая профессиональными программами по типу ProPresenter. Но каждый из этих способов требует наличия человека, причём, довольно-таки внимательного)) А как часто бывает, что человека отвлекут, либо он плохо знает песню и поэтому пропускает момент переключения… )
Более продвинутый вариант — автоматизировать переключение слайдов и/или фоновых видосов в ProPresenter, передавая миди-сообщения из DAW через midi-loopback или по сети. Такое тоже имеет место быть, и в нашей ситуации я даже начинал создавать тексты песен в том же ProPresenter, и даже настроил переключение слайдов по midi, но всё это как-то не то… не так эпично что ль Да и вопрос с показом аккордов тоже оставался открытым. И не давала покоя мысль ещё больше автоматизировать это дело… Несколько вечеров, и готово! И самим хорошо, и с остальными поделиться можно, ведь если это понадобилось мне, скорей всего кому-то тоже может понадобиться, как показывает практика )
Единственный минус: всё завязано на REAPER, но рипер крут, и как бы почему бы и нет, если у нас (да и у много кого ещё) всё и так работает через него (и плейбэки, и метроном, и гайды, и управление светом, и т.д.).

Возможности системы

Ниже небольшое видео (без звука), где:

• запуск скрипта в REAPER (скрипт добавить надо, он в комплекте с программой идёт)
• запуск программы проксирования
• видно красивое меню, которое «раздаёт» эта самая программа (файлики хранятся в открытом виде, обычные html файлы)
• демонстрация показа аккордов, и прокручиваемого текста. Всё открыто в двух сгруппированных вкладках браузера для показа одновременной работы разных разделов (на самом деле весьма удобно видеть и текст, и аккорды сразу)

На входе встречает красивое меню, где можно выбрать нужный раздел:

1. Chords — аккорды. Показываются как просто списком на экранах побольше, так и просто прокручиваемые аккорды на экранах поменьше. Внизу пишется также название текущего трека (берётся из региона), время на таймлайне и BPM, а также показывается текущий статус: воспроизведение, пауза, стоп. Блоки с аккордами имеют разную высоту, что соответствует их длительности. Сразу наглядно видно как долго держать аккорд, но на всякий случай пишется ещё и время (в секундах) и количество ударов метронома для каждого аккорда, типа 12/4 или 2/4. Имеется возможность приблизить, отдалить, отцентрировать (если прокрутили вдруг) и переключиться в полноэкранный режим.
2. Lyrics — текущая строка текста. Это может пригодиться для вывода на экран в зале или в трансляцию. Обычная веб-страница, которая в реальном времени получает и показывает текущий текст, а при вставке в OBS, vMix или другие программы можно подстроить внешний вид, убрать фон, изменить размер и т.д. А если есть возможность подредактировать CSS стили (как в том же OBS), то можно ещё и шрифт поменять и ещё там эффектов на текст накинуть при необходимости. Но вообще, исходный код всех страниц открыт, так что можно менять на своё усмотрение, добавлять свои страницы и пункты в меню, но об этом ниже
3. Scroll Lyrics — прокручиваемый текст. А вот это уже больше подходит для stage-монитора для вокалиста, чтоб не только текущую строчку видел, но и следующие тоже заранее мог подсмотреть. Хотя в любом случае текст нужно показывать не в тот самый момент, когда он пропевается, а чуть заранее, но тут уже по своим нуждам тоже можно настроить всё и располагать тексты где нужно на таймлайне рипера, ведь именно оттуда берётся текст, но об этом позже)
   В этом режиме можно в URL добавить параметр ?vignette, и тогда вокруг текущей подсвечиваемой строки появится виньетка, чтоб сфокусироваться на главном
   

А начинается всё с захода на IP адрес или на rc.reaper.fm/ИМЯ, где запущена программа-прокси для рипера, которая и позволяет всей этой системе более оптимально работать без лишних запросов, но подробней об этом в следующем разделе — как это всё работает)

А позже был создан сервис https://r.qofa.ru — аналог rc.reaper.fm, только без указания имени, ведь оно не нужно, когда есть единая точка входа с меню

Как всё работает

REAPER крут тем, что поддерживает разные контроллеры, а также управление по MIDI и OSC. Но ещё более крут он тем, что у него есть встроенный веб-интерфейс с неплохими дефолтными страницами, через которые можно и дорожками управлять, и мониторингом, и визуальный клик иметь, и ещё там что-то
(всё это находится в настройках, в Control/OSC/web)

Также есть замечательное расширение ReaPack, позволяющее прям из рипера ставить дополнительные скрипты, разрабатываемые сообществом, и также можно подключать дополнительные репозитории, и ставить ещё больше всяких скриптов… В общем, не зря есть шутка, что в рипере пишут не музыку, а скрипты

За основу были взяты скрипты и интерфейсы от замечательного автора X-Raym, у которого очень много разработок на все случаи жизни:

Но не было ничего для показа аккордов. Да и изучив работу текущих скриптов и как вообще происходит общение с рипером, я немного поразился… Только представьте: каждые 10 миллисекунд идёт обращение к риперу за получением информации! Это 10 раз в секунду! А, минутку… Речь идёт о JS¹, так что это 100 раз в секунду
Со стороны рипера нужно запустить скрипт, который найдёт дорожку с текстом или возьмёт выделенную дорожку, найдёт на ней все текстовые item-ы (это такие специальные элементы в рипере, просто для заметок, в них даже картинки можно засовывать), преобразует это в json формат и сохранит в EXTSTATE (ссыль на документацию REAPER API). А затем со стороны веб-интерфейса (который сначала нужно в любом случае настроить, выбрав порт и страницу), идёт обращение к риперу для получения готового JSON с позициями и текстами, а потом 100 раз в секунду запрашивается текущая позиция курсора воспроизведения, чтоб показывать текст, соответствующий нужному времени.

По такому же принципу я сделал Lua-скрипт-модуль для рипера, который ищет дорожку с названием Chords (регистр не важен), забирает её текстовые элементы, сохраняет тоже в extstate под своим ключом, и потом это всё красиво рисуется на веб-страничке, но ещё и с компенсацией сетевой задержки, потому что нужно было добиться максимального совпадения кликов метронома в ушах и включения аккордов, это важно!

Именно таким образом вся эта система работала какое-то время, но было замечено, что веб-сервер, встроенный в REAPER, не справляется, если одновременно несколько клиентов пытаются получить данные. Даже уменьшение частоты запросов не сильно помогло, а ещё нужно было для каждой отдельной страницы (для аккордов, текста и прокручиваемого текста) настраивать отдельный веб-интерфейс и давать ему отдельное имя для rc.reaper.fm. Конечно же можно было не настраивать отдельно всё это, и в любом настроенном веб-интерфейсе просто написать имя нужной страницы, но это ещё сложней, ведь названия там непростые… Ладно, не суть)

В голову пришла идея накатать по-быстрому свой прокси-сервер, который с одной стороны будет обращаться к риперу в единственном экземпляре со своим интервалом, а с другой стороны будет раздавать полученную информацию подключенным клиентам, сколько бы их не было. Сказано — сделано!
На Go написан веб-сервер с поддержкой веб-сокетов², и получилось довольно универсально, ведь:

• можно переопределить свою главную страницу, в которой теперь красивое меню (на самом деле, можно и в риперовские страницы это засунуть)
• можно добавить остальные нужные страницы, подправить их под свои нужды
• можно переопределить файл main.js, в котором есть базовые функции для связи с рипером (по AJAX³), этот файл взят из стандартной поставки рипера и доработан. Удалось поменять всё так, что если есть поддержка веб-сокетов, то будут использованы именно веб-сокеты, а если нет, то будет по-старому работать. Поэтому с точки зрения использования этих функций ничего не изменилось, можно даже не сильно переписывать используемые страницы
• веб-сервер работает так: сначала ищет файл по точному пути, переданному в URL, потом пробует имя + .html, потом пробует имя/index.html, а если и это не найдено, то запрос проксируется в рипер без изменений. Таким образом можно накидывать своих красивостей, не теряя при этом возможности дёргать рипер напрямую, вызывая его API-функции или запрашивая какие-то данные
• все получаемые от рипера данные этот веб-сервер на Go отправляет всем клиентам. Причём, не просто отправляет всё, а только изменившиеся части, что сокращает количество трафика. Можно было бы заморочиться и следить за тем, кто из клиентов что запрашивает, собирать это в единый запрос для рипера, а потом парсить ответы и отправлять клиентам только то, что нужно, каждому своё, но… на текущем этапе это уже перебор, к тому же, так уж вышло, что всем клиентам (тут я имею ввиду разные странички с разным функционалом) всегда нужно значение TRANSPORT (отвечает за статус воспроизведения, текущую позицию и т.д.), а все остальные данные подгружаются при старте, поэтому это никак не мешает работе всего остального. Просто и гениально
• поддерживается также rc.reaper.fm, можно задать своё имя, и тогда программа при старте отправит на сервера рипера информацию о своём локальном адресе, и тогда остальным клиентам, находящимся в этой же сети, не нужно будет узнавать IP адрес и порт для подключения к интерфейсу, а достаточно будет зайти на rc.reaper.fm/ws, и они попадут в интерфейс независимо от настроек сети и т.д. Вместо ws можно поставить своё имя, но по-умолчанию оно такое. Для реализации этой фичи пришлось немножко отреверсинжинирить общение рипера с этим внешним сервисом. Оказалось ничего сложного тоже, зато теперь как удобно заходить по постоянному адресу в интерфейс
  (только для этого интернет нужен, но по IP адресу или внутреннему имени хоста заходить можно и без интернета)
• по аналогии с rc.reaper.fm создан сервис https://r.qofa.ru, в котором не требуется указание имени, а в остальном принцип работы идентичен: в той же локальной сети, где запущена программа, можно перейти по адресу r.qofa.ru, а оттуда уже будет редирект на IP и порт, которые слушает программа. УДОБНО!
• на будущее сделана публикация в mDNS, чтоб можно было обнаружить этот сервис. Пока не используется, хотя прикольно, что оно есть и работает (ниже скриншот обнаружения с телефона через mDNS Discovery)
  

Программа кроссплатформенная, и если переопределить дефолтные настройки (-reaper-url), то можно подключаться к риперу, запущенному на другом устройстве, если вдруг нужно. Хотя обычно незачем, и работает всё шустро, памяти занимает тоже мало.

Пройдёмся немножко по некоторым настройкам:

• -addr — адрес и порт, которые будет слушать программа, куда будут обращаться остальные клиенты
• -poll-get-keys — тут можно перечислить (через точку с запятой) команды для рипера, которые периодически будут запрашиваться из рипера, а их результат публиковаться по веб-сокетам всем клиентам одновременно (вау!). Можно оставить по-умолчанию, там есть всё, что нужно для работы и аккордов, и текстов.
• -poll-interval — интервал запросов к риперу. 80 миллисекунд оказалось вполне достаточно и для текстов, и для комфортного показа аккордов (а чтоб аккорды не дёргались, есть небольшая инерция)
• -reaper-rc-name — имя для rc.reaper.fm. По-умолчанию ws, но можно (и даже нужно) переопределить, иначе в лучшем случае, если кто-то, находясь в другой сети, запустит программу и переопределит свой адрес по этому же имени, то другой не сможет зайти, увидит весёлое сообщение, что сети разные)
• -reaper-url — адрес настроенного веб-интерфейса в рипере (выбранная страница не важна). Можно на этом же компьютере, можно на другом, где он запущен. Если программа запускается там же, где и рипер, то можно указать http://localhost:PORT, где port — это порт веб-интерфейса, настроенный в рипере. По-умолчанию указан порт 8088, и именно на такой порт у меня настроен рипер, так что я даже не трогаю дефолтные настройки (хотя после публикации этой статьи как минимум дефолтное имя нужно будет переопределять, кажется :D). Если программа не сможет подключиться, она будет каждую секунду об этом упоминать в консоли, пытаясь переподключиться, ну, и работать всё остальное, соответственно, тоже не будет, пока не будет связи с рипером
• -ws-path — это лучше не менять, это для работы веб-сокетов
• -www-root-path — указывается путь до статичных файлов из папки www, которая идёт в комплекте с программой. Без необходимости тоже лучше не менять, потому что просто незачем

Теперь можно использовать хоть десяток одновременно работающих клиентов, никто друг другу мешать не будет, главное, чтоб wi-fi сеть выдержала, но как показывает практика, на wi-fi 5 ГГц работает всё просто замечательно
Программа сама обращается к риперу с указанным интервалом, и все клиенты получают данные, не устраивая ddos атаку на рипер

Протестирована одновременная работа с нескольких вкладок на компьютере, на планшете, на нескольких телефонах, на проекторе с Android (о, это вообще удобно! Или если телевизор с браузером, тоже да), и всё отработало хорошо)

Ещё немного про скрипты.

Ранее для работы всей системы приходилось запускать три отдельных скрипта в рипере, для чего прям в рипере на панельку были добавлены кнопочки для их запуска. Причём, для аккордов и прокручиваемого текста скрипты были разовые — запустил, они своё дело сделали и завершились. А для показа текущего текста скрипт работал постоянно в фоне, проверяя текущий элемент с текстом и сохраняя во всё тот же extstate нужные данные. Теперь же всё объединено в один скрипт, немного оптимизировано, поэтому теперь достаточно запускать лишь один единственный скрипт, который также идёт в комплекте. Чуть позже он будет выложен в репозиторий для ReaPack, но пока ручками, ничего сложного в этом нет
Так что теперь можно добавить лишь одну кнопочку для запуска скрипта. А даже если её не добавить, на странице с аккордами есть ссылка, нажатие на которую запускает нужный скрипт и всё начинает работать.

Как скачать и с чего начать

Если кратко, то:

1. Скачать архив с программой и дополнительными файликами отсюда: https://github.com/karamush/reaper-ws-proxy/releases/latest (выбираем для своей операционной системы и архитектуры)
2. Добавить дорожки в рипере (Lyrics и/или Chords). Названия должны совпадать, регистр не важен, но дорожки ищутся именно по названию
3. Добавить на эти дорожки элементы (Insert -> Empty item) и прописать в них аккорды и тексты на соответствующих дорожках, разместить элементы можно где нужно по времени и растянуть на сколько нужно
4. Добавить скрипт, назначить кнопку
5. Запустить скрипт, запустить приложение, зайти по адресу, который выдаст приложение или по r.qofa.ru

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

На этом пока что всё, но можно изучить страницу репозитория, там и демок побольше, и информации полезной тоже побольше, но статья в будущем ещё будет дополняться тоже)

1. js или JavaScript — такой интересный язык программирования, где в одной секунде 1000 миллисекунд, а 2+2=22, а не 4 ︎
2. веб-сокеты — классная технология, позволяющая серверу самому отправлять данные клиенту, без необходимости клиенту постоянно дёргать сервер по ajax и спрашивать «ну чё там, есть чё???» ︎
3. AJAX — Asynchronous Javascript and XML. Тоже классная технология, но не такая классная как веб-сокеты, но позволяет подгружать данные с сервера без перезагрузки страницы ︎

Вот так выглядел процесс пайки компонентов. За качество фото извиняюсь… Темно, да и руки тряслись, видимо )

Когда полностью собрали и почистили спиртом, попробовали включить. Экран светился не ярко, звука не было почти, лишь шум и какие-то потрескивания. А высокочастотный транзистор, что стоит почти в самом конце пути от источника звука до антенны, очень сильно грелся. И эта проблема была не только у нас, есть вот такой комментарий на али:

К счастью, программы ТВ у нас не ловились ))

Потом оказалось, что на частоте 108.0 оно не так сильно греется и линейный вход даже работает, в том смысле, что шума нет! И даже транслируется музыка с плеера успешно )
И стерео держится довольно далеко. А при наличие длинной антенны радиус действия ещё больше увеличивался )
Я ещё ходил потом по городу, слушал, где ловится, где нет, очень интересно было. И радиуса действия вполне хватало для одного помещения и для сцены, раз уж даже по городу в половине километра от точки передачи было слышно, хоть и с помехами (на пути были дома всякие, непонятно откуда взявшиеся в центре города).
Потом ещё тестировал в другом месте, антеннку (кусок раздербаненной витой пары) к окну, через небольшой микшерный пульт Behringer Xenyx 302USB, который имеет USB интерфейс, звук из аудиоплеера шёл в передающую плату. Можно было и без пульта этого, просто я пустил звук из плеера именно в этот микшер, используя его чисто как отдельную внешнюю звуковую плату, чтобы можно было вещать музыку в эфир, но при этом использовать компьютер как обычно, не мешая эфиру и себе )
В принципе, уже в таком виде можно было использовать это всё. Блок питания был взят от ненужного роутера. Как раз там 12 вольт и 1 ампер.

Ещё не плохо будет запихнуть эту систему в коробочку, чтобы при транспортировке случайно не повредить компоненты, да и чтобы эстетичнее выглядело. Коробочку уже нашёл — корпус от зарядника ноутбучного. Но пока ещё не собрал до конца )

Изначально предполагалось, что звук с микшера будет передаваться в эфир и приниматься на телефон через радио, где также будет запущен метроном (так как сейчас я барабанщиком являюсь и метроном весьма помогает). Но выяснилось, что мой телефон (Alcatel One Touch POP C3) воспроизводит звук с некоторой задержкой… Вот и радио воспроизводилось тоже с некоторой задержкой, где-то в пол секунды. И это всё сводило на нет возможность использовать метроном совместно с приёмом радио…
Через плеер всё работало как надо, но не было метронома. Тогда попробовал воспользовться тем самым мелким микшером, что уже есть у меня, пустить сразу звук и метроном в эфир. Вот этот вариант уже прокатил, как бонус — имеются физические крутилки громкости, что означает, что можно в любой момент сделать по-громче звук с главного микшерного выхода, где все инструменты, либо метрономный звук.
Таким образом эта схема была опробована на ближайшей репетиции. Выход на наушники, что был на главном микшерном пульте был подключен как линейный вход на моём маленьком микшере, а выход с телефона, где у меня метроном, был подключен к микрофонному входу. А выход с моего маленького микшера был подключен на вход передающей платы. И всё! Оно работает. Очень удобно было слышать остальных в наушниках, но при этом также и метроном тоже
А то до этого наушниками закрывал уши, там метроном щёлкал, а инструменты были не очень слышны, особенно высокие частоты, потому что наушники «капельки» хорошо их блокируют. Затем другие участники группы тоже подключились к этой частоте в своих телефонах. Оказалось, что ни у кого больше нет задержек при воспроизведении радио! Вот блинство!
Только у меня одного телефон с задержкой воспроизводит звук… ) Но это помогло придумать новую схему, при которой не только я слышал бы метроном, но и все! А это очень оказалось кстати! И стало намного удобнее всем играть. И прям качественный уровень поднялся даже! Чудно и клёво )
Вот и на последнем концертике, что был 11 марта, была опробована эта система в боевых действиях. Правда основной микшерный пульт находился далеко от меня, поэтому я бы не смог переключать сохранённые пресеты в метрономе. Поэтому был с нами ещё один замечательный человек, у которого был список песен. И он их переключал, а мы с гитаристом слышали метроном, а звук инструментов я не стал сильно выводить в эфир, потому что и так были в этот раз хорошие мониторы на сцене. Вот такая система! Дёшево и сердито
Конечно, минус в том, что у всех лишь один канал (зато стерео!) и только одно все могут слышать, нет возможности разным участникам группы разный звук посылать. Но даже при текущем варианте уже намного удобнее и лучше стало! К тому же, есть некоторые песни, где барабаны вступают не с самого начала, поэтому, чтобы не сбиваться и одинаковый темп держать, под метроном, что звучит у всех одинаково, могут играть другие, а потом вступить все как надо, и это круто, как я думаю

P.S.: в заголовке написано «для всех». И это означает, что для всех участников группы, но также и для любого, кто настроится на нужную частоту! Потому что это обычные радиоволны, и слушать их может любой! Это забавно )
Забавно не то, что радиоволны может слушать любой, а будет кто-нибудь на улице в машине слышать звук со сцены и щелчки метронома ))