Gebruikershandleiding

MACA is een menubalk-app. Na installatie verschijnt een klein icoon in de macOS-menubalk (rechtsboven op je scherm). Klik erop om het hoofdvenster te openen.

Eerste start

Bij de eerste start begeleidt een installatiewizard je door:

1. Welkom — Overzicht van benodigde machtigingen.
2. Audiomachtiging — MACA gebruikt Core Audio Taps. Een knop opent Systeeminstellingen om toegang te verlenen.
3. Meldingen — Optioneel. Schakelt meldingen in bij audioproblemen.
4. Gereed — Samenvatting van je keuzes. Je kunt teruggaan en wijzigen.

Starten bij inloggen

Om MACA automatisch te starten, schakel "Starten bij inloggen" in via Instellingen > Algemeen.

MACA bevindt zich in de menubalk. Kies uit vier icoonsstijlen in Instellingen > Algemeen:

Icoonsstijlen

Niveaumeter details

De niveaumeter ververst 10 keer per seconde en toont het gecombineerde audioniveau.

• Clipping-detectie: — Bij pieken boven 98% knippert de balk 200ms volledig rood.
• Energiebesparing: — Pauzeert automatisch bij slaapstand en reset bij ontwaken.

Extra icoongedrag

• Animatie — Wanneer ingeschakeld, animeert het icoon tijdens afspelen. Niet voor Niveaumeter.
• Automatisch verbergen — Verbergt na 5 minuten zonder audio. Verschijnt direct bij nieuw geluid.

Klik op het menubalkicoon om het hoofdvenster te openen:

Hoofdvolume

Een horizontale schuifregelaar bovenaan regelt het systeemvolume (0–100%):

• Alles dempen — Dempt alle apps tegelijk.
• Focusmodus — Dempt alles behalve communicatie-apps (zie Sectie 7).
• Normalisator — Balanceert automatisch audioniveaus.Pro

Zoeken en sorteren

• Zoekveld — Filter de applijst op naam.
• Sorteervolgorde — Alfabetisch (A-Z) of Recente activiteit.

Profielkiezer

Een dropdown om opgeslagen audioprofielen te beheren (zie Sectie 9).

Applijst

Toont alle apps die momenteel audio produceren.

• Een groene stip geeft aan dat de app audio afspeelt.
• Een rood doorgestreept luidsprekericoon geeft demping aan.

Systeemprocessen

Een uitklapbare sectie voor systeemaudioprocessen. Standaard verborgen.

Secundaire apparaten

Uitklapbare sectie met volumeregelaars voor alle aangesloten uitvoerapparaten.

Voettekst

• Standaard uitvoerapparaat — Dropdown om het standaard audio-uitvoerapparaat te wijzigen.
• Instellingen — (tandwielpictogram) — Opent Instellingen.
• Afsluiten — (aan/uit-pictogram) — Sluit MACA af met opruiming.

Elke app in de lijst toont:

Hoe het werkt

MACA gebruikt Apple Core Audio Taps om de audiostream van elke app te onderscheppen. Volume wordt realtime toegepast via digitale signaalverwerking.

Klik op het apparaatpictogram om de uitvoerapparaatkiezer te openen.

Apparaatkiezer

• Systeemstandaard — Routeert via het standaardapparaat.
• Beschikbare apparaten — Alle aangesloten uitvoerapparaten.
• Bluetooth-sectie — Toont gekoppelde Bluetooth-apparaten apart.

Klik op de EQ-knop om een apart EQ-venster te openen.

EQ-besturingselementen

Aangepaste EQ-profielenPro

Maak aangepaste profielen in Instellingen > Equalizer.

EQ in Instellingen

Overzicht van alle EQ-profielen en app-configuraties.

Focusmodus dempt alles behalve communicatie-apps:

• Klik op het telefoonicoon.
• Gebruik de sneltoets (standaard: Option + Command + F).

Bij activering wordt het telefoonicoon groen.

De Normalisator balanceert automatisch audioniveaus zodat geen enkele app veel luider of zachter is.Pro

Activeer via de normalisatorknop. Bij aanpassing >0,5 dB verschijnt een indicator:

• Oranje bij versterking (positieve dB)
• Cyaan bij verzwakking (negatieve dB)

Profielen slaan een momentopname op van je audioconfiguratie voor snelle wisseling.

Profiel aanmaken

1. Open Instellingen > Profielen.
2. Klik op "+".
3. Voer een naam in en kies een icoon (10 beschikbaar).
4. Optioneel: "Huidige status vastleggen".

Profiel activeren

• Via de profielkiezer in het hoofdvenster.
• In Instellingen > Profielen: hover en klik vinkje, of dubbelklik.
• Via de Opdrachten-app: "Profiel laden".

Automatisch opslaan

Wijzigingen worden automatisch opgeslagen in het actieve profiel.

Profiel bewerken

In Instellingen > Profielen:

• Icoonkiezer.
• Naamveld.
• Lijst van apps met alle besturingselementen.
• "App toevoegen"-knop.

Volumeregelaars voor alle aangesloten apparaten behalve het standaardapparaat.

Elke apparaatrij bevat:

• Apparaatpictogram.
• Apparaatnaam.
• Volumeschuif.
• Dempknop.
• Infoknop.

MACA ondersteunt globale sneltoetsen. Configureer in Instellingen > Sneltoetsen.

Standaard sneltoetsen

Sneltoetsen aanpassen

Klik op het opnameveld en druk op de gewenste toetscombinatie.

Open de Opdrachten-app en zoek "MACA":

Open via het tandwielpictogram of rechtermuisklik op het menubalkicoon.

Algemeen

App-zichtbaarheid

Beheer welke apps verschijnen.

• Zichtbaarheid schakelen (oogicoon).
• Zoeken op naam of bundle-ID.
• Filter op verborgen.
• "Alles tonen" reset.
• "Geschiedenis wissen" verwijdert records.

Apparaatzichtbaarheid

Beheer welke apparaten verschijnen.

• Zichtbaarheid schakelen.
• Zoeken op naam.
• Transporttype en ID.
• "Alles tonen" reset.
• "Geschiedenis wissen".

Systeem

Over

• Versie en buildnummer.
• Pro of Free badge.
• Pro: bedankje. Free: upgradeknop.
• Links naar website, support, App Store.

Automatische controle elke 30 seconden:

• Verweesde apparaten — van eerdere crashes.
• Verweesde audio-taps — niet meer verbonden.
• Concurrerende apps — mogelijke interferentie.

MACA probeert problemen automatisch te repareren. Bekijk in Instellingen > Systeem.

Opruimen bij afsluiten

Bij het afsluiten worden alle audio-taps en apparaten opgeruimd.

Upgrade via Instellingen > Over of klik op het slotje. Aankoop via de App Store, herstelbaar op elk apparaat.

Bezoek onze probleemoplossingspagina:

MACA biedt een lokale REST API om alle audio-apps programmatisch te bedienen. Perfect voor automatisering, Stream Deck, smart home en eigen scripts.

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