Benutzerhandbuch

MACA ist eine Menüleisten-App. Nach der Installation erscheint ein kleines Symbol in der macOS-Menüleiste (oben rechts auf dem Bildschirm). Klicke darauf, um das Hauptfenster zu öffnen.

Erster Start

Beim ersten Start führt dich ein Einrichtungsassistent durch:

1. Willkommen — Übersicht der Berechtigungen, die MACA benötigt.
2. Audio-Berechtigung — MACA verwendet Core Audio Taps zur App-weisen Audiosteuerung. Ein Button öffnet die Systemeinstellungen, damit du bei Bedarf den Zugriff gewähren kannst.
3. Benachrichtigungen — Optional. Aktiviert Hinweise, wenn Audioprobleme erkannt oder automatisch behoben werden.
4. Fertig — Zusammenfassung deiner Auswahl. Du kannst jeden Schritt erneut ändern.

Bei Anmeldung starten

Um MACA automatisch beim Anmelden zu starten, aktiviere „Bei Anmeldung starten" in Einstellungen > Allgemein.

MACA befindet sich in der Menüleiste. Du kannst zwischen vier Symbolstilen in Einstellungen > Allgemein wählen:

Symbolstile

Details zur Pegelanzeige

Die Pegelanzeige aktualisiert sich 10 Mal pro Sekunde und zeigt den kombinierten Audiopegel aller von MACA gesteuerten Apps.

• Clipping-Erkennung: — Wenn der Audiopegel auf einem Kanal 98 % überschreitet, blinkt dieser Balken für 200 Millisekunden vollständig rot.
• Energieoptimierung: — Die Anzeige pausiert automatisch bei Display-Ruhezustand und setzt sich beim Aufwachen sauber zurück.

Weitere Symbolverhalten

• Animation — Wenn aktiviert, animiert das Symbol während eine App Audio abspielt. Gilt nicht für den Pegelanzeige-Stil.
• Automatisches Ausblenden — Wenn aktiviert, wird das Menüleisten-Symbol nach 5 Minuten ohne Audioaktivität ausgeblendet. Es erscheint sofort wieder, wenn eine App Audio abspielt.

Klicke auf das Menüleisten-Symbol, um das Hauptfenster zu öffnen. Es enthält folgende Bereiche von oben nach unten:

Master-Lautstärke

Ein horizontaler Schieberegler oben steuert die System-Master-Lautstärke (0–100 %). Links und rechts des Reglers:

• Alle stummschalten — Schaltet alle Apps auf einmal stumm. Erneut drücken zum Aufheben.
• Fokusmodus — Schaltet alle Apps stumm außer Kommunikations-Apps (siehe Abschnitt 7).
• Normalizer — Gleicht die Audiopegel aller Apps automatisch an.Pro

Suche und Sortierung

• Suchfeld — Tippe, um die App-Liste nach Namen zu filtern. Kürzlich verwendete, aber inaktive Apps erscheinen ebenfalls mit einem „Starten"-Button.
• Sortierung — Wähle zwischen Alphabetisch (A-Z) und Letzte Aktivität.

Profilauswahl

Ein Dropdown-Menü zum Aktivieren, Deaktivieren oder Verwalten gespeicherter Audioprofile (siehe Abschnitt 9).

App-Liste

Zeigt alle Apps, die derzeit Audio ausgeben. Jede App hat eine eigene Zeile mit Lautstärkereglern.

• Ein grüner Punkt zeigt an, dass die App gerade Audio abspielt.
• Ein rotes durchgestrichenes Lautsprecher-Symbol zeigt an, dass die App stummgeschaltet ist.

Systemprozesse

Ein ausklappbarer Bereich mit dem Label „Systemdienste" zeigt System-Audioprozesse wie Telefonanrufe, Benachrichtigungen und Bildschirmfreigabe. Standardmäßig ausgeblendet — aktivierbar in Einstellungen > Allgemein.

Sekundäre Geräte

Ein ausklappbarer Bereich mit Lautstärkereglern für alle angeschlossenen Ausgabegeräte außer dem Standardgerät (siehe Abschnitt 10).

Fußzeile

• Standard-Ausgabegerät — Ein Dropdown zum Ändern der systemweiten Standard-Audioausgabe. Geräte sind in Lokal, Bluetooth und AirPlay gruppiert.
• Einstellungen — (Zahnrad-Symbol) — Öffnet das Einstellungsfenster.
• Beenden — (Power-Symbol) — Zeigt einen Bestätigungsdialog und beendet dann MACA. Alle Audio-Taps und virtuellen Geräte werden beim Beenden aufgeräumt.

Jede App in der Liste zeigt:

Funktionsweise

MACA verwendet Apple Core Audio Taps, um den Audiostream jeder App abzufangen. Die Lautstärke wird in Echtzeit mittels digitaler Signalverarbeitung angewendet. Alle Audiokanäle passieren unverändert — nur die Verstärkung wird angepasst.

Klicke auf das Lautsprecher-/Geräte-Symbol in einer App-Zeile, um die Ausgabegeräte-Auswahl zu öffnen. So kannst du das Audio einer einzelnen App an ein anderes Ausgabegerät als den Systemstandard senden.

Geräteauswahl

• Systemstandard verwenden — Leitet die App über den Standard-Ausgang. Dies ist das Standardverhalten.
• Verfügbare Geräte — Listet alle angeschlossenen Ausgabegeräte: eingebaute Lautsprecher, USB-Audio-Interfaces, HDMI-Ausgänge, Bluetooth-Kopfhörer und mehr.
• Bluetooth-Bereich — Zeigt gekoppelte Bluetooth-Audiogeräte separat an.

Klicke den EQ-Button in einer App-Zeile, um ein separates EQ-Fenster für diese App zu öffnen.

EQ-Fenster-Steuerungen

Eigene EQ-ProfilePro

Erstelle eigene EQ-Profile in Einstellungen > Equalizer. Eigene Profile erscheinen oben in der Preset-Auswahl jedes EQ-Fensters. Du kannst sie in den Einstellungen umbenennen, bearbeiten und löschen.

EQ in den Einstellungen

Einstellungen > Equalizer zeigt eine Übersicht aller eigenen EQ-Profile und aller Apps mit konfigurierten EQ-Einstellungen. Von dort kannst du das EQ-Fenster einer App öffnen, den EQ zurücksetzen oder deine eigenen Profile verwalten.

Der Fokusmodus schaltet alle Audios stumm außer Kommunikations-Apps. Aktiviere ihn durch:

• Klicken auf das Telefon-Symbol im Master-Steuerungsbereich des Hauptfensters.
• Verwenden des Tastenkürzels (Standard: Option + Command + F).

Bei Aktivierung wird das Telefon-Symbol grün. Erneut drücken oder das Tastenkürzel verwenden zum Deaktivieren.

Der Normalizer gleicht automatisch die Audiopegel aller Apps an, sodass keine einzelne App deutlich lauter oder leiser als andere ist.Pro

Aktiviere ihn durch Klicken auf den Normalizer-Schalter im Master-Steuerungsbereich. Wenn der Normalizer die Pegel um mehr als 0,5 dB anpasst, erscheint ein kleiner Gain-Indikator neben dem Schalter:

• Orange gefärbt bei Verstärkung (positiver dB-Wert)
• Cyan gefärbt bei Absenkung (negativer dB-Wert)

Profile speichern einen Schnappschuss deiner Audio-Konfiguration — App-Lautstärke, Stummschaltung, Ausgabegeräte-Zuweisung und EQ-Einstellungen — damit du mit einem Klick zwischen verschiedenen Setups wechseln kannst.

Profil erstellen

1. Öffne Einstellungen > Profile.
2. Klicke den „+"-Button.
3. Gib einen Namen ein und wähle ein Symbol aus dem Raster (10 Symbole verfügbar).
4. Aktiviere optional „Aktuellen Zustand erfassen", um die Einstellungen aller laufenden Apps im neuen Profil zu speichern.

Profil aktivieren

• Über das Profil-Dropdown im Hauptfenster.
• Über Einstellungen > Profile durch Hover über ein Profil und Klick auf das Häkchen oder per Doppelklick.
• Über die Kurzbefehle-App: Aktion „Profil laden".

Automatisches Speichern

Jedes Profil hat einen Auto-Speicher-Schalter. Wenn aktiviert, werden alle Lautstärke-, Stummschaltungs-, Geräte- oder EQ-Änderungen, die du bei aktivem Profil vornimmst, automatisch ins Profil zurückgespeichert.

Profil bearbeiten

In Einstellungen > Profile wähle ein Profil und klicke den Bearbeiten-Button. Die Detailansicht zeigt:

• Symbolauswahl (Dropdown-Menü mit SF Symbols).
• Namensfeld.
• Liste aller Apps im Profil, jeweils mit: Symbol, Name, Stummschalter, Lautstärkeregler, Ausgabegeräte-Auswahl, EQ-Preset-Auswahl und Entfernen-Button.
• „App hinzufügen"-Button zum Hinzufügen weiterer Apps aus laufenden oder früheren Apps.

Der Bereich „Sekundäre Geräte" am unteren Rand des Hauptfensters zeigt Lautstärkeregler für alle angeschlossenen Ausgabegeräte außer dem aktuellen Standardgerät.

Jede Gerätezeile enthält:

• Gerätesymbol (basierend auf dem Verbindungstyp: Eingebaut, USB, Bluetooth, HDMI usw.).
• Gerätename.
• Lautstärkeregler.
• Stummschalten-Button.
• Info-Button (öffnet ein Popover mit Gerätedetails).

MACA unterstützt globale Tastenkürzel, die in jeder App funktionieren. Konfiguriere sie in Einstellungen > Tastenkürzel.

Standard-Tastenkürzel

Tastenkürzel anpassen

Klicke das Aufnahmefeld neben einem Tastenkürzel, um eine neue Tastenkombination zuzuweisen. Drücke dein gewünschtes Kürzel und klicke dann anderswo zur Bestätigung. Verwende den „Auf Standard zurücksetzen"-Button, um alle Kürzel auf ihre ursprünglichen Werte zurückzusetzen.

Öffne die Kurzbefehle-App, erstelle einen neuen Kurzbefehl und suche nach „MACA", um diese Aktionen zu finden:

Öffne die Einstellungen über das Zahnrad-Symbol in der Fußzeile des Hauptfensters oder durch Rechtsklick auf das Menüleisten-Symbol.

Allgemein

App-Sichtbarkeit

Steuere, welche Apps im Hauptfenster erscheinen.

• Sichtbarkeit für einzelne Apps umschalten (Augen-Symbol).
• Suche nach App-Name oder Bundle-Identifier.
• Filter, um nur ausgeblendete Apps anzuzeigen.
• „Alle Apps anzeigen" setzt alle Apps auf sichtbar zurück.
• „Verlauf löschen" entfernt die Aufzeichnung zuvor gesehener Apps.

Gerätesichtbarkeit

Steuere, welche Ausgabegeräte im Bereich Sekundäre Geräte erscheinen.

• Sichtbarkeit für einzelne Geräte umschalten (Augen-Symbol).
• Suche nach Gerätename.
• Jedes Gerät zeigt seinen Verbindungstyp und eindeutigen Identifier.
• „Alle Geräte anzeigen" setzt alle auf sichtbar zurück.
• „Verlauf löschen" entfernt die Aufzeichnung zuvor gesehener Geräte.

System

Über

• MACA-Version und Build-Nummer.
• Pro- oder Free-Badge.
• Für Pro-Nutzer: eine Dankesnachricht. Für Free-Nutzer: ein „Auf Pro upgraden"-Button.
• Links zur MACA-Website, Support-E-Mail, App Store-Seite und Versionshistorie.

MACA führt alle 30 Sekunden automatisch einen Gesundheitscheck im Hintergrund durch. Dabei wird gesucht nach:

• Verwaisten Aggregatgeräten — von früheren Abstürzen oder ungewöhnlichen Beendigungen.
• Verwaisten Audio-Taps — die nicht mehr mit einer laufenden App verbunden sind.
• Konkurrierenden Apps — die MACA beeinträchtigen könnten.

Wenn ein Problem gefunden wird, versucht MACA es automatisch zu reparieren. Du kannst Reparaturen unter Einstellungen > System > Reparaturverlauf einsehen.

Aufräumen beim Beenden

Wenn du MACA beendest (oder wenn der Prozess durch SIGTERM, SIGINT oder SIGQUIT terminiert wird), werden alle Audio-Taps und Aggregatgeräte zerstört, um dein System in einem sauberen Zustand zu hinterlassen.

Zum Upgraden klicke den „Auf Pro upgraden"-Button in Einstellungen > Über, oder klicke das Schloss-Symbol bei einer Pro-beschränkten Funktion. Der Kauf erfolgt über den App Store und kann auf jedem Gerät mit derselben Apple-ID wiederhergestellt werden.

Für detaillierte Fehlerbehebungsschritte besuche unsere dedizierte Fehlerbehebungsseite:

MACA bietet eine lokale REST-API, mit der du alle audioerzeugenden Apps programmatisch steuern kannst. Perfekt für Automatisierungs-Workflows, Stream Deck-Integrationen, Smart-Home-Setups und eigene Skripte.

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