Guide utilisateur

MACA est une app de barre des menus. Après l'installation, une petite icône apparaît dans la barre des menus de macOS (coin supérieur droit de votre écran). Cliquez dessus pour ouvrir la fenêtre principale.

Premier lancement

Au premier lancement, un assistant de configuration vous guide à travers :

1. Bienvenue — Aperçu des autorisations dont MACA a besoin.
2. Autorisation audio — MACA utilise les Core Audio Taps pour contrôler l'audio par app. Un bouton ouvre les Réglages Système pour que vous puissiez accorder l'acc��s si demandé.
3. Notifications — Optionnel. Active les alertes lorsque des problèmes audio sont détectés ou réparés automatiquement.
4. Terminer — Résumé de vos choix. Vous pouvez revenir en arrière et modifier n'importe quelle étape.

Lancer à la connexion

Pour démarrer MACA automatiquement lors de votre connexion, activez « Lancer à la connexion » dans Réglages > Général.

MACA se trouve dans la barre des menus. Vous pouvez choisir entre quatre styles d'icône dans Réglages > Général :

Styles d'icône

Détails du VU-mètre

Le VU-mètre se met à jour 10 fois par seconde et affiche le niveau audio combiné de toutes les apps contrôlées par MACA.

• Détection de saturation : — Lorsque l'audio dépasse 98 % sur l'un ou l'autre canal, cette barre clignote entièrement en rouge pendant 200 millisecondes.
• Optimisation énergétique : — Le VU-mètre se met en pause automatiquement lorsque l'écran est en veille et se réinitialise proprement au réveil.

Comportements supplémentaires de l'icône

• Animation — Lorsqu'elle est activée, l'icône s'anime tant qu'une app lit de l'audio. Ne s'applique pas au style VU-mètre.
• Masquage automatique — Lorsqu'il est activé, l'icône de la barre des menus se masque après 5 minutes sans activité audio. Elle réapparaît instantanément lorsqu'une app commence à lire de l'audio.

Cliquez sur l'icône de la barre des menus pour ouvrir la fenêtre principale. Elle contient les sections suivantes de haut en bas :

Volume principal

Un curseur horizontal en haut contrôle le volume principal du système (0–100 %). À gauche et à droite du curseur :

• Tout couper — Coupe le son de toutes les apps à la fois. Appuyez à nouveau pour rétablir.
• Mode concentration — Coupe le son de toutes les apps sauf les apps de communication (voir Section 7).
• Normaliseur — Équilibre automatiquement les niveaux audio entre les apps.Pro

Recherche et tri

• Champ de recherche — Tapez pour filtrer la liste des apps par nom. Les apps récemment utilisées mais inactives apparaissent également avec un bouton « Lancer ».
• Ordre de tri — Choisissez entre Alphabétique (A-Z) et Activité récente.

Sélecteur de profil

Un menu déroulant vous permet d'activer, désactiver ou gérer les profils audio enregistrés (voir Section 9).

Liste des apps

Affiche toutes les apps produisant actuellement de l'audio. Chaque app a sa propre ligne avec des contrôles de volume.

• Un point vert indique que l'app lit actuellement de l'audio.
• Un badge de haut-parleur barré en rouge indique que l'app est coupée.

Processus système

Une section dépliable intitulée « Services système » affiche les processus audio système tels que les appels téléphoniques, les notifications et le partage d'écran. Masquée par défaut — activez-la dans Réglages > Général.

Appareils secondaires

Une section dépliable montrant les contrôles de volume pour tous les appareils de sortie connectés autres que l'appareil par défaut (voir Section 10).

Pied de page

• Appareil de sortie par défaut — Un menu déroulant pour changer la sortie audio par défaut du système. Les appareils sont groupés en Local, Bluetooth et AirPlay.
• Réglages — (icône d'engrenage) — Ouvre la fenêtre des Réglages.
• Quitter — (icône d'alimentation) — Affiche une boîte de dialogue de confirmation, puis quitte MACA. Tous les taps audio et appareils virtuels sont nettoyés à la sortie.

Chaque app dans la liste affiche :

Comment ça marche

MACA utilise les Apple Core Audio Taps pour intercepter le flux audio de chaque app. Le volume est appliqué en temps réel par traitement numérique du signal. Tous les canaux audio passent sans modification — seul le gain est ajusté.

Cliquez sur l'icône haut-parleur/appareil sur n'importe quelle ligne d'app pour ouvrir le sélecteur d'appareil de sortie. Cela vous permet d'envoyer l'audio d'une app individuelle vers un appareil de sortie différent de celui par défaut du système.

Sélecteur d'appareil

• Utiliser le défaut système — Dirige cette app via la sortie par défaut. C'est le comportement par défaut.
• Appareils disponibles — Liste tous les appareils de sortie connectés : haut-parleurs intégrés, interfaces audio USB, sorties HDMI, écouteurs Bluetooth et plus.
• Section Bluetooth — Affiche les appareils audio Bluetooth appariés séparément.

Cliquez sur le bouton EQ sur n'importe quelle ligne d'app pour ouvrir une fenêtre d'EQ séparée pour cette app.

Contrôles de la fenêtre EQ

Profils EQ personnalisésPro

Créez des profils EQ personnalisés dans Réglages > Égaliseur. Les profils personnalisés apparaissent en haut du sélecteur de préréglages dans chaque fenêtre EQ. Vous pouvez renommer, modifier et supprimer les profils personnalisés depuis les Réglages.

EQ dans les Réglages

Réglages > Égaliseur affiche un aperçu de tous les profils EQ personnalisés et de toutes les apps avec des réglages EQ configurés. De là, vous pouvez ouvrir la fenêtre EQ de n'importe quelle app, réinitialiser l'EQ d'une app ou gérer vos profils personnalisés.

Le Mode concentration coupe le son de tout l'audio sauf les apps de communication. Activez-le en :

• Cliquant sur l'icône de téléphone dans la zone des contrôles principaux de la fenêtre principale.
• Utilisant le raccourci clavier (par défaut : Option + Command + F).

Lorsqu'il est actif, l'icône du téléphone devient verte. Appuyez à nouveau ou utilisez le raccourci pour désactiver.

Le Normaliseur équilibre automatiquement les niveaux audio de toutes les apps pour qu'aucune app ne soit significativement plus forte ou plus faible que les autres.Pro

Activez-le en cliquant sur le bouton du normaliseur dans la zone des contrôles principaux. Lorsque le normaliseur ajuste activement les niveaux de plus de 0,5 dB, un petit indicateur de gain apparaît à côté du bouton :

• Coloré en orange lors de l'amplification (dB positifs)
• Coloré en cyan lors de l'atténuation (dB négatifs)

Les profils enregistrent un instantané de votre configuration audio — volume par app, état de coupure, assignation d'appareil de sortie et réglages EQ — pour que vous puissiez basculer entre les configurations en un clic.

Créer un profil

1. Ouvrez Réglages > Profils.
2. Cliquez sur le bouton « + ».
3. Entrez un nom et choisissez une icône dans la grille (10 icônes disponibles).
4. Activez optionnellement « Capturer l'état actuel » pour enregistrer les réglages actuels de toutes les apps en cours dans le nouveau profil.

Activer un profil

• Depuis le menu déroulant du sélecteur de profils dans la fenêtre principale.
• Depuis Réglages > Profils en survolant un profil et en cliquant sur la coche, ou en double-cliquant.
• Via l'app Raccourcis : action « Charger le profil ».

Sauvegarde automatique

Chaque profil a un interrupteur de sauvegarde automatique. Lorsqu'il est activé, toute modification de volume, coupure, appareil ou EQ que vous effectuez pendant que le profil est actif est automatiquement sauvegardée dans le profil.

Modifier un profil

Dans Réglages > Profils, sélectionnez un profil et cliquez sur le bouton de modification. La vue détaillée affiche :

• Sélecteur d'icône (menu déroulant avec SF Symbols).
• Champ de nom.
• Liste de toutes les apps dans le profil, chacune avec : icône, nom, bouton de coupure, curseur de volume, sélecteur d'appareil de sortie, sélecteur de préréglage EQ et bouton de suppression.
• Bouton « Ajouter une app » pour inclure des apps supplémentaires en cours ou de l'historique.

La section Appareils secondaires en bas de la fenêtre principale affiche les contrôles de volume pour tous les appareils de sortie connectés autres que l'appareil par défaut actuel.

Chaque ligne d'appareil comprend :

• Icône de l'appareil (basée sur le type de transport : intégré, USB, Bluetooth, HDMI, etc.).
• Nom de l'appareil.
• Curseur de volume.
• Bouton de coupure du son.
• Bouton d'info (ouvre un popover avec les détails de l'appareil).

MACA prend en charge les raccourcis clavier globaux qui fonctionnent depuis n'importe quelle app. Configurez-les dans Réglages > Raccourcis.

Raccourcis par défaut

Personnaliser les raccourcis

Cliquez sur le champ d'enregistrement à côté de n'importe quel raccourci pour assigner une nouvelle combinaison de touches. Appuyez sur votre raccourci souhaité, puis cliquez ailleurs pour confirmer. Utilisez le bouton « Réinitialiser aux valeurs par défaut » pour restaurer tous les raccourcis à leurs valeurs d'origine.

Ouvrez l'app Raccourcis, créez un nouveau raccourci et recherchez « MACA » pour trouver ces actions :

Ouvrez les Réglages depuis l'icône d'engrenage dans le pied de page de la fenêtre principale, ou en faisant un clic droit sur l'icône de la barre des menus.

Général

Visibilité des apps

Contrôlez quelles apps apparaissent dans la fenêtre principale.

• Basculer la visibilité pour les apps individuelles (icône d'œil).
• Rechercher par nom d'app ou identifiant de bundle.
• Filtrer pour afficher uniquement les apps masquées.
• « Afficher toutes les apps » rétablit toutes les apps comme visibles.
• « Effacer l'historique » supprime l'enregistrement des apps précédemment vues.

Visibilité des appareils

Contrôlez quels appareils de sortie apparaissent dans la section Appareils secondaires.

• Basculer la visibilité pour les appareils individuels (icône d'œil).
• Rechercher par nom d'appareil.
• Chaque appareil affiche son type de transport et son identifiant unique.
• « Afficher tous les appareils » rétablit tous comme visibles.
• « Effacer l'historique » supprime l'enregistrement des appareils précédemment vus.

Système

À propos

• Version et numéro de build de MACA.
• Badge de niveau Pro ou Free.
• Pour les utilisateurs Pro : un message de remerciement. Pour les utilisateurs Free : un bouton « Passer à Pro ».
• Liens vers le site web MACA, l'email de support, la page App Store et l'historique des versions.

MACA exécute un bilan de santé automatique toutes les 30 secondes en arrière-plan. Il recherche :

• Appareils agrégés orphelins — provenant de crashs précédents ou de terminaisons anormales.
• Taps audio orphelins — qui ne sont plus connectés à une app en cours d'exécution.
• Apps concurrentes — qui pourraient interférer avec MACA.

Lorsqu'un problème est trouvé, MACA tente de le réparer automatiquement. Vous pouvez consulter les réparations dans Réglages > Système > Historique des réparations.

Nettoyage à la fermeture

Lorsque vous quittez MACA (ou si le processus est terminé par SIGTERM, SIGINT ou SIGQUIT), tous les taps audio et appareils agrégés sont détruits pour laisser votre système dans un état propre.

Pour passer à Pro, cliquez sur le bouton « Passer à Pro » dans Réglages > À propos, ou cliquez sur l'icône de cadenas sur toute fonctionnalité restreinte à Pro. L'achat est géré via l'App Store et peut être restauré sur tout appareil connecté avec le même Apple ID.

Pour des étapes de dépannage détaillées, visitez notre page dédiée :

MACA fournit une API REST locale qui vous permet de contrôler programmatiquement toutes les apps produisant de l'audio. Parfait pour les flux d'automatisation, les intégrations Stream Deck, les configurations domotiques et les scripts personnalisés.

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