Användarguide

MACA är en menyradapp. Efter installationen visas en liten ikon i macOS menyrad (övre högra hörnet). Klicka för att öppna huvudfönstret.

Första start

Vid första start guidar en installationsguide dig genom:

1. Välkommen — Översikt av behörigheter som MACA behöver.
2. Ljudbehörighet — MACA använder Core Audio Taps. En knapp öppnar Systeminställningar.
3. Notiser — Valfritt. Aktiverar aviseringar vid ljudproblem.
4. Klar — Sammanfattning av dina val.

Starta vid inloggning

Aktivera "Starta vid inloggning" i Inställningar > Allmänt.

Välj mellan fyra ikonstilar i Inställningar > Allmänt:

Ikonstilar

Nivåmätardetaljer

Uppdateras 10 gånger per sekund.

• Klippdetektering: — Blinkar rött vid >98%.
• Energioptimering: — Pausar vid viloläge.

Ytterligare ikonfunktioner

• Animation — Animerar vid ljuduppspelning. Inte för nivåmätaren.
• Autodölj — Döljs efter 5 minuter utan ljud.

Klicka på menyradsikonen för att öppna huvudfönstret:

Huvudvolym

Horisontellt reglage högst upp styr systemvolymen (0–100%):

• Tysta alla — Tystar alla appar samtidigt.
• Fokusläge — Tystar allt utom kommunikationsappar.
• Normaliserare — Balanserar ljudnivåer automatiskt.Pro

Sök och sortera

• Sökfält — Filtrera applistan efter namn.
• Sortering — Alfabetisk eller Senaste aktivitet.

Profilväljare

Rullgardinsmeny för att hantera ljudprofiler.

Applista

Visar alla appar som producerar ljud.

• Grön prick visar att appen spelar ljud.
• Röd genomstruken högtalare visar att appen är tystad.

Systemprocesser

Vikbar sektion för systemljudprocesser. Dold som standard.

Sekundära enheter

Vikbar sektion med volymkontroller för andra enheter.

Sidfot

• Standard ljudutgång — Rullgardinsmeny för att ändra systemets ljudutgång.
• Inställningar — (kugghjulsikon) — Öppnar Inställningar.
• Avsluta — (strömikon) — Avslutar MACA.

Varje app i listan visar:

Hur det fungerar

MACA använder Apple Core Audio Taps för att fånga upp varje apps ljudström. Volymen tillämpas i realtid via digital signalbehandling.

Klicka på enhetsikonen för att öppna enhetsväljaren.

Enhetsväljare

• Systemstandard — Dirigerar via standardutgången.
• Tillgängliga enheter — Alla anslutna utgångsenheter.
• Bluetooth-sektion — Visar parkopplade Bluetooth-enheter separat.

Klicka på EQ-knappen för att öppna ett separat EQ-fönster.

EQ-kontroller

Anpassade EQ-profilerPro

Skapa i Inställningar > Equalizer.

EQ i Inställningar

Översikt av alla EQ-profiler och appkonfigurationer.

Tystar allt utom kommunikationsappar:

• Klicka på telefonikonen.
• Använd kortkommando (standard: Option + Command + F).

Telefonikonen blir grön när aktivt.

Balanserar automatiskt ljudnivåer mellan alla appar.Pro

Aktivera via normaliseringsknappen. Vid justering >0,5 dB visas en indikator:

• Orange vid förstärkning (positiva dB)
• Cyan vid dämpning (negativa dB)

Profiler sparar en ögonblicksbild av din ljudkonfiguration för snabb växling.

Skapa profil

1. Öppna Inställningar > Profiler.
2. Klicka på "+".
3. Ange namn och välj ikon (10 tillgängliga).
4. Valfritt: "Fånga aktuellt tillstånd".

Aktivera profil

• Från profilväljaren i huvudfönstret.
• I Inställningar > Profiler: hovra och klicka bock, eller dubbelklicka.
• Via Genvägar-appen: "Ladda profil".

Autospara

Ändringar sparas automatiskt i den aktiva profilen.

Redigera profil

I Inställningar > Profiler:

• Ikonväljare.
• Namnfält.
• Lista med alla appar och kontroller.
• "Lägg till app"-knapp.

Volymkontroller för alla anslutna enheter utom standardenheten.

Varje enhetsrad inkluderar:

• Enhetsikon.
• Enhetsnamn.
• Volymreglage.
• Tysta-knapp.
• Infoknapp.

MACA stöder globala kortkommandon. Konfigurera i Inställningar > Kortkommandon.

Standardkortkommandon

Anpassa kortkommandon

Klicka på inspelningsfältet och tryck önskad kombination.

Öppna Genvägar-appen och sök efter "MACA":

Öppna via kugghjulsikonen eller högerklick på menyradsikonen.

Allmänt

Appsynlighet

Styr vilka appar som visas.

• Växla synlighet (ögonikon).
• Sök på namn eller bundle-ID.
• Filtrera dolda.
• "Visa alla" återställer.
• "Rensa historik" tar bort poster.

Enhetssynlighet

Styr vilka enheter som visas.

• Växla synlighet.
• Sök på namn.
• Transporttyp och ID.
• "Visa alla" återställer.
• "Rensa historik".

System

Om

• Version och byggnummer.
• Pro eller Free-märke.
• Pro: tack. Free: uppgraderingsknapp.
• Länkar till webb, support, App Store.

Automatisk kontroll var 30:e sekund:

• Föräldralösa aggregerade enheter — från tidigare krascher.
• Föräldralösa ljudtaps — inte längre anslutna.
• Konkurrerande appar — som kan störa MACA.

MACA försöker automatiskt reparera. Se Inställningar > System > Reparationshistorik.

Rensning vid avslut

Vid avslut rensas alla ljudtaps och enheter.

Uppgradera via Inställningar > Om eller klicka på låsikonen. Köp via App Store, återställ på alla enheter.

Besök vår felsökningssida för detaljerade steg:

MACA erbjuder ett lokalt REST API för programmatisk styrning av alla ljudappar. Perfekt för automatisering, Stream Deck, smart hem och egna skript.

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