Guida utente

MACA è un'app della barra dei menu. Dopo l'installazione, una piccola icona appare nella barra dei menu di macOS (angolo in alto a destra dello schermo). Cliccala per aprire la finestra principale.

Primo avvio

Al primo avvio, una procedura guidata ti accompagna attraverso:

1. Benvenuto — Panoramica dei permessi necessari a MACA.
2. Permesso audio — MACA utilizza i Core Audio Taps per controllare l'audio per app. Un pulsante apre le Impostazioni di Sistema per concedere l'accesso se richiesto.
3. Notifiche — Opzionale. Abilita avvisi quando vengono rilevati problemi audio o riparati automaticamente.
4. Fine — Riepilogo delle tue scelte. Puoi tornare indietro e modificare qualsiasi passaggio.

Avvia al login

Per avviare MACA automaticamente all'accesso, abilita "Avvia al login" in Impostazioni > Generali.

MACA si trova nella barra dei menu. Puoi scegliere tra quattro stili di icona in Impostazioni > Generali:

Stili icona

Dettagli dell'indicatore di livello

L'indicatore di livello si aggiorna 10 volte al secondo e mostra il livello audio combinato di tutte le app controllate da MACA.

• Rilevamento clipping: — Quando l'audio supera il 98% su uno dei canali, quella barra lampeggia completamente in rosso per 200 millisecondi.
• Ottimizzazione energetica: — L'indicatore si mette in pausa automaticamente quando il display è in standby e si ripristina correttamente al risveglio.

Comportamenti aggiuntivi dell'icona

• Animazione — Quando abilitata, l'icona si anima mentre un'app riproduce audio. Non si applica allo stile Indicatore di livello.
• Nascondi automaticamente — Quando abilitato, l'icona della barra dei menu si nasconde dopo 5 minuti senza attività audio. Riappare istantaneamente quando un'app inizia a riprodurre audio.

Clicca sull'icona della barra dei menu per aprire la finestra principale. Contiene le seguenti sezioni dall'alto verso il basso:

Volume principale

Un cursore orizzontale in alto controlla il volume principale del sistema (0–100%). A sinistra e a destra del cursore:

• Silenzia tutto — Silenzia tutte le app contemporaneamente. Premi di nuovo per riattivare.
• Modalità focus — Silenzia tutte le app tranne quelle di comunicazione (vedi Sezione 7).
• Normalizzatore — Bilancia automaticamente i livelli audio tra le app.Pro

Ricerca e ordinamento

• Campo di ricerca — Digita per filtrare la lista delle app per nome. Le app usate di recente ma non attive appaiono con un pulsante "Avvia".
• Ordinamento — Scegli tra Alfabetico (A-Z) e Attività recente.

Selettore profilo

Un menu a discesa ti permette di attivare, disattivare o gestire i profili audio salvati (vedi Sezione 9).

Lista app

Mostra tutte le app che attualmente producono audio. Ogni app ha la propria riga con controlli di volume.

• Un punto verde indica che l'app sta attualmente riproducendo audio.
• Un badge altoparlante barrato rosso indica che l'app è silenziata.

Processi di sistema

Una sezione espandibile etichettata "Servizi di sistema" mostra i processi audio di sistema come chiamate telefoniche, notifiche e condivisione schermo. Nascosta per impostazione predefinita — abilitala in Impostazioni > Generali.

Dispositivi secondari

Una sezione espandibile che mostra i controlli di volume per tutti i dispositivi di output collegati diversi dal dispositivo predefinito (vedi Sezione 10).

Piè di pagina

• Dispositivo di output predefinito — Un menu a discesa per cambiare l'output audio predefinito del sistema. I dispositivi sono raggruppati in Locale, Bluetooth e AirPlay.
• Impostazioni — (icona ingranaggio) — Apre la finestra Impostazioni.
• Esci — (icona alimentazione) — Mostra una finestra di conferma, poi chiude MACA. Tutti i tap audio e i dispositivi virtuali vengono puliti all'uscita.

Ogni app nella lista mostra:

Come funziona

MACA utilizza gli Apple Core Audio Taps per intercettare il flusso audio di ogni app. Il volume viene applicato in tempo reale tramite elaborazione digitale del segnale. Tutti i canali audio passano inalterati — viene regolato solo il guadagno.

Clicca sull'icona altoparlante/dispositivo su qualsiasi riga di app per aprire il selettore dispositivo di output. Questo ti permette di inviare l'audio di una singola app a un dispositivo di output diverso da quello predefinito del sistema.

Selettore dispositivo

• Usa predefinito di sistema — Instrada questa app attraverso l'output predefinito. Questo è il comportamento predefinito.
• Dispositivi disponibili — Elenca tutti i dispositivi di output collegati: altoparlanti integrati, interfacce audio USB, uscite HDMI, cuffie Bluetooth e altro.
• Sezione Bluetooth — Mostra i dispositivi audio Bluetooth accoppiati separatamente.

Clicca il pulsante EQ su qualsiasi riga di app per aprire una finestra EQ separata per quella app.

Controlli finestra EQ

Profili EQ personalizzatiPro

Crea profili EQ personalizzati in Impostazioni > Equalizzatore. I profili personalizzati appaiono in cima al selettore preset in ogni finestra EQ. Puoi rinominare, modificare ed eliminare i profili personalizzati dalle Impostazioni.

EQ nelle Impostazioni

Impostazioni > Equalizzatore mostra una panoramica di tutti i profili EQ personalizzati e di tutte le app con impostazioni EQ configurate. Da lì puoi aprire la finestra EQ di qualsiasi app, ripristinare l'EQ di un'app o gestire i tuoi profili personalizzati.

La Modalità focus silenzia tutto l'audio tranne le app di comunicazione. Attivala:

• Cliccando sull'icona del telefono nell'area dei controlli principali della finestra principale.
• Usando la scorciatoia da tastiera (predefinita: Option + Command + F).

Quando attiva, l'icona del telefono diventa verde. Premi di nuovo o usa la scorciatoia per disattivare.

Il Normalizzatore bilancia automaticamente i livelli audio di tutte le app in modo che nessuna app sia significativamente più forte o più debole delle altre.Pro

Attivalo cliccando sul pulsante del normalizzatore nell'area dei controlli principali. Quando il normalizzatore sta regolando attivamente i livelli di più di 0,5 dB, appare un piccolo indicatore di guadagno accanto al pulsante:

• Colorato arancione durante l'amplificazione (dB positivi)
• Colorato ciano durante l'attenuazione (dB negativi)

I profili salvano un'istantanea della tua configurazione audio — volume per app, stato silenziamento, assegnazione dispositivo di output e impostazioni EQ — così puoi passare da una configurazione all'altra con un clic.

Creare un profilo

1. Apri Impostazioni > Profili.
2. Clicca il pulsante "+".
3. Inserisci un nome e scegli un'icona dalla griglia (10 icone disponibili).
4. Opzionalmente abilita "Cattura stato attuale" per salvare le impostazioni correnti di tutte le app in esecuzione nel nuovo profilo.

Attivare un profilo

• Dal menu a discesa del selettore profili nella finestra principale.
• Da Impostazioni > Profili passando il mouse su un profilo e cliccando il segno di spunta, o doppio clic.
• Tramite l'app Comandi Rapidi: azione "Carica profilo".

Salvataggio automatico

Ogni profilo ha un interruttore di salvataggio automatico. Quando abilitato, qualsiasi modifica di volume, silenziamento, dispositivo o EQ effettuata mentre il profilo è attivo viene salvata automaticamente nel profilo.

Modificare un profilo

In Impostazioni > Profili, seleziona un profilo e clicca il pulsante modifica. La vista dettagliata mostra:

• Selettore icona (menu a discesa con SF Symbols).
• Campo nome.
• Lista di tutte le app nel profilo, ognuna con: icona, nome, interruttore silenziamento, cursore volume, selettore dispositivo di output, selettore preset EQ e pulsante rimuovi.
• Pulsante "Aggiungi app" per includere app aggiuntive in esecuzione o dalla cronologia.

La sezione Dispositivi secondari in fondo alla finestra principale mostra i controlli di volume per tutti i dispositivi di output collegati diversi dal dispositivo predefinito attuale.

Ogni riga dispositivo include:

• Icona dispositivo (basata sul tipo di trasporto: integrato, USB, Bluetooth, HDMI, ecc.).
• Nome dispositivo.
• Cursore volume.
• Pulsante silenziamento.
• Pulsante info (apre un popover con i dettagli del dispositivo).

MACA supporta scorciatoie da tastiera globali che funzionano da qualsiasi app. Configurale in Impostazioni > Scorciatoie.

Scorciatoie predefinite

Personalizzare le scorciatoie

Clicca il campo di registrazione accanto a qualsiasi scorciatoia per assegnare una nuova combinazione di tasti. Premi la scorciatoia desiderata, poi clicca altrove per confermare. Usa il pulsante "Ripristina predefiniti" per ripristinare tutte le scorciatoie ai valori originali.

Apri l'app Comandi Rapidi, crea un nuovo comando rapido e cerca "MACA" per trovare queste azioni:

Apri le Impostazioni dall'icona ingranaggio nel piè di pagina della finestra principale, o cliccando col tasto destro sull'icona della barra dei menu.

Generali

Visibilità app

Controlla quali app appaiono nella finestra principale.

• Attiva/disattiva la visibilità per le singole app (icona occhio).
• Cerca per nome app o identificatore bundle.
• Filtra per mostrare solo le app nascoste.
• "Mostra tutte le app" ripristina tutte le app come visibili.
• "Cancella cronologia" rimuove il registro delle app viste in precedenza.

Visibilità dispositivi

Controlla quali dispositivi di output appaiono nella sezione Dispositivi secondari.

• Attiva/disattiva la visibilità per i singoli dispositivi (icona occhio).
• Cerca per nome dispositivo.
• Ogni dispositivo mostra il tipo di trasporto e l'identificatore unico.
• "Mostra tutti i dispositivi" ripristina tutti come visibili.
• "Cancella cronologia" rimuove il registro dei dispositivi visti in precedenza.

Sistema

Informazioni

• Versione e numero di build di MACA.
• Badge livello Pro o Free.
• Per utenti Pro: un messaggio di ringraziamento. Per utenti Free: un pulsante "Passa a Pro".
• Link al sito web MACA, email di supporto, pagina App Store e cronologia versioni.

MACA esegue un controllo automatico della salute ogni 30 secondi in background. Cerca:

• Dispositivi aggregati orfani — da crash precedenti o terminazioni anomale.
• Tap audio orfani — che non sono più collegati a un'app in esecuzione.
• App concorrenti — che potrebbero interferire con MACA.

Quando viene trovato un problema, MACA tenta di ripararlo automaticamente. Puoi consultare le riparazioni in Impostazioni > Sistema > Cronologia riparazioni.

Pulizia all'uscita

Quando chiudi MACA (o se il processo viene terminato da SIGTERM, SIGINT o SIGQUIT), tutti i tap audio e i dispositivi aggregati vengono distrutti per lasciare il sistema in uno stato pulito.

Per effettuare l'upgrade, clicca il pulsante "Passa a Pro" in Impostazioni > Informazioni, o clicca l'icona lucchetto su qualsiasi funzione limitata a Pro. L'acquisto viene gestito tramite l'App Store e può essere ripristinato su qualsiasi dispositivo con lo stesso Apple ID.

Per passaggi dettagliati di risoluzione dei problemi, visita la nostra pagina dedicata:

MACA fornisce un'API REST locale che permette di controllare programmaticamente tutte le app che producono audio. Perfetta per flussi di automazione, integrazioni Stream Deck, configurazioni smart home e script personalizzati.

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