Handbuch

1Erste Schritte

MACA ist eine Menüleisten-App. Nach der Installation erscheint ein kleines Symbol in der macOS-Menüleiste (oben rechts). Ein Klick öffnet das Hauptfenster.

Erster Start

Beim ersten Start führt dich ein Assistent durch das Wichtigste:

• Willkommen — Überblick über die Berechtigungen, die MACA braucht.
• Audio-Berechtigung — MACA nutzt Core Audio Taps für die Audiosteuerung pro App. Eine Schaltfläche öffnet die Systemeinstellungen, damit du den Zugriff erteilen kannst.
• Mitteilungen — optional. Aktiviert Hinweise, wenn Audioprobleme erkannt oder automatisch repariert werden.
• Fertig — Zusammenfassung deiner Auswahl. Du kannst jeden Schritt zurückgehen und ändern.

Bei Anmeldung starten

Damit MACA automatisch bei der Anmeldung startet, aktiviere „Bei Anmeldung starten“ unter Einstellungen › Allgemein.

2Menüleisten-Symbol

MACA lebt in der Menüleiste. Unter Einstellungen › Allgemein wählst du zwischen vier Icon-Stilen:

Details zur Pegelanzeige

Die Pegelanzeige aktualisiert sich 10-mal pro Sekunde und zeigt den kombinierten Pegel aller von MACA gesteuerten Apps.

• Clipping-Erkennung — übersteigt der Pegel auf einem Kanal 98 %, blinkt der Balken 200 Millisekunden lang voll rot.
• Energie-Optimierung — die Anzeige pausiert automatisch, wenn das Display schläft, und startet beim Aufwachen sauber neu.

Weitere Icon-Verhalten

• Animation — wenn aktiv, animiert das Symbol, solange eine App Audio abspielt. Gilt nicht für den Pegelanzeige-Stil.
• Auto-Ausblenden — wenn aktiv, verschwindet das Symbol nach 5 Minuten ohne Audioaktivität und erscheint sofort wieder, sobald eine App Ton abspielt.

3Hauptfenster

Ein Klick auf das Menüleisten-Symbol öffnet das Hauptfenster. Es enthält von oben nach unten folgende Bereiche:

Gesamtlautstärke

Ein Schieberegler oben regelt die System-Gesamtlautstärke (0–100 %). Links und rechts vom Regler:

• Alle stumm — schaltet alle Apps auf einmal stumm. Erneut drücken hebt die Stummschaltung auf.
• Focus Mode — schaltet alle Apps außer Kommunikations-Apps stumm.
• Normalizer — gleicht die Audiopegel über alle Apps automatisch aus. (Pro)

Suchen und Sortieren

• Suchfeld — tippen, um die App-Liste nach Namen zu filtern. Kürzlich genutzte, gerade inaktive Apps erscheinen mit einer „Starten“-Schaltfläche.
• Sortierung — wählbar zwischen Alphabetisch (A–Z) und Letzte Aktivität.

Profil-Auswahl

Ein Aufklappmenü aktiviert, deaktiviert oder verwaltet gespeicherte Audio-Profile.

App-Liste

Zeigt alle Apps, die gerade Audio erzeugen. Jede App hat ihre eigene Zeile mit Lautstärkereglern.

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

Systemprozesse

Ein ausklappbarer Bereich „Systemdienste“ zeigt Audioprozesse auf Systemebene wie Anrufe, Mitteilungen und Bildschirmfreigabe. Standardmäßig ausgeblendet — unter Einstellungen › Allgemein aktivierbar.

Weitere Geräte

Ein ausklappbarer Bereich mit Lautstärkereglern für alle verbundenen Ausgabegeräte außer dem Standardgerät.

Fußzeile

• Standard-Ausgabegerät — ein Aufklappmenü zum Ändern des systemweiten Standard-Audioausgangs. Geräte sind in Lokal, Bluetooth und AirPlay gruppiert.
• Einstellungen (Zahnrad) — öffnet das Einstellungsfenster.
• Beenden (Ein/Aus-Symbol) — zeigt einen Bestätigungsdialog und beendet MACA. Alle Audio-Taps und virtuellen Geräte werden beim Beenden aufgeräumt.

4Lautstärke pro App

Jede App in der Liste zeigt ihre eigenen Bedienelemente:

So funktioniert es

MACA nutzt Apples Core Audio Taps, um den Audiostrom jeder App abzugreifen. Die Lautstärke wird in Echtzeit per digitaler Signalverarbeitung angewendet. Alle Audiokanäle bleiben unverändert — nur die Verstärkung wird angepasst. Lautstärke und Stummschaltung pro App sind für jede App gratis, ohne Limit.

5Audio-Routing pro AppPro

Klick auf das Lautsprecher-/Geräte-Symbol einer App-Zeile öffnet die Ausgabegeräte-Auswahl. So schickst du eine einzelne App an einen anderen Ausgang als den System-Standard — und eine App kann gleichzeitig über bis zu vier Geräte laufen.

Geräteauswahl

• System-Standard verwenden — leitet die App über den Standardausgang. Das ist das Standardverhalten.
• Verfügbare Geräte — listet alle verbundenen Ausgabegeräte: eingebaute Lautsprecher, USB-Audio-Interfaces, HDMI-Ausgänge, Bluetooth-Kopfhörer und mehr.
• Bluetooth-Bereich — zeigt gekoppelte Bluetooth-Audiogeräte separat.

6Equalizer pro AppPro

Klick auf die EQ-Schaltfläche einer App-Zeile öffnet ein eigenes 10-Band-Equalizer-Fenster für diese App.

Bedienelemente des EQ-Fensters

Eigene EQ-ProfilePro

Eigene EQ-Profile legst du unter Einstellungen › Equalizer an. Sie erscheinen oben in der Preset-Auswahl jedes EQ-Fensters und lassen sich 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 konfiguriertem EQ. Von dort öffnest du das EQ-Fenster jeder App, setzt den EQ einer App zurück oder verwaltest deine eigenen Profile.

7Focus Mode

Der Focus Mode schaltet alles außer deinen Kommunikations-Apps stumm — vorkonfiguriert für 160+ Apps wie Teams, Discord, Zoom und FaceTime. Aktivieren:

• Klick auf das Telefon-Symbol im Bereich der Hauptregler.
• Über das Tastenkürzel (Standard: Wahl + Befehl + F).

Ist er aktiv, wird das Telefon-Symbol grün. Erneut drücken oder das Kürzel nutzen deaktiviert ihn.

8Audio-NormalizerPro

Der Normalizer gleicht die Audiopegel über alle Apps automatisch aus, damit keine App deutlich lauter oder leiser ist als die anderen.

Aktiviere ihn über den Normalizer-Schalter im Bereich der Hauptregler. Regelt er gerade um mehr als 0,5 dB nach, erscheint ein kleiner Gain-Indikator neben dem Schalter:

• Orange gefärbt beim Anheben (positive dB).
• Cyan gefärbt beim Absenken (negative dB).

9Profile

Profile speichern eine Momentaufnahme deiner Audio-Konfiguration — Lautstärke pro App, Stumm-Status, Ausgabegerät-Zuordnung und EQ-Einstellungen — damit du per Klick zwischen Setups wechselst. Gratis ist 1 Profil enthalten; Pro schaltet unbegrenzte Profile frei.

Profil erstellen

• Öffne Einstellungen › Profile.
• Klick auf die „+“-Schaltfläche.
• Namen eingeben und ein Icon aus dem Raster wählen (10 Icons verfügbar).
• Optional „Aktuellen Zustand erfassen“ aktivieren, um die aktuellen Einstellungen aller laufenden Apps ins neue Profil zu speichern.

Profil aktivieren

• Über das Profil-Aufklappmenü im Hauptfenster.
• Unter Einstellungen › Profile per Überfahren und Klick auf das Häkchen oder per Doppelklick.
• Über die Kurzbefehle-App: Aktion „Profil laden“.

Auto-Speichern

Jedes Profil hat einen Auto-Speichern-Schalter. Ist er aktiv, werden Lautstärke-, Stumm-, Geräte- oder EQ-Änderungen bei aktivem Profil automatisch ins Profil zurückgeschrieben.

Profil bearbeiten

Wähle unter Einstellungen › Profile ein Profil und klick auf Bearbeiten. Die Detailansicht zeigt:

• Icon-Auswahl (Aufklappmenü mit SF Symbols).
• Namensfeld.
• Eine Liste aller Apps im Profil, je mit: Icon, Name, Stumm-Schalter, Lautstärkeregler, Ausgabegerät-Auswahl, EQ-Preset-Auswahl und Entfernen-Knopf.
• Eine „App hinzufügen“-Schaltfläche, um weitere Apps aus der laufenden Liste oder dem Verlauf aufzunehmen.

10Weitere Geräte

Der Bereich „Weitere Geräte“ unten im Hauptfenster zeigt Lautstärkeregler für alle verbundenen Ausgabegeräte außer dem aktuellen Standardgerät. Jede Gerätezeile enthält:

• Geräte-Icon (nach Anschlussart: eingebaut, USB, Bluetooth, HDMI usw.).
• Gerätename.
• Lautstärkeregler.
• Stumm-Knopf.
• Info-Knopf (öffnet ein Popover mit Gerätedetails).

11Tastenkürzel

MACA unterstützt globale Tastenkürzel, die aus jeder App funktionieren. Richte sie unter Einstellungen › Kürzel ein.

Standard-Kürzel

Kürzel anpassen

Klick auf das Aufnahmefeld neben einem Kürzel, um eine neue Tastenkombination zuzuweisen. Drück deine gewünschte Kombination und klick woanders hin zum Bestätigen. „Auf Standard zurücksetzen“ stellt alle Kürzel auf die Originale zurück.

12Siri & Kurzbefehle

Öffne die Kurzbefehle-App, erstelle einen neuen Kurzbefehl und suche nach „MACA“, um diese Aktionen zu finden — für Automationen und Siri:

13Einstellungen

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

Allgemein

App-Sichtbarkeit

Steuert, welche Apps im Hauptfenster erscheinen.

• Sichtbarkeit einzelner Apps umschalten (Augen-Symbol).
• Suche nach App-Name oder Bundle-Identifier.
• Filter, um nur ausgeblendete Apps zu zeigen.
• „Alle Apps anzeigen“ setzt alle Apps wieder auf sichtbar.
• „Verlauf löschen“ entfernt die Aufzeichnung zuvor gesehener Apps.

Geräte-Sichtbarkeit

Steuert, welche Ausgabegeräte im Bereich „Weitere Geräte“ erscheinen.

• Sichtbarkeit einzelner Geräte umschalten (Augen-Symbol).
• Suche nach Gerätename.
• Jedes Gerät zeigt seine Anschlussart und eindeutige Kennung.
• „Alle Geräte anzeigen“ setzt alle wieder auf sichtbar.
• „Verlauf löschen“ entfernt die Aufzeichnung zuvor gesehener Geräte.

System

Über

• MACA-Version und Build-Nummer.
• Pro- oder Free-Abzeichen.
• Für Pro-Nutzer: eine Dankesnachricht. Für Free-Nutzer: eine „Auf Pro upgraden“-Schaltfläche.
• Links zur MACA-Website, Support-E-Mail, App-Store-Seite und Versionshistorie.

14Audio-Health-Monitor

MACA führt alle 30 Sekunden im Hintergrund automatisch eine Gesundheitsprüfung durch. Sie sucht nach:

• Verwaisten Aggregat-Geräten — Überbleibsel früherer Abstürze oder unsauberer Beendigungen.
• Verwaisten Audio-Taps — die keiner laufenden App mehr zugeordnet sind.
• Konkurrierenden Apps — die MACA stören könnten.

Wird ein Problem gefunden, versucht MACA es automatisch zu reparieren. Was behoben wurde, siehst du unter Einstellungen › System › Reparatur-Verlauf.

Aufräumen beim Beenden

Wenn du MACA beendest (oder der Prozess per SIGTERM, SIGINT oder SIGQUIT beendet wird), werden alle Audio-Taps und Aggregat-Geräte entfernt, damit dein System sauber bleibt.

15Gratis vs. Pro

Lautstärke und Stummschaltung pro App sind für alle deine Apps gratis, ohne Limit und ohne Konto. Pro ergänzt die Studio-Werkzeuge:

Zum Upgraden klick auf „Auf Pro upgraden“ unter Einstellungen › Über oder auf das Schloss-Symbol einer Pro-Funktion. Pro gibt es als Monats- oder Jahres-Abo oder als einmaligen Lifetime-Kauf — siehe den Preise-Abschnitt auf der Startseite. Der Kauf läuft über den App Store und lässt sich auf jedem Gerät mit derselben Apple-ID wiederherstellen.

16Problembehebung

Die häufigsten Themen und ihre schnelle Lösung:

Keine Apps in der Liste

Stell sicher, dass MACA die Audio-Berechtigung hat (Core Audio Taps). Öffne den Assistenten erneut über Einstellungen › Allgemein › „Willkommensbildschirm erneut zeigen“ und erteile den Zugriff. Es erscheinen nur Apps, die gerade Audio erzeugen — nutze das Suchfeld, um eine kürzlich genutzte App zu starten.

Pegelanzeige ohne Aktivität

Die Anzeige pausiert, während das Display schläft. Spielt eine App, zeigt aber keinen Pegel, prüfe, ob sie nicht stumm ist und ob MACA sie steuert.

Verzerrter Klang

Setz den EQ der App im EQ-Fenster auf neutral (0 dB) zurück und schalte den Normalizer-Boost aus, falls die Pegel ohnehin hoch sind.

App verschwunden oder Ton spinnt nach einem Absturz

MACAs Health-Monitor repariert verwaiste Taps und Aggregat-Geräte alle 30 Sekunden; du kannst zusätzlich unter Einstellungen › System › Gesundheitscheck ausführen manuell prüfen. Beim Beenden räumt MACA alle Taps und virtuellen Geräte auf.

MACA fehlt in der Menüleiste

Auto-Ausblenden versteckt das Symbol nach 5 Minuten Stille; es kehrt zurück, sobald Ton startet. Du kannst Auto-Ausblenden unter Einstellungen › Allgemein deaktivieren.

Konkurrierende Audio-Software

Einstellungen › System listet Apps, die mit MACAs Audioverarbeitung in Konflikt geraten können — so erkennst und schließt du sie.

Kommst du nicht weiter? Schreib uns an support@getmaca.de oder in die Discord-Community.

17Lokale Control-APIPro

MACA bietet eine lokale REST-API, um jede Audio-App programmatisch zu steuern — perfekt für Automationen, Stream-Deck-Integrationen, Smart Home und eigene Skripte. Die API läuft lokal auf deinem Mac auf Port 59622, ist standardmäßig nur von diesem Mac aus erreichbar und sendet nie Daten an externe Server.

Optional: Steuerung von anderen Geräten im Netzwerk

Ein optionaler LAN-Modus erlaubt anderen Geräten im selben Heimnetz den Zugriff auf die API — praktisch für ein Stream Deck auf einem anderen Rechner oder einen Smart-Home-Hub. Aktiviere ihn nur in Netzwerken, denen du vertraust: Die Verbindung läuft als reines HTTP ohne TLS, also wie jeder andere unverschlüsselte Heimnetz-Dienst behandeln.

Prüfen, ob MACA läuft

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

Lese-Endpunkte (keine Authentifizierung nötig)

Schreib-Endpunkte (Bearer-Token nötig)Pro

Beispiel: App-Lautstärke ändern

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

Die API ist rein lokal. Alle Aufrufe bleiben auf deinem Rechner — es werden keine Daten an externe Server gesendet.