Установка на macOS

In English

Музыкальный визуализатор: слушает то, что играет на вашем Mac, и рисует под это.

Это ранняя тестовая сборка. Она не подписана Apple и до вас не запускалась ни на одном Mac - поэтому пара шагов ниже выглядит непривычно. Так и должно быть. Пожалуйста, прочитайте это до того, как что-нибудь запускать: на шагах 1 и 2 застревают чаще всего.

Нужна macOS 13 (Ventura) или новее.

1. Разрешить запуск

---

macOS блокирует загруженные из интернета приложения, которые Apple не подписала. Наше не подписано, поэтому разрешить придётся вручную, один раз.

Простой способ: правый клик (или Control-клик) по Ritmolux.app, выберите Open, затем ещё раз Open в диалоге. Нужно только в первый раз.

Способ через терминал, если диалог не уходит - перейдите (cd) в эту папку и выполните:

xattr -dr com.apple.quarantine Ritmolux.app

После этого открывайте как обычно.

2. Выдайте доступ к записи экрана, затем ЗАКРОЙТЕ И ОТКРОЙТЕ ПРИЛОЖЕНИЕ

---

На macOS нет способа слушать системный звук напрямую. Единственный официальный путь считается записью экрана - поэтому такое разрешение приложение и просит. Мы не записываем, не храним и не отправляем ваш экран: приложение выбрасывает видео и оставляет звук.

Когда появится запрос, разрешите. В нём должно быть имя “Ritmolux”.

Затем закройте приложение и откройте снова. Этот шаг легко пропустить: приложение не может подхватить разрешение на ходу, поэтому слышать начинает только первый запуск после выдачи доступа.

Если вы пропустили запрос, разрешение выдаётся в System Settings > Privacy & Security > Screen Recording.

3. Если картинка есть, но она не реагирует на музыку

---

Это не сбой, и приложение работает - оно рисует холостую анимацию, потому что звук до него не дошёл. Почти всегда это значит, что шаг 2 не был завершён: разрешение не выдано или приложение не перезапущено после выдачи.

Приложение само говорит, что именно произошло. Любого из этих двух ответов достаточно, и терминал не нужен ни для одного:

• Нажмите F3. В панели диагностики есть строка, начинающаяся с “audio”. Если она начинается с “live SCK”, звук до приложения доходит и дело в чём-то другом - проверьте, что музыка действительно играет. Если там “failed SCK …”, остаток строки - это причина. Достаточно фотографии экрана.

• Или откройте diagnostics.log (шаг 5 ниже). Его последний столбец называется “capture” и несёт ту же фразу в каждой строке.

Пришлите то, что получилось увидеть - эта строка и есть весь ответ.

Если ни то, ни другое почему-то недоступно, запасной путь - запустить приложение из терминала, оно печатает ту же причину при старте: перейдите (cd) в эту папку и выполните:

./Ritmolux.app/Contents/MacOS/ritmolux

4. Управление

Space   следующий пресет
Tab     список всех пресетов (стрелки - выбор, Enter - применить,
        Esc - закрыть)
S       настройки (качество, полный экран, монитор)
F       полный экран
F3      частота кадров и диагностика
A       автосмена пресетов вкл/выкл (по умолчанию выключена)

Выйти можно по Command-Q или закрыв окно. (Escape только закрывает меню и из приложения не выходит, а в полном экране кнопки окна нет - поэтому сначала выйдите из полного экрана клавишей F или нажмите Command-Q.)

5. Где лежат файлы

---

~/Library/Application Support/ritmolux/

В этой папке лежит редактируемая копия пресетов, config.toml с вашими настройками и diagnostics.log. Удаление папки сбрасывает приложение; она создаётся заново при следующем запуске.

Папка presets рядом с этим файлом - справочная копия, её можно читать. Приложение её не загружает: у него своя, встроенная.

6. Что прислать в ответ

---

Шесть пунктов, пусть и приблизительно:

• Открылось ли приложение вообще?
• Было ли в запросе разрешения имя “Ritmolux”?
• После выдачи доступа и перезапуска реагирует ли картинка на музыку?
• Какую частоту кадров показывает F3 и что написано в его строке “audio”?
• Содержимое файла diagnostics.log из папки, указанной в шаге 5.
• Если что-то пошло не так - что шаг 3 назвал причиной.

Спасибо - эта сборка существует ради того, чтобы выяснить, что ломается.

Про обновления

Каждая новая сборка, которую мы вам присылаем, - это с точки зрения macOS другое приложение, поэтому доступ к записи экрана придётся выдавать заново каждый раз, а старые записи будут накапливаться в списке Privacy. Неприятно и известно. Удалять старые записи безопасно.