Kullanım Kılavuzu

MACA bir menü çubuğu uygulamasıdır. Kurulumdan sonra macOS menü çubuğunda küçük bir simge belirir. Ana pencereyi açmak için tıklayın.

İlk Başlatma

İlk başlatmada kurulum sihirbazı size rehberlik eder:

1. Hoş geldiniz — MACA'nın ihtiyaç duyduğu izinlere genel bakış.
2. Ses İzni — MACA, uygulama başına ses kontrolü için Core Audio Taps kullanır.
3. Bildirimler — İsteğe bağlı. Ses sorunları tespit edildiğinde uyarıları etkinleştirir.
4. Bitir — Seçimlerinizin özeti.

Girişte Başlat

MACA'yı otomatik başlatmak için Ayarlar > Genel'de "Girişte Başlat"ı etkinleştirin.

Ayarlar > Genel'de dört simge stili arasından seçim yapabilirsiniz:

Simge Stilleri

Seviye Ölçer Detayları

Saniyede 10 kez güncellenir ve tüm uygulamaların toplam ses seviyesini gösterir.

• Kırpma algılama: — %98 üzerinde kırmızı yanıp söner.
• Enerji optimizasyonu: — Ekran uyku modundayken otomatik duraklar.

Ek Simge Davranışları

• Animasyon — Ses çalarken simge canlanır. Seviye ölçer için geçerli değildir.
• Otomatik Gizle — 5 dakika ses olmazsa gizlenir. Ses başlayınca görünür.

Menü çubuğu simgesine tıklayarak ana pencereyi açın:

Ana Ses

Üstteki yatay kaydırıcı sistem ana sesini kontrol eder (0–100%):

• Tümünü Sessize Al — Tüm uygulamaları sessize alır.
• Odak Modu — İletişim uygulamaları hariç tümünü sessize alır.
• Normalleştirici — Ses seviyelerini otomatik dengeler.Pro

Arama ve Sıralama

• Arama alanı — Uygulama listesini ada göre filtreler.
• Sıralama — Alfabetik veya Son Etkinlik.

Profil Seçici

Kayıtlı ses profillerini yönetmek için açılır menü.

Uygulama Listesi

Şu anda ses üreten tüm uygulamaları gösterir.

• Yeşil nokta ses çaldığını gösterir.
• Kırmızı çizgili hoparlör sessize alındığını gösterir.

Sistem İşlemleri

Sistem ses işlemlerini gösteren katlanabilir bölüm. Varsayılan olarak gizli.

İkincil Cihazlar

Varsayılan dışındaki tüm çıkış cihazları için ses kontrolleri.

Alt Bilgi

• Varsayılan Çıkış — Sistem ses çıkışını değiştirmek için açılır menü.
• Ayarlar — (dişli simgesi) — Ayarları açar.
• Çıkış — (güç simgesi) — Onay ile MACA'yı kapatır.

Listedeki her uygulama gösterir:

Nasıl Çalışır

MACA, Apple Core Audio Taps kullanarak her uygulamanın ses akışını yakalar. Ses dijital sinyal işleme ile gerçek zamanlı uygulanır.

Herhangi bir uygulama satırındaki cihaz simgesine tıklayarak çıkış cihazı seçicisini açın.

Cihaz Seçici

• Sistem Varsayılanı — Varsayılan çıkış üzerinden yönlendirir.
• Mevcut Cihazlar — Tüm bağlı çıkış cihazlarını listeler.
• Bluetooth Bölümü — Eşleştirilmiş Bluetooth cihazlarını ayrı gösterir.

EQ düğmesine tıklayarak ayrı bir EQ penceresi açın.

EQ Pencere Kontrolleri

Özel EQ ProfilleriPro

Ayarlar > Ekolayzır'da özel profiller oluşturun.

Ayarlarda EQ

Tüm EQ profilleri ve uygulama yapılandırmalarının genel görünümü.

İletişim uygulamaları hariç tüm sesi kapatır:

• Ana penceredeki telefon simgesine tıklayın.
• Klavye kısayolunu kullanın (varsayılan: Option + Command + F).

Aktifken telefon simgesi yeşile döner.

Normalleştirici tüm uygulamalar arasındaki ses seviyelerini otomatik dengeler.Pro

Normalleştirici düğmesine tıklayarak etkinleştirin. 0,5 dB'den fazla ayarlama yapıldığında bir gösterge belirir:

• Artırırken turuncu (pozitif dB)
• Azaltırken camgöbeği (negatif dB)

Profiller ses yapılandırmanızın anlık görüntüsünü kaydeder — tek tıkla geçiş yapın.

Profil Oluşturma

1. Ayarlar > Profiller'i açın.
2. "+" düğmesine tıklayın.
3. Bir ad girin ve simge seçin (10 simge mevcut).
4. İsteğe bağlı: "Mevcut durumu yakala"yı etkinleştirin.

Profil Etkinleştirme

• Ana penceredeki profil seçiciden.
• Ayarlar > Profiller'den çift tıklama ile.
• Kısayollar uygulaması: "Profil Yükle" eylemi.

Otomatik Kaydet

Aktif profildeki değişiklikler otomatik kaydedilir.

Profil Düzenleme

Ayarlar > Profiller'de profili seçin ve düzenle:

• Simge seçici.
• Ad alanı.
• Profildeki tüm uygulamaların listesi.
• "Uygulama Ekle" düğmesi.

Varsayılan dışındaki tüm çıkış cihazları için ses kontrolleri.

Her cihaz satırı içerir:

• Cihaz simgesi.
• Cihaz adı.
• Ses kaydırıcı.
• Sessize alma düğmesi.
• Bilgi düğmesi.

MACA global klavye kısayollarını destekler. Ayarlar > Kısayollar'da yapılandırın.

Varsayılan Kısayollar

Kısayolları Özelleştirme

Kayıt alanına tıklayın ve istediğiniz tuş kombinasyonunu basın.

Kısayollar uygulamasını açın ve "MACA" arayın:

Dişli simgesinden veya menü çubuğu simgesine sağ tıklayarak açın.

Genel

Uygulama Görünürlüğü

Hangi uygulamaların göründüğünü kontrol edin.

• Görünürlüğü değiştir (göz simgesi).
• Ada veya paket kimliğine göre ara.
• Gizli uygulamaları filtrele.
• "Tümünü Göster" sıfırlar.
• "Geçmişi Temizle" kayıtları siler.

Cihaz Görünürlüğü

Hangi çıkış cihazlarının göründüğünü kontrol edin.

• Görünürlüğü değiştir.
• Ada göre ara.
• Taşıma türü ve kimlik.
• "Tümünü Göster" sıfırlar.
• "Geçmişi Temizle" siler.

Sistem

Hakkında

• Sürüm ve yapı numarası.
• Pro veya Free rozeti.
• Pro: teşekkür mesajı. Free: yükseltme düğmesi.
• Web sitesi, destek, App Store bağlantıları.

MACA arka planda her 30 saniyede otomatik kontrol yapar:

• Yetim toplam cihazlar — önceki çökmelerden.
• Yetim ses bağlantıları — artık bağlı olmayan.
• Rakip uygulamalar — MACA ile çakışabilecek.

Sorun bulunduğunda MACA otomatik onarım dener. Ayarlar > Sistem > Onarım Geçmişi'nden görüntüleyin.

Çıkışta Temizlik

MACA kapandığında tüm ses bağlantıları ve cihazlar temizlenir.

Yükseltmek için Ayarlar > Hakkında'da "Pro'ya Yükselt" düğmesine tıklayın. App Store üzerinden satın alınır.

Ayrıntılı sorun giderme adımları için sayfamızı ziyaret edin:

MACA, tüm ses uygulamalarını programatik olarak kontrol etmenizi sağlayan yerel bir REST API sunar. Otomasyon, Stream Deck, akıllı ev ve özel betikler için idealdir.

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