Guía del usuario

MACA es una app de barra de menú. Después de la instalación, aparece un pequeño icono en la barra de menú de macOS (esquina superior derecha de la pantalla). Haz clic para abrir la ventana principal.

Primer inicio

En el primer inicio, un asistente de configuración te guía a través de:

1. Bienvenida — Resumen de los permisos que MACA necesita.
2. Permiso de audio — MACA usa Core Audio Taps para controlar el audio por app. Un botón abre Ajustes del Sistema para que puedas conceder acceso si se te solicita.
3. Notificaciones — Opcional. Activa alertas cuando se detectan problemas de audio o se reparan automáticamente.
4. Finalizar — Resumen de tus elecciones. Puedes volver atrás y cambiar cualquier paso.

Iniciar al iniciar sesión

Para iniciar MACA automáticamente al iniciar sesión, activa "Iniciar al iniciar sesión" en Ajustes > General.

MACA se encuentra en la barra de menú. Puedes elegir entre cuatro estilos de icono en Ajustes > General:

Estilos de icono

Detalles del medidor de nivel

El medidor de nivel se actualiza 10 veces por segundo y muestra el nivel de audio combinado de todas las apps controladas por MACA.

• Detección de recorte: — Cuando el audio supera el 98% en cualquier canal, esa barra parpadea completamente en rojo durante 200 milisegundos.
• Optimización de energía: — El medidor se pausa automáticamente cuando la pantalla está en reposo y se reinicia limpiamente al despertar.

Comportamientos adicionales del icono

• Animación — Cuando está activada, el icono se anima mientras cualquier app reproduce audio. No aplica al estilo Medidor de nivel.
• Ocultamiento automático — Cuando está activado, el icono de la barra de menú se oculta después de 5 minutos sin actividad de audio. Reaparece instantáneamente cuando cualquier app comienza a reproducir audio.

Haz clic en el icono de la barra de menú para abrir la ventana principal. Contiene las siguientes secciones de arriba a abajo:

Volumen maestro

Un deslizador horizontal en la parte superior controla el volumen maestro del sistema (0–100%). A la izquierda y derecha del deslizador:

• Silenciar todo — Silencia todas las apps a la vez. Presiona de nuevo para reactivar.
• Modo enfoque — Silencia todas las apps excepto las de comunicación (ver Sección 7).
• Normalizador — Equilibra automáticamente los niveles de audio entre apps.Pro

Búsqueda y ordenación

• Campo de búsqueda — Escribe para filtrar la lista de apps por nombre. Las apps usadas recientemente que no están activas también aparecen con un botón "Iniciar".
• Orden — Elige entre Alfabético (A-Z) y Actividad reciente.

Selector de perfil

Un menú desplegable te permite activar, desactivar o gestionar perfiles de audio guardados (ver Sección 9).

Lista de apps

Muestra todas las apps que actualmente producen audio. Cada app tiene su propia fila con controles de volumen.

• Un punto verde indica que la app está reproduciendo audio actualmente.
• Una insignia de altavoz tachado en rojo indica que la app está silenciada.

Procesos del sistema

Una sección desplegable etiquetada "Servicios del sistema" muestra procesos de audio del sistema como llamadas telefónicas, notificaciones y pantalla compartida. Oculta por defecto — actívala en Ajustes > General.

Dispositivos secundarios

Una sección desplegable que muestra controles de volumen para todos los dispositivos de salida conectados excepto el dispositivo predeterminado (ver Sección 10).

Pie de página

• Dispositivo de salida predeterminado — Un desplegable para cambiar la salida de audio predeterminada del sistema. Los dispositivos están agrupados en Local, Bluetooth y AirPlay.
• Ajustes — (icono de engranaje) — Abre la ventana de Ajustes.
• Salir — (icono de apagar) — Muestra un diálogo de confirmación y luego cierra MACA. Todos los taps de audio y dispositivos virtuales se limpian al salir.

Cada app en la lista muestra:

Cómo funciona

MACA usa Apple Core Audio Taps para interceptar el flujo de audio de cada app. El volumen se aplica en tiempo real usando procesamiento digital de señal. Todos los canales de audio pasan sin modificar — solo se ajusta la ganancia.

Haz clic en el icono de altavoz/dispositivo en cualquier fila de app para abrir el selector de dispositivo de salida. Esto te permite enviar el audio de una app individual a un dispositivo de salida diferente al predeterminado del sistema.

Selector de dispositivo

• Usar predeterminado del sistema — Dirige esta app a través de la salida predeterminada. Este es el comportamiento por defecto.
• Dispositivos disponibles — Lista todos los dispositivos de salida conectados: altavoces integrados, interfaces de audio USB, salidas HDMI, auriculares Bluetooth y más.
• Sección Bluetooth — Muestra los dispositivos de audio Bluetooth emparejados por separado.

Haz clic en el botón EQ en cualquier fila de app para abrir una ventana de EQ separada para esa app.

Controles de la ventana EQ

Perfiles de EQ personalizadosPro

Crea perfiles de EQ personalizados en Ajustes > Ecualizador. Los perfiles personalizados aparecen en la parte superior del selector de presets en cada ventana de EQ. Puedes renombrar, editar y eliminar perfiles personalizados desde Ajustes.

EQ en Ajustes

Ajustes > Ecualizador muestra un resumen de todos los perfiles de EQ personalizados y todas las apps con ajustes de EQ configurados. Desde ahí puedes abrir la ventana de EQ de cualquier app, restablecer el EQ de una app o gestionar tus perfiles personalizados.

El Modo enfoque silencia todo el audio excepto las apps de comunicación. Actívalo:

• Haciendo clic en el icono de teléfono en el área de controles maestros de la ventana principal.
• Usando el atajo de teclado (predeterminado: Option + Command + F).

Cuando está activo, el icono del teléfono se pone verde. Presiona de nuevo o usa el atajo para desactivar.

El Normalizador equilibra automáticamente los niveles de audio entre todas las apps para que ninguna app sea significativamente más fuerte o más suave que las demás.Pro

Actívalo haciendo clic en el botón del normalizador en el área de controles maestros. Cuando el normalizador está ajustando activamente los niveles en más de 0,5 dB, aparece un pequeño indicador de ganancia junto al botón:

• Color naranja al aumentar (dB positivos)
• Color cian al reducir (dB negativos)

Los perfiles guardan una instantánea de tu configuración de audio — volumen por app, estado de silencio, asignación de dispositivo de salida y ajustes de EQ — para que puedas cambiar entre configuraciones con un solo clic.

Crear un perfil

1. Abre Ajustes > Perfiles.
2. Haz clic en el botón "+".
3. Introduce un nombre y elige un icono de la cuadrícula (10 iconos disponibles).
4. Opcionalmente activa "Capturar estado actual" para guardar los ajustes actuales de todas las apps en ejecución en el nuevo perfil.

Activar un perfil

• Desde el desplegable del selector de perfiles en la ventana principal.
• Desde Ajustes > Perfiles pasando el cursor sobre un perfil y haciendo clic en la marca, o doble clic.
• A través de la app Atajos: acción "Cargar perfil".

Guardado automático

Cada perfil tiene un interruptor de Guardado automático. Cuando está activado, cualquier cambio de volumen, silencio, dispositivo o EQ que realices mientras el perfil está activo se guarda automáticamente en el perfil.

Editar un perfil

En Ajustes > Perfiles, selecciona un perfil y haz clic en el botón de editar. La vista de detalle muestra:

• Selector de icono (menú desplegable con SF Symbols).
• Campo de nombre.
• Lista de todas las apps en el perfil, cada una con: icono, nombre, botón de silencio, deslizador de volumen, selector de dispositivo de salida, selector de preset de EQ y botón de eliminar.
• Botón "Añadir app" para incluir apps adicionales en ejecución o del historial.

La sección de Dispositivos secundarios en la parte inferior de la ventana principal muestra controles de volumen para todos los dispositivos de salida conectados excepto el dispositivo predeterminado actual.

Cada fila de dispositivo incluye:

• Icono del dispositivo (basado en el tipo de transporte: integrado, USB, Bluetooth, HDMI, etc.).
• Nombre del dispositivo.
• Deslizador de volumen.
• Botón de silencio.
• Botón de información (abre un popover con detalles del dispositivo).

MACA admite atajos de teclado globales que funcionan desde cualquier app. Configúralos en Ajustes > Atajos.

Atajos predeterminados

Personalizar atajos

Haz clic en el campo de grabación junto a cualquier atajo para asignar una nueva combinación de teclas. Presiona tu atajo deseado y luego haz clic en otro lugar para confirmar. Usa el botón "Restablecer valores predeterminados" para restaurar todos los atajos a sus valores originales.

Abre la app Atajos, crea un nuevo atajo y busca "MACA" para encontrar estas acciones:

Abre Ajustes desde el icono de engranaje en el pie de página de la ventana principal, o haciendo clic derecho en el icono de la barra de menú.

General

Visibilidad de apps

Controla qué apps aparecen en la ventana principal.

• Alternar visibilidad para apps individuales (icono de ojo).
• Buscar por nombre de app o identificador de paquete.
• Filtrar para mostrar solo apps ocultas.
• "Mostrar todas las apps" restablece todas las apps como visibles.
• "Borrar historial" elimina el registro de apps vistas anteriormente.

Visibilidad de dispositivos

Controla qué dispositivos de salida aparecen en la sección de Dispositivos secundarios.

• Alternar visibilidad para dispositivos individuales (icono de ojo).
• Buscar por nombre de dispositivo.
• Cada dispositivo muestra su tipo de transporte e identificador único.
• "Mostrar todos los dispositivos" restablece todos como visibles.
• "Borrar historial" elimina el registro de dispositivos vistos anteriormente.

Sistema

Acerca de

• Versión y número de compilación de MACA.
• Insignia de nivel Pro o Free.
• Para usuarios Pro: un mensaje de agradecimiento. Para usuarios Free: un botón "Actualizar a Pro".
• Enlaces al sitio web de MACA, correo de soporte, página del App Store e historial de versiones.

MACA ejecuta un chequeo de salud automático cada 30 segundos en segundo plano. Busca:

• Dispositivos agregados huérfanos — de fallos anteriores o terminaciones anormales.
• Taps de audio huérfanos — que ya no están conectados a una app en ejecución.
• Apps conflictivas — que pueden interferir con MACA.

Cuando se encuentra un problema, MACA intenta repararlo automáticamente. Puedes revisar las reparaciones en Ajustes > Sistema > Historial de reparaciones.

Limpieza al salir

Cuando cierras MACA (o si el proceso es terminado por SIGTERM, SIGINT o SIGQUIT), todos los taps de audio y dispositivos agregados se destruyen para dejar tu sistema en un estado limpio.

Para actualizar, haz clic en el botón "Actualizar a Pro" en Ajustes > Acerca de, o haz clic en el icono de candado en cualquier función restringida a Pro. La compra se gestiona a través del App Store y puede restaurarse en cualquier dispositivo con el mismo Apple ID.

Para pasos detallados de solución de problemas, visita nuestra página dedicada:

MACA proporciona una API REST local que te permite controlar todas las apps que producen audio de forma programática. Perfecto para flujos de automatización, integraciones con Stream Deck, configuraciones de hogar inteligente y scripts personalizados.

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}'