User Guide

MACA is a menu bar app. After installation, a small icon appears in the macOS menu bar (top-right area of your screen). Click it to open the main popup window.

First Launch

On first launch, a setup wizard guides you through:

1. Welcome — Overview of permissions MACA needs.
2. Audio Permission — MACA uses Core Audio Taps to control per-app audio. A button opens System Settings so you can grant access if prompted.
3. Notifications — Optional. Enables alerts when audio issues are detected or automatically repaired.
4. Finish — Summary of your choices. You can go back and change any step.

Launch at Login

To start MACA automatically when you log in, enable "Launch at Login" in Settings > General.

MACA lives in the menu bar. You can choose between four icon styles in Settings > General:

Icon Styles

Level Meter Details

The level meter updates 10 times per second and displays the combined audio level of all apps currently controlled by MACA.

• Clipping detection: — When audio peaks above 98% on either channel, that bar flashes fully red for 200 milliseconds.
• Energy optimization: — The meter pauses automatically when the display is asleep and resets cleanly on wake.

Additional Icon Behaviors

• Animation — When enabled, the icon animates while any app is playing audio. Does not apply to the Level Meter style.
• Auto-Hide — When enabled, the menu bar icon hides after 5 minutes of no audio activity. It reappears instantly when any app starts playing audio.

Click the menu bar icon to open the main popup. It contains the following sections from top to bottom:

Master Volume

A horizontal slider at the top controls the system master volume (0–100%). To the left and right of the slider:

• Mute All — Mutes every app at once. Press again to unmute.
• Focus Mode — Mutes all apps except communication apps (see Section 7).
• Normalizer — Automatically balances audio levels across apps.Pro

Search and Sort

• Search field — Type to filter the app list by name. Recently used apps that are not currently active also appear with a "Launch" button.
• Sort order — Choose between Alphabetical (A-Z) and Recent Activity.

Profile Picker

A dropdown menu lets you activate, deactivate, or manage saved audio profiles (see Section 9).

App List

Shows all apps currently producing audio. Each app has its own row with volume controls.

• A green dot indicates the app is currently playing audio.
• A red speaker-slash badge indicates the app is muted.

System Processes

A collapsible section labeled "System Services" shows system-level audio processes such as phone calls, notifications, and screen sharing. Hidden by default — enable in Settings > General.

Secondary Devices

A collapsible section showing volume controls for all connected output devices other than the default device (see Section 10).

Footer

• Default Output Device — A dropdown to change the system-wide default audio output. Devices are grouped into Local, Bluetooth, and AirPlay sections.
• Settings — (gear icon) — Opens the Settings window.
• Quit — (power icon) — Shows a confirmation dialog, then quits MACA. All audio taps and virtual devices are cleaned up on exit.

Each app in the list shows:

How It Works

MACA uses Apple Core Audio Taps to intercept each app's audio stream. Volume is applied in real time using digital signal processing. All audio channels pass through unmodified — only the gain is adjusted.

Click the speaker/device icon on any app row to open the output device picker. This lets you send an individual app's audio to a different output device than the system default.

Device Picker

• Use System Default — Routes this app through the default output. This is the default behavior.
• Available Devices — Lists all connected output devices: built-in speakers, USB audio interfaces, HDMI outputs, Bluetooth headphones, and more.
• Bluetooth Section — Shows paired Bluetooth audio devices separately.

Click the EQ button on any app row to open a separate EQ window for that app.

EQ Window Controls

Custom EQ ProfilesPro

Create custom EQ profiles in Settings > Equalizer. Custom profiles appear at the top of the preset picker in every EQ window. You can rename, edit, and delete custom profiles from Settings.

EQ in Settings

Settings > Equalizer shows an overview of all custom EQ profiles and all apps with configured EQ settings. From there you can open any app's EQ window, reset an app's EQ, or manage your custom profiles.

Focus Mode mutes all audio except communication apps. Activate it by:

• Clicking the phone icon in the master controls area of the main popup.
• Using the keyboard shortcut (default: Option + Command + F).

When active, the phone icon turns green. Press again or use the shortcut to deactivate.

The Normalizer automatically balances audio levels across all apps so no single app is significantly louder or quieter than others.Pro

Activate it by clicking the normalizer toggle in the master controls area. When the normalizer is actively adjusting levels by more than 0.5 dB, a small gain indicator appears next to the toggle:

• Colored orange when boosting (positive dB)
• Colored cyan when cutting (negative dB)

Profiles save a snapshot of your audio configuration — per-app volume, mute state, output device assignment, and EQ settings — so you can switch between setups with one click.

Creating a Profile

1. Open Settings > Profiles.
2. Click the "+" button.
3. Enter a name and choose an icon from the grid (10 icons available).
4. Optionally enable "Capture current state" to save all running apps' current settings into the new profile.

Activating a Profile

• From the profile picker dropdown in the main popup.
• From Settings > Profiles by hovering over a profile and clicking the checkmark, or double-clicking.
• Via the Shortcuts app: "Load Profile" action.

Auto-Save

Each profile has an Auto-Save toggle. When enabled, any volume, mute, device, or EQ changes you make while the profile is active are automatically saved back to the profile.

Editing a Profile

In Settings > Profiles, select a profile and click the edit button. The detail view shows:

• Icon picker (dropdown menu with SF Symbols).
• Name field.
• List of all apps in the profile, each with: icon, name, mute toggle, volume slider, output device picker, EQ preset picker, and remove button.
• "Add App" button to include additional apps from running or history.

The Secondary Devices section at the bottom of the main popup shows volume controls for all connected output devices other than the current default device.

Each device row includes:

• Device icon (based on transport type: built-in, USB, Bluetooth, HDMI, etc.).
• Device name.
• Volume slider.
• Mute button.
• Info button (opens a popover with device details).

MACA supports global keyboard shortcuts that work from any app. Configure them in Settings > Shortcuts.

Default Shortcuts

Customizing Shortcuts

Click the recorder field next to any shortcut to assign a new key combination. Press your desired shortcut, then click elsewhere to confirm. Use the "Reset to Defaults" button to restore all shortcuts to their original values.

Open the Shortcuts app, create a new shortcut, and search for "MACA" to find these actions:

Open Settings from the gear icon in the main popup footer, or by right-clicking the menu bar icon.

General

App Visibility

Control which apps appear in the main popup.

• Toggle visibility for individual apps (eye icon).
• Search by app name or bundle identifier.
• Filter to show hidden apps only.
• "Show All Apps" resets all apps to visible.
• "Clear History" removes the record of previously seen apps.

Device Visibility

Control which output devices appear in the Secondary Devices section.

• Toggle visibility for individual devices (eye icon).
• Search by device name.
• Each device shows its transport type and unique identifier.
• "Show All Devices" resets all to visible.
• "Clear History" removes the record of previously seen devices.

System

About

• MACA version and build number.
• Pro or Free tier badge.
• For Pro users: a thank-you message. For Free users: an "Upgrade to Pro" button.
• Links to the MACA website, support email, App Store page, and version history.

MACA runs an automatic health check every 30 seconds in the background. It looks for:

• Orphaned aggregate devices — from previous crashes or abnormal terminations.
• Orphaned audio taps — that are no longer connected to a running app.
• Competing apps — that may interfere with MACA.

When an issue is found, MACA attempts to repair it automatically. You can review repairs in Settings > System > Repair History.

Cleanup on Quit

When you quit MACA (or if the process is terminated by SIGTERM, SIGINT, or SIGQUIT), all audio taps and aggregate devices are destroyed to leave your system in a clean state.

To upgrade, click the "Upgrade to Pro" button in Settings > About, or click the lock icon on any Pro-restricted feature. The purchase is handled through the App Store and can be restored on any device signed in with the same Apple ID.

For detailed troubleshooting steps, visit our dedicated troubleshooting page:

MACA provides a local REST API that lets you control all audio-producing apps programmatically. This is perfect for automation workflows, Stream Deck integrations, smart home setups, and custom 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}'