Руководство пользователя

MACA — это приложение строки меню. После установки в строке меню macOS (правый верхний угол экрана) появляется маленькая иконка. Нажмите на неё, чтобы открыть главное окно.

Первый запуск

При первом запуске мастер настройки проведёт вас через:

1. Приветствие — Обзор разрешений, необходимых MACA.
2. Разрешение аудио — MACA использует Core Audio Taps для управления аудио каждого приложения. Кнопка откроет Системные настройки для предоставления доступа.
3. Уведомления — Опционально. Включает оповещения при обнаружении или автоматическом исправлении проблем со звуком.
4. Готово — Сводка ваших выборов. Вы можете вернуться и изменить любой шаг.

Запуск при входе

Чтобы MACA запускалась автоматически при входе, включите «Запуск при входе» в Настройки > Общие.

MACA находится в строке меню. Вы можете выбрать из четырёх стилей иконки в Настройки > Общие:

Стили иконки

Подробности индикатора уровня

Индикатор уровня обновляется 10 раз в секунду и отображает суммарный уровень аудио всех приложений, управляемых MACA.

• Обнаружение клиппинга: — Когда аудио превышает 98% на любом канале, полоса мигает полностью красным на 200 миллисекунд.
• Оптимизация энергии: — Индикатор автоматически приостанавливается при спящем дисплее и чисто сбрасывается при пробуждении.

Дополнительные поведения иконки

• Анимация — При включении иконка анимируется, пока любое приложение воспроизводит аудио. Не применяется к стилю Индикатор уровня.
• Автоскрытие — При включении иконка в строке меню скрывается через 5 минут без аудиоактивности. Появляется мгновенно, когда любое приложение начинает воспроизведение.

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

Общая громкость

Горизонтальный ползунок вверху управляет общей громкостью системы (0–100%). Слева и справа от ползунка:

• Заглушить все — Заглушает все приложения разом. Нажмите снова для отмены.
• Режим фокуса — Заглушает все, кроме приложений для связи (см. Раздел 7).
• Нормализатор — Автоматически балансирует уровни аудио между приложениями.Pro

Поиск и сортировка

• Поле поиска — Введите для фильтрации списка приложений по имени. Недавно использованные неактивные приложения также отображаются с кнопкой «Запустить».
• Сортировка — Выберите между Алфавитной (A-Z) и Недавней активностью.

Выбор профиля

Выпадающее меню для активации, деактивации или управления сохранёнными аудиопрофилями (см. Раздел 9).

Список приложений

Показывает все приложения, которые в данный момент воспроизводят аудио. Каждое приложение имеет свою строку с элементами управления.

• Зелёная точка указывает, что приложение воспроизводит аудио.
• Красный значок перечёркнутого динамика указывает, что приложение заглушено.

Системные процессы

Сворачиваемый раздел «Системные службы» показывает системные аудиопроцессы: звонки, уведомления, демонстрация экрана. Скрыт по умолчанию — включается в Настройки > Общие.

Дополнительные устройства

Сворачиваемый раздел с регулировкой громкости для всех подключённых устройств вывода, кроме устройства по умолчанию (см. Раздел 10).

Нижняя панель

• Устройство вывода по умолчанию — Выпадающее меню для смены аудиовыхода системы. Устройства сгруппированы: Локальные, Bluetooth, AirPlay.
• Настройки — (значок шестерёнки) — Открывает окно настроек.
• Выход — (значок питания) — Показывает диалог подтверждения, затем закрывает MACA. Все аудиотапы и виртуальные устройства очищаются при выходе.

Каждое приложение в списке показывает:

Как это работает

MACA использует Apple Core Audio Taps для перехвата аудиопотока каждого приложения. Громкость применяется в реальном времени с помощью цифровой обработки сигнала. Все аудиоканалы проходят без изменений — регулируется только усиление.

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

Выбор устройства

• Системное по умолчанию — Направляет приложение через устройство по умолчанию.
• Доступные устройства — Список всех подключённых устройств: встроенные динамики, USB-интерфейсы, HDMI, Bluetooth-наушники и др.
• Раздел Bluetooth — Показывает сопряжённые Bluetooth-устройства отдельно.

Нажмите кнопку EQ в строке приложения, чтобы открыть отдельное окно эквалайзера.

Элементы управления EQ

Пользовательские профили EQPro

Создавайте профили EQ в Настройки > Эквалайзер. Они появляются вверху списка пресетов. Можно переименовывать, редактировать и удалять.

EQ в Настройках

Настройки > Эквалайзер показывает обзор всех профилей EQ и приложений с настроенным EQ.

Режим фокуса заглушает всё аудио, кроме приложений для связи. Активируйте:

• Нажав на иконку телефона в области основных элементов управления.
• Используя горячую клавишу (по умолчанию: Option + Command + F).

При активации иконка телефона становится зелёной. Нажмите снова для деактивации.

Нормализатор автоматически выравнивает уровни аудио между приложениями, чтобы ни одно не было значительно громче или тише остальных.Pro

Активируйте нажатием на переключатель нормализатора. Когда нормализатор корректирует уровни более чем на 0,5 дБ, рядом появляется индикатор:

• Оранжевый при усилении (положительные дБ)
• Голубой при ослаблении (отрицательные дБ)

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

Создание профиля

1. Откройте Настройки > Профили.
2. Нажмите кнопку «+».
3. Введите имя и выберите иконку (10 вариантов).
4. Опционально включите «Захватить текущее состояние».

Активация профиля

• Из выпадающего меню в главном окне.
• В Настройки > Профили: наведите и нажмите галочку или дважды кликните.
• Через Быстрые команды: действие «Загрузить профиль».

Автосохранение

У каждого профиля есть переключатель автосохранения. При включении все изменения автоматически сохраняются в профиль.

Редактирование профиля

В Настройки > Профили выберите профиль и нажмите кнопку редактирования:

• Выбор иконки (выпадающее меню с SF Symbols).
• Поле имени.
• Список приложений в профиле с элементами управления.
• Кнопка «Добавить приложение».

Раздел «Дополнительные устройства» внизу главного окна показывает регуляторы громкости для всех подключённых устройств, кроме устройства по умолчанию.

Каждая строка устройства включает:

• Иконка устройства (встроенное, USB, Bluetooth, HDMI и т.д.).
• Название устройства.
• Ползунок громкости.
• Кнопка заглушения.
• Кнопка информации.

MACA поддерживает глобальные горячие клавиши. Настройте их в Настройки > Горячие клавиши.

Стандартные горячие клавиши

Настройка горячих клавиш

Нажмите поле записи рядом с горячей клавишей. Нажмите нужную комбинацию, затем кликните в другое место. Кнопка «Сбросить» восстанавливает стандартные значения.

Откройте Быстрые команды, создайте новую и найдите «MACA»:

Откройте через значок шестерёнки или правый клик на иконке в строке меню.

Общие

Видимость приложений

Управление отображением приложений.

• Переключение видимости (значок глаза).
• Поиск по имени или идентификатору.
• Фильтр скрытых.
• «Показать все» сбрасывает.
• «Очистить историю» удаляет записи.

Видимость устройств

Управление отображением устройств вывода.

• Переключение видимости (значок глаза).
• Поиск по имени.
• Тип транспорта и идентификатор.
• «Показать все» сбрасывает.
• «Очистить историю» удаляет записи.

Система

О программе

• Версия и номер сборки.
• Значок Pro или Free.
• Для Pro: благодарность. Для Free: кнопка «Обновить до Pro».
• Ссылки на сайт, поддержку, App Store.

MACA автоматически проверяет здоровье каждые 30 секунд. Ищет:

• Осиротевшие агрегатные устройства — от предыдущих сбоев.
• Осиротевшие аудиотапы — не подключённые к приложению.
• Конкурирующие приложения — которые могут мешать MACA.

При обнаружении проблемы MACA автоматически пытается исправить. Просмотр: Настройки > Система > История ремонтов.

Очистка при выходе

При выходе из MACA все аудиотапы и агрегатные устройства уничтожаются для чистого состояния системы.

Для обновления нажмите «Обновить до Pro» в Настройки > О программе. Покупка через App Store, восстановление на любом устройстве с тем же Apple ID.

Для подробных шагов посетите нашу страницу устранения неполадок:

MACA предоставляет локальный REST API для программного управления всеми аудиоприложениями. Идеально для автоматизации, Stream Deck, умного дома и скриптов.

curl http://127.0.0.1:59622/v1/status

{
  "app": "MACA",
  "version": "1.1.12",
  "build": "084",
  "apiVersion": "1",
  "features": {
    "perAppVolume": true,
    "perAppMute": true,
    "perAppRouting": true,
    "focusMode": true,
    "volumePreview": true,
    "masterVolume": true,
    "masterMute": true
  }
}

curl http://127.0.0.1:59622/v1/apps

curl -X PUT http://127.0.0.1:59622/v1/apps/com.spotify.client/volume \
  -H "Authorization: Bearer YOUR_GENERAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"volume": 0.5}'

# Status
curl -s http://127.0.0.1:59622/v1/status | python3 -m json.tool

# List apps
curl -s http://127.0.0.1:59622/v1/apps | python3 -m json.tool

# Get single app
curl -s http://127.0.0.1:59622/v1/apps/com.spotify.client | python3 -m json.tool

# List output devices
curl -s http://127.0.0.1:59622/v1/output-devices | python3 -m json.tool

# Set volume (needs token)
curl -X PUT http://127.0.0.1:59622/v1/apps/com.spotify.client/volume \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"volume": 0.5}'

# Mute an app
curl -X PUT http://127.0.0.1:59622/v1/apps/com.spotify.client/mute \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"muted": true}'

# Change default output device
curl -X PUT http://127.0.0.1:59622/v1/default-output-device \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"deviceUID": "BuiltInSpeakerDevice"}'

# Toggle focus mode
curl -X PUT http://127.0.0.1:59622/v1/focus-mode \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"active": true}'