macOS kurulum rehberi

macOS'te Kulak'ı sıfırdan hazır edin.

Önce Mac'inizi hazırlayın (gereksinimler + BlackHole sanal ses sürücüsü), sonra Kulak'ı indirin. Bu sıra önemli — eksik adım atlarsanız Meet/Zoom/Teams çevirilen sesi duyamaz.

Bölüm 1 — Önce sistemi kontrol edin

Mac'inizde çalışır mı?

Bölüm 2 — Ön hazırlık

Kulak'ı indirmeden ÖNCE bunları yapın

Bu üç adım olmadan Kulak çalışmaz. Sonra kafanızın karışmaması için önce bunları halledin.

1. 1

   1. Mac'inizin işlemcisini öğrenin (Apple Silicon mı, Intel mi?)

   İndireceğiniz DMG, Mac'inizin işlemcisine bağlıdır. Yanlış mimariyi indirirseniz uygulama açılmaz. **Nasıl kontrol edilir:** 1. Sol üst köşedeki 🍎 **Apple menüsü** → **Bu Mac Hakkında** 2. Açılan penceredeki **"Chip"** (veya eski sistemlerde "Processor") satırına bakın **Ne göreceğinize göre:** • **"Apple M1"**, **"Apple M2"**, **"Apple M3"**, **"Apple M4"** → Apple Silicon → **arm64 DMG** indireceksiniz • **"Intel Core i5/i7/i9/i3"** → Intel → **x64 DMG** indireceksiniz Bu bilgiyi bir yere not edin — 5. adımda kullanacağız.

   Apple Silicon Mac'ler 2020 Kasım sonrasında çıkan tüm MacBook Air, MacBook Pro, iMac, Mac mini ve Mac Studio modelleridir. 2019 ve öncesi hepsi Intel'dir.
2. 2

   2. BlackHole sanal ses sürücüsünü kurun (ZORUNLU)

   macOS'un yerleşik bir "sanal mikrofon" özelliği yoktur. Yani Kulak'ın ürettiği çevrilmiş sesi Meet, Zoom veya Teams gibi uygulamalara göndermek için harici bir sürücüye ihtiyacımız var. Bu sürücüye **BlackHole 2ch** diyoruz — ücretsiz, açık kaynak, 5 MB, macOS'ta en yaygın kullanılan sanal ses sürücüsü. **Ne işe yarar:** BlackHole, macOS'a "sahte bir ses cihazı" (hem giriş hem çıkış) ekler. Kulak sesi bu sahte cihaza yazar, Meet/Zoom/Teams de bu sahte cihazı mikrofon olarak algılar. **Nasıl kurulur:** 1. Tarayıcınızdan [existential.audio/blackhole](https://existential.audio/blackhole/) adresine gidin 2. Sayfada **"Download BlackHole 2ch"** butonuna tıklayın 3. Email adresinizi isteyen bir form çıkar — email verin (gönderdiğiniz emaile indirme linki gelir; spam yok) 4. Mailinize gelen linkle **.pkg** dosyasını indirin (~4 MB) 5. İndirilen **BlackHole2ch.v0.X.X.pkg** dosyasına çift tıklayın 6. Installer wizard açılır: **Devam → Devam → Yükle** 7. macOS yönetici şifrenizi isteyecek — girin 8. "Yükleme başarılı" mesajını görün → **Kapat** Kurulumdan sonra doğrulayın: **Sistem Ayarları → Ses → Çıkış** listesinde "BlackHole 2ch" görünmelidir.

   Kurulum sırasında macOS 'Sistem uzantısı engellendi' uyarısı gösterebilir. Bu durumda: Sistem Ayarları → Gizlilik ve Güvenlik → en alta inin → 'Existential Audio Inc.' uyarısının yanındaki **İzin Ver** butonuna basın. Gerekirse Mac'i yeniden başlatın. Bu adım atlanmaz, yoksa BlackHole çalışmaz.
3. 3

   3. Kulak'ın otomatik BlackHole kurulumunu tercih ediyorsanız — bu adımı atlayın

   2. adımda BlackHole'u manuel kurmayı anlattık çünkü her kullanıcı sistem uzantısı kurmak isteyebilir ve neye izin verdiğini bilmesi önemli. Alternatif olarak: **Kulak kurulumu sırasında, onboarding ekranında "Sanal mikrofonu kur" butonu ile aynı BlackHole sürücüsünü tek tıkla kurabilirsiniz.** Arka planda aynı .pkg dosyası çalıştırılır, aynı izinler istenir, aynı sonuç elde edilir. İki yolun da sonucu aynıdır. Güvenlik ve kontrol için manuel kurulumu öneririz; hız için otomatik kurulumu seçebilirsiniz.

4. 4

   4. Mac'i yeniden başlatın (opsiyonel ama önerilir)

   Sistem uzantısı yükledikten sonra macOS'un onu tam olarak tanıması bazen yeniden başlatma gerektirir. Özellikle Intel T2 çipli Mac'lerde. Yeniden başlatma adım 5'te DMG indirme sırasında yapılabilir — fark etmez.

Bölüm 3 — Kulak'ı indirme ve kurma

Artık Kulak'ı indirebilirsiniz

Ön hazırlık tamam. Şimdi Kulak'ı kurup kullanmaya başlayın.

1. 1

   5. Doğru DMG'yi indirin

   1. adımda not ettiğiniz işlemciye göre: • **Apple Silicon (M1/M2/M3/M4)** → [Kulak-mac-arm64.dmg indir](https://download.kulak.dev/kulak/Kulak-mac-arm64.dmg) • **Intel Mac** → [Kulak-mac-x64.dmg indir](https://download.kulak.dev/kulak/Kulak-mac-x64.dmg) Dosya boyutu ~85 MB. İnternet hızınıza bağlı 10-30 saniyede iner. İndirilen dosya Finder'daki **İndirilenler** klasöründe olur.

2. 2

   6. DMG'yi açın ve Kulak.app'i Applications klasörüne taşıyın

   1. İndirilen **Kulak-mac-arm64.dmg** (veya x64) dosyasına çift tıklayın 2. Açılan Finder penceresinde iki ikon görürsünüz: **Kulak.app** ve **Applications** klasörünün kısayolu 3. **Kulak.app** ikonunu sürükleyip **Applications**'a bırakın 4. Kopyalama 2-3 saniye sürer 5. Kopyalama bitince DMG'yi çıkarın: Finder kenar çubuğunda DMG'nin yanındaki ⏏ eject simgesine tıklayın

   DMG'nin içinden Kulak'ı doğrudan çalıştırmayın. Önce Applications'a taşıyın — aksi halde uygulama güncelleme yapamaz ve bazı macOS API'lerine erişemez.
3. 3

   7. Kulak'ı ilk kez açın ve 'bilinmeyen geliştirici' uyarısını geçin

   Launchpad'ten (F4 veya dock'ta roket ikonu) **Kulak**'ı başlatın. İlk açılışta macOS Gatekeeper bir uyarı gösterir: > "Kulak" açılamıyor çünkü Apple doğrulanmış kötü amaçlı yazılım içermediğinden emin olamıyor. Bunu geçmek için: 1. Uyarıyı **İptal** ile kapatın 2. **Sistem Ayarları** → **Gizlilik ve Güvenlik** 3. Sayfanın en altına kaydırın 4. "Kulak açılmaya engellendi" yazısının yanındaki **"Yine de Aç"** butonuna tıklayın 5. Yönetici şifrenizi girin (Touch ID de çalışır) 6. Kulak açılır

   Bu uyarı her yeni uygulamada ilk açılışta çıkar. Kod imzalama sertifikamız var ama Apple'ın notarizasyon süreci pahalıdır; yakında bu adım kalkacak.
4. 4

   8. Mikrofon iznini verin

   Kulak ilk açıldığında macOS mikrofon erişimi ister. Açılan dialog'da **"İzin Ver"** seçin. Yanlışlıkla "İzin Verme" dediyseniz: 1. **Sistem Ayarları** → **Gizlilik ve Güvenlik** → **Mikrofon** 2. Listede **Kulak**'ı bulun 3. Yanındaki toggle'ı açın Mikrofon izni olmadan Kulak sizin konuşmanızı duyamaz.

5. 5

   9. Ekran Kaydı iznini verin (KRİTİK)

   Bu adım en kritik olanıdır. "Ekran Kaydı" ismine aldanmayın — macOS bu izni sistem sesini yakalamak için de kullanır. Yani Netflix, Zoom, YouTube, Meet'ten gelen sesi duyabilmek için şart. 1. **Sistem Ayarları** → **Gizlilik ve Güvenlik** → **Ekran Kaydı** 2. Listede **Kulak**'ı göremiyorsanız: Kulak'ı bir kez çalıştırın ve ses yakalamayı deneyin — o zaman listeye eklenir 3. **Kulak**'ın yanındaki toggle'ı açın 4. macOS "Uygulama yeniden başlatılmalı" der → **Çık ve Yeniden Aç** Kulak tamamen kapanıp yeniden açılır.

   Bu izin verilmezse Netflix/Zoom/Meet/YouTube gibi uygulamalardaki sesi yakalayamazsınız. Sizin mikrofonunuz çalışır ama karşı taraf duyulmaz. En sık karşılaşılan kurulum sorunudur — atlamayın.
6. 6

   10. Google ile giriş yapın

   Ana ekranda **"Sign in with Google"** butonuna tıklayın. Varsayılan tarayıcınız açılır: 1. Google hesabınızı seçin 2. Kulak'ın isteyeceği izinler: email ve profil görüntüleme 3. **Devam** / **Allow** 4. Tarayıcı "Giriş başarılı" mesajı gösterir ve otomatik olarak Kulak'a döner 30 dakikalık ücretsiz denemeniz o anda aktif olur. Kredi kartı istenmez.

7. 7

   11. Kaynak ve hedef dili seçin

   Kulak ana ekranında iki dropdown vardır: • **"Ben konuşuyorum"** — sizin anadiliniz (örn. Türkçe) • **"Karşı taraf"** — hedef dil (örn. İngilizce) 40+ dil mevcuttur. Dilleri toplantı ortasında da değiştirebilirsiniz — değişiklik anlıktır.

Bölüm 4 — Toplantı uygulamalarıyla entegrasyon

Meet, Zoom ve Teams'de Kulak'ı mikrofon olarak seçin

BlackHole kurulumu ve Kulak çalıştıktan sonra artık toplantı uygulamalarınız Kulak'ı mikrofon olarak görecek.

1. 1

   12. Google Meet'te mikrofonu değiştirin

   1. meet.google.com'a gidin, toplantıya katılın (veya test odası açın) 2. Sağ altta **"•••"** üç nokta menüsü → **Ayarlar** → **Ses** sekmesi 3. **Mikrofon** dropdown'ından **"Kulak Virtual Microphone"** seçin 4. **Hoparlörü değiştirmeyin** — varsayılan kalsın 5. **Gürültü iptali** ayarını **"Kapalı"** yapın (kritik — aksi halde Kulak'ın ürettiği sesi gürültü sanar)

2. 2

   13. Zoom'da mikrofonu değiştirin

   1. Zoom → ⚙️ Ayarlar → **Ses** sekmesi 2. **Mikrofon** → **"Kulak Virtual Microphone"** 3. **"Otomatik ses seviyesini ayarla"** → **Kapalı** 4. **"Arka plan gürültüsünü bastır"** → **"Düşük"** Zoom Pro'daysanız "Original Sound for Musicians" modunu açarsanız çeviri kalitesi biraz daha artar.

3. 3

   14. Microsoft Teams'de mikrofonu değiştirin

   1. Teams → Profil fotoğrafı → **Ayarlar** → **Cihazlar** 2. **Mikrofon** → **"Kulak Virtual Microphone"** 3. **Gürültü bastırma** → **"Kapalı"** Teams bazen sanal mikrofonu listelemez. Bu durumda Teams'i tamamen kapatın (⌘Q — sadece pencere kapatmak yetmez), sonra tekrar açın.

4. 4

   15. Test çağrısı yapın

   Kulak → Menü → **"Test Çağrısı"** seçeneğine tıklayın. Bir test botu açılır: 1. Türkçe "Merhaba, adım Ali" deyin 2. Bot karşınıza İngilizce "Hello, my name is Ali" yanıtı verir 3. Bot bir cümle İngilizce söyler, siz Türkçe duyarsınız Test başarılıysa her şey doğru kurulmuştur. Başarısızsa aşağıdaki sorun giderme bölümüne bakın.

Sorun giderme

Yaygın sorunlar ve çözümleri

Kuruluma rağmen çalışmıyorsa bu adımlardan geçin.

1. 1

   Sorun: Meet/Zoom mikrofon listesinde 'Kulak Virtual Microphone' yok

   **Neden:** BlackHole sistem uzantısı henüz onaylanmamış veya Kulak bridge'i oluşturamamış. **Çözüm:** 1. Sistem Ayarları → Gizlilik ve Güvenlik → aşağı inin → "Existential Audio Inc." uyarısı varsa **İzin Ver** 2. Mac'i yeniden başlatın 3. Kulak → Ayarlar → Gelişmiş → **"Sanal mikrofonu yeniden kur"** 4. Sistem Ayarları → Ses → Çıkış listesinde "BlackHole 2ch" görünüyor mu kontrol edin 5. Yine olmuyorsa BlackHole'u kaldırıp [existential.audio/blackhole](https://existential.audio/blackhole/) sayfasından en güncel sürümü tekrar kurun

2. 2

   Sorun: Mikrofon aktif ama karşı tarafın sesi gelmiyor

   **Neden:** Ekran Kaydı izni yok veya izin verildikten sonra Kulak yeniden başlatılmadı. **Çözüm:** 1. Sistem Ayarları → Gizlilik ve Güvenlik → **Ekran Kaydı** → Kulak toggle'ı açık mı? 2. Açıksa: Kulak'ı **tamamen kapatın** (⌘Q, pencere kapatmak değil) ve tekrar açın 3. Kapalıysa: toggle'ı açın, Kulak otomatik yeniden başlatılır

3. 3

   Sorun: BlackHole kurulumu 'sistem uzantısı engellendi' hatası veriyor

   **Çözüm:** 1. Sistem Ayarları → Gizlilik ve Güvenlik 2. Sayfanın en altına kadar kaydırın 3. "Existential Audio Inc. tarafından yazılım yüklenmesi engellendi" uyarısının yanındaki **İzin Ver** butonuna tıklayın 4. Şifrenizi girin 5. Mac'i yeniden başlatın Apple Silicon Mac'lerde genelde tek tıkla hallolur. Intel T2 çipli Mac'lerde ek olarak Recovery Mode'dan "Reduced Security" ayarlamak gerekebilir.

4. 4

   Sorun: Çeviri çok yavaş veya takılıyor

   **Çözüm:** 1. Aktivite İzleyici → CPU kullanımı: Kulak %20-40 arası olmalı 2. Diğer büyük uygulamaları kapatın (40 sekmeli Chrome, Xcode, vs.) 3. İnternet hızı testi — 10+ Mbps öneriyoruz, 25+ ideal 4. Kulak → Ayarlar → **Kalite modu "Hızlı"** (gecikme azalır)

5. 5

   Sorun: Tüm izinleri tekrar sıfırlamak istiyorum

   Bazen macOS izinleri "unuttur" ve yeniden ayarlamak mümkün olmayabilir. Sıfırlama komutu: ``` tccutil reset All dev.kulak.Kulak ``` Terminal'de çalıştırın. Kulak'ın tüm izinlerini sıfırlar. Kulak'ı yeniden açtığınızda tüm izinler baştan istenir.

   Komutu tam olarak kopyalayın. Yanlış bundle ID girerseniz başka uygulamaların izinlerini silebilirsiniz.
6. 6

   Sorun: AirPods veya Bluetooth kulaklık kullanıyorum, ses kalitesi düşük

   AirPods bağlıyken macOS varsayılan olarak SCO modunda çalışır — düşük kalite. Yüksek kalite (A2DP) modunda çalışması için: 1. **Sistem Ayarları** → **Ses** → **Giriş** 2. Giriş cihazı olarak **MacBook mikrofonu**'nu seçin (AirPods'un mikrofonu **değil**) 3. **Çıkış** → **AirPods** Bu ayar AirPods'un yüksek kalite modunda çalışmasını sağlar.