ユーザーガイド

MACAはメニューバーアプリです。インストール後、macOSメニューバー（画面右上）に小さなアイコンが表示されます。クリックしてメインポップアップウィンドウを開きます。

初回起動

初回起動時、セットアップウィザードが以下を案内します：

1. ようこそ — MACAが必要とする権限の概要。
2. オーディオ権限 — MACA��Core Audio Tapsを使用してアプリごとのオーディオを制御します。ボタンからシステム設定を開いてアクセスを許可できます。
3. 通知 — オプション。オーディオの問題が検出または自動修復された際のアラートを有効にします。
4. 完了 — 選択内容の要約。前に戻って変更することもできます。

ログイン時に起動

ログイン時にMACAを自動的に起動するには、設定 > 一般で「ログイン時に起動」を有効にしてください。

MACAはメニューバーに常駐します。設定 > 一般で4つのアイコンスタイルから選択できます：

アイコンスタイル

レベルメーターの詳細

レベルメーターは毎秒10回更新され、MACAが制御するすべてのアプリの合計オーディオレベルを表示します。

• クリッピング検出： — いずれかのチャンネルでオーディオが98%を超えると、そのバーが200ミリ秒間完全に赤く点滅します。
• 省エネ最適化： — ディスプレイがスリープ中はメーターが自動的に一時停止し、復帰時にクリーンにリセットされます。

その他のアイコン動作

• アニメーション — 有効にすると、アプリがオーディオを再生している間アイコンがアニメーションします。レベルメータースタイルには適用されません。
• 自動非表示 — 有効にすると、5分間オーディオアクティビティがない場合にメニューバーアイコンが非表示になります。アプリがオーディオ再生を開始すると即座に再表示されます。

メニューバーアイコンをクリックしてメインポップアップを開きます。上から下に以下のセクションが含まれています：

マスターボリューム

上部の水平スライダーでシステムマスターボリューム（0〜100%）を制御します。スライダーの左右に：

• すべてミュート — すべてのアプリを一度にミュートします。もう一度押すとミュート解除。
• フォーカスモード — コミュニケーションアプリを除くすべてのアプリをミュートします（セクション7参照）。
• ノーマライザー — アプリ間のオーディオレベルを自動的に均一化します。Pro

検索とソート

• 検索フィールド — 名前でアプリリストをフィルタリングします。現在アクティブでない最近使用したアプリも「起動」ボタン付きで表示されます。
• ソート順 — アルファベット順（A-Z）と最新のアクティビティから選択できます。

プロファイルピッカー

ドロップダウンメニューで保存されたオーディオプロファイルの有効化、無効化、管理ができます（セクション9参照）。

アプリリスト

現在オーディオを出力しているすべてのアプリを表示します。各アプリにはボリュームコントロール付きの行があります。

• 緑の点はアプリが現在オーディオを再生していることを示します。
• 赤いスピーカー取り消しバッジはアプリがミュートされていることを示します。

システムプロセス

「システムサービス」というラベルの折りたたみ可能なセクションで、電話、通知、画面共有などのシステムレベルのオーディオプロセスを表示します。デフォルトでは非表示 — 設定 > 一般で有効にできます。

セカンダリデバイス

デフォルトデバイス以外のすべての接続された出力デバイスのボリュームコントロールを表示する折りたたみ可能なセクション（セクション10参照）。

フッター

• デフォルト出力デバイス — システム全体のデフォルトオーディオ出力を変更するドロップダウン。デバイスはローカル、Bluetooth、AirPlayに分類されます。
• 設定 — （歯車アイコン）— 設定ウィンドウを開きます。
• 終了 — （電源アイコン）— 確認ダイアログを表示し、MACAを終了します。すべてのオーディオタップと仮想デバイスは終了時にクリーンアップされます。

リストの各アプリには以下が表示されます：

仕組み

MACAはApple Core Audio Tapsを使用して各アプリのオーディオストリームをインターセプトします。ボリュームはデジタル信号処理を使用してリアルタイムで適用されます。すべてのオーディオチャンネルは変更されずに通過します — ゲインのみが調整されます。

アプリ行のスピーカー/デバイスアイコンをクリックして出力デバイスピッカーを開きます。これにより、個々のアプリのオーディオをシステムデフォルトとは異なる出力デバイスに送信できます。

デバイスピッカー

• システムデフォルトを使用 — このアプリをデフォルト出力経由でルーティングします。これがデフォルトの動作です。
• 利用可能なデバイス — 接続されているすべての出力デバイスをリスト表示：内蔵スピーカー、USBオーディオインターフェース、HDMI出力、Bluetoothヘッドフォンなど。
• Bluetoothセクション — ペアリングされたBluetoothオーディオデバイスを個別に表示します。

アプリ行のEQボタンをクリックして、そのアプリ用の個別EQウィンドウを開きます。

EQウィンドウのコントロール

カスタムEQプロファイルPro

設定 > イコライザーでカスタムEQプロファイルを作成します。カスタムプロファイルはすべてのEQウィンドウのプリセットピッカーの上部に表示されます。設定からリネーム、編集、削除できます。

設定のEQ

設定 > イコライザーでは、すべてのカスタムEQプロファイルとEQ設定が構成されたすべてのアプリの概要が表示されます。そこからアプリのEQウィンドウを開いたり、EQをリセットしたり、カスタムプロファイルを管理できます。

フォーカスモードはコミュニケーションアプリを除くすべてのオーディオをミュートします。以下で有効にできます：

• メインポップアップのマスターコントロールエリアの電話アイコンをクリック。
• キーボードショートカットを使用（デフォルト：Option + Command + F）。

アクティブな場合、電話アイコンが緑色になります。もう一度押すかショートカットを使用して無効にします。

ノーマライザーはすべてのアプリのオーディオレベルを自動的に均一化し、特定のアプリが他のアプリより大幅に大きくまたは小さくならないようにします。Pro

マスターコントロールエリアのノーマライザートグルをクリックして有効にします。ノーマライザーが0.5 dB以上のレベル調整を行っている場合、トグルの横に小さなゲインインジケーターが表示されます：

• ブースト時（正のdB）はオレンジ色
• カット時（負のdB）はシアン色

プロファイルはオーディオ設定のスナップショットを保存します — アプリごとの音量、ミュート状態、出力デバイスの割り当て、EQ設定 — ワンクリックでセットアップを切り替えられます。

プロファイルの作成

1. 設定 > プロファイルを開きます。
2. 「+」ボタンをクリックします。
3. 名前を入力し、グリッドからアイコンを選択します（10個のアイコンが利用可能）。
4. オプションで「現在の状態をキャプチャ」を有効にして、実行中のすべてのアプリの現在の設定を新しいプロファイルに保存します。

プロファイルの有効化

• メインポップアップのプロファイルピッカードロップダウンから。
• 設定 > プロファイルでプロファイルにホバーしてチェックマークをクリック、またはダブルクリック。
• ショートカットアプリ経由：「プロファイルを読み込む」アクション。

自動保存

各プロファイルには自動保存トグルがあります。有効にすると、プロファイルがアクティブな間に行った音量、ミュート、デバイス、またはEQの変更が自動的にプロファイルに保存されます。

プロファイルの編集

設定 > プロファイルでプロファイルを選択し、編集ボタンをクリックします。詳細ビューには以下が表示されます：

• アイコンピッカー（SF Symbolsを含むドロップダウンメニュー）。
• 名前フィールド。
• プロファイル内のすべてのアプリのリスト（各アプリに：アイコン、名前、ミュートトグル、ボリュームスライダー、出力デバイスピッカー、EQプリセットピッカー、削除ボタン）。
• 「アプリを追加」ボタンで実行中または履歴から追加のアプリを含めます。

メインポップアップの下部にあるセカンダリデバイスセクションでは、現在のデフォルトデバイス以外のすべての接続された出力デバイスのボリュームコントロールを表示します。

各デバイ��行には以下が含まれます：

• デバイスアイコン（トランスポートタイプに基づく：内蔵、USB、Bluetooth、HDMIなど）。
• デバイス名。
• ボリュームスライダー。
• ミュートボタン。
• 情報ボタン（デバイスの詳細を含むポップオーバーを開きます）。

MACAはどのアプリからでも動作するグローバルキーボードショートカットをサポートしています。設定 > ショートカットで設定します。

デフォルトショートカット

ショートカットのカスタマイズ

ショートカットの横にある記録フィールドをクリックして新しいキーの組み合わせを割り当てます。希望のショートカットを押してから、別の場所をクリックして確認します。「デフォルトにリセット」ボタンですべてのショートカットを元の値に復元します。

ショートカットアプリを開き、新しいショートカットを作成して「MACA」を検索すると、以下のアクションが見つかります：

メインポップアップのフッターにある歯車アイコン、またはメニューバーアイコンを右クリックして設定を開きます。

一般

アプリの表示設定

メインポップアップに表示されるアプリを制御します。

• 個々のアプリの表示/非表示を切り替え（目のアイコン）。
• アプリ名またはバンドル識別子で検索。
• 非表示のアプリのみを表示するフィルター。
• 「すべてのアプリを表示」ですべてのアプリを表示に戻します。
• 「履歴をクリア」で以前表示されたアプリの記録を削除します。

デバイスの表示設定

セカンダリデバイスセクションに表示される出力デバイスを制御します。

• 個々のデバイスの表示/非表示を切り替え（目のアイコン）。
• デバイス名で検索。
• 各デバイスはトランスポートタイプと一意の識別子を表示します。
• 「すべてのデバイスを表示」ですべてを表示に戻します。
• 「履歴をクリア」で以前表示されたデバイスの記録を削除します。

システム

情報

• MACAのバージョンとビルド番号。
• ProまたはFreeのバッジ。
• Proユーザー向け：感謝のメッセージ。Freeユーザー向け：「Proにアップグレード」ボタン。
• MACA Webサイト、サポートメール、App Storeページ、バージョン履歴へのリンク。

MACAはバックグラウンドで30秒ごとに自動ヘルスチェックを実行します。以下を検出します：

• 孤立した集約デバイス — 以前のクラッシュまたは異常終了から。
• 孤立したオーディオタップ — 実行中のアプリに接続されていないもの。
• 競合アプリ — MACAに干渉する可能性のあるもの。

問題が見つかると、MACAは自動的に修復を試みます。設定 > システム > 修復履歴で修復内容を確認できます。

終了時のクリーンアップ

MACAを終了する（またはプロセスがSIGTERM、SIGINT、SIGQUITで終了された）場合、すべてのオーディオタップと集約デバイスが破棄され、システムがクリーンな状態に保たれます。

アップグレードするには、設定 > 情報の「Proにアップグレード」ボタンをクリックするか、Pro制限機能のロックアイコンをクリックします。購入はApp Storeを通じて行われ、同じApple IDでサインインした任意のデバイスで復元できます。

詳細なトラブルシューティング手順については、専用のトラブルシューティングページをご覧ください：

MACAはローカルREST APIを提供し、すべてのオーディオアプリをプログラムで制御できます。自動化ワークフロー、Stream Deck統合、スマートホームセットアップ、カスタムスクリプトに最適です。

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