Linux kurulum rehberi

Linux'ta Kulak'ı sıfırdan hazır edin.

Önce ses sistemini kontrol edin (PulseAudio/PipeWire), sonra Kulak'ı indirin. Linux'ta sanal ses cihazı için harici bir sürücü GEREKMEZ — PulseAudio/PipeWire yerleşik olarak sanal sink oluşturabilir.

Bölüm 1 — Sistemi kontrol edin

Linux'unuz uygun mu?

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

Kulak'ı indirmeden ÖNCE sistemi kontrol edin

Linux'ta ekstra sürücü kurmaya gerek yok — ama ses sisteminizin hazır olduğundan emin olmalısınız.

1. 1

   1. Ses sunucunuzu tespit edin (PulseAudio vs PipeWire)

   Kulak hem PulseAudio hem PipeWire ile çalışır, ama farklı dağıtımlar farklı varsayılanlara sahiptir. **Kontrol:** ```bash pactl info | grep 'Server Name' ``` **Görebileceğiniz çıktılar:** • `Server Name: pulseaudio` → saf PulseAudio kullanıyorsunuz (eski) • `Server Name: PulseAudio (on PipeWire X.X.X)` → PipeWire var, PulseAudio uyumluluk katmanı üzerinden • `Connection failure` → ses sunucusu çalışmıyor, kontrol edin Her iki durumda da Kulak çalışır. PipeWire daha modern ve kararlıdır — Ubuntu 22.04 ve Fedora 35+ varsayılan olarak kullanır.

   Eğer pactl yüklü değilse: Ubuntu/Debian için `sudo apt install pulseaudio-utils`, Fedora için `sudo dnf install pulseaudio-utils`, Arch için `sudo pacman -S libpulse`.
2. 2

   2. Gerekli bağımlılıkları kurun

   Kulak'ın çalışması için birkaç sistem kütüphanesi gerekir. Çoğu dağıtımda zaten kurulu ama emin olmak için: **Ubuntu / Debian / Pop!_OS / Mint:** ```bash sudo apt update sudo apt install libgtk-3-0 libnss3 libasound2 libxss1 libxtst6 ``` **Fedora:** ```bash sudo dnf install gtk3 nss alsa-lib libXScrnSaver libXtst ``` **Arch / Manjaro:** ```bash sudo pacman -S gtk3 nss alsa-lib libxss libxtst ``` **openSUSE:** ```bash sudo zypper install libgtk-3-0 mozilla-nss libasound2 libXss1 libXtst6 ```

   Bu bağımlılıklar genellikle desktop dağıtımlarında zaten kurulu gelir. Hatayla karşılaşırsanız bu komutu çalıştırın.
3. 3

   3. Sanal ses sürücüsü? GEREKMEZ

   Windows'ta VB-Cable, macOS'ta BlackHole kurmak zorundaydık. Linux'ta bu adım **gerekli değil**. Sebebi: PulseAudio ve PipeWire yerleşik olarak "null-sink" ve "remap-source" oluşturabilir. Yani sanal mikrofon ve sanal hoparlör Linux'un kendi ses sunucusunda yapılandırılır — harici sürücü yok. Kulak ilk açıldığında otomatik olarak şu modülleri yükler: ``` module-null-sink sink_name=kulak-output module-remap-source master=kulak-output.monitor source_name=kulak-virtual-mic ``` Sonuç: "Kulak Virtual Mic" adlı bir ses cihazı oluşur ve Meet/Zoom/Teams bunu listeler. Bu işlem tamamen otomatiktir — Bölüm 4'te Kulak kurduktan sonra doğrulayacağız.

4. 4

   4. (Opsiyonel) Dağıtım bazlı notlar

   **Ubuntu 22.04+:** PipeWire varsayılan, her şey hazır. Kulak AppImage veya .deb ile çalışır. **Debian 12 (Bookworm):** PipeWire opsiyonel. `sudo apt install pipewire pipewire-pulse` ile geçiş yapabilirsiniz veya PulseAudio ile devam edebilirsiniz. **Fedora 35+:** PipeWire varsayılan, her şey hazır. **Arch / Manjaro:** `pipewire`, `pipewire-pulse`, `wireplumber` kurulu olmalı. Değilse: `sudo pacman -S pipewire pipewire-pulse wireplumber` **Wayland vs X11:** Kulak her ikisinde de çalışır. Wayland'da ekran paylaşımı için `xdg-desktop-portal-gtk` veya `xdg-desktop-portal-kde` kurulu olmalı — çoğu distro'da zaten gelir. **Flatpak kullanıcıları:** Flatpak Kulak sürümü henüz yok ama yol haritamızda var. Şimdilik AppImage veya .deb kullanın. **Snap kullanıcıları:** Snap sürümü de planlanıyor. Şu an için AppImage önerilir.

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

Kulak'ı indirin ve kurun

Dağıtımınıza göre AppImage veya .deb seçin.

1. 1

   5. Doğru paketi seçin

   Mimariyi ve paket formatını seçin: **x64 (Intel/AMD 64-bit):** • **AppImage (önerilen)** — [Kulak-linux-x64.AppImage indir](https://download.kulak.dev/kulak/Kulak-linux-x64.AppImage) • **.deb (Debian/Ubuntu)** — [kulak-linux-x64.deb indir](https://download.kulak.dev/kulak/kulak-linux-x64.deb) **arm64 (Raspberry Pi, Pinebook, ARM sunucular):** • **AppImage** — [Kulak-linux-arm64.AppImage indir](https://download.kulak.dev/kulak/Kulak-linux-arm64.AppImage) • **.deb** — [kulak-linux-arm64.deb indir](https://download.kulak.dev/kulak/kulak-linux-arm64.deb) **Hangisini seçmeliyim?** • **AppImage**: Her dağıtımda çalışır, taşınabilir, sistem klasörüne dokunmaz. Arch, Fedora, openSUSE ve diğer non-Debian distrolar için ideal. • **.deb**: Ubuntu ve Debian için daha iyi entegrasyon (menu, güncelleme, unutulmayan lisans). Ama sadece apt temelli sistemlerde çalışır.

2. 2

   6a. AppImage kurulumu

   AppImage'ı kurmak yok, çalıştırmak var. Ama birkaç hazırlık gerek. 1. İndirilen dosyayı erişimi kolay bir yere taşıyın: ```bash mkdir -p ~/Applications mv ~/Downloads/Kulak-linux-x64.AppImage ~/Applications/ cd ~/Applications ``` 2. Çalıştırılabilir yapın: ```bash chmod +x Kulak-linux-x64.AppImage ``` 3. Çalıştırın: ```bash ./Kulak-linux-x64.AppImage ``` Kulak açılır. Ama bu şekilde uygulama menüsüne eklenmez — her seferinde terminalden çalıştırmanız gerekir. **Menüye eklemek için (önerilen):** [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) kurun — AppImage'ı çift tıkladığınızda otomatik entegre eder. Ubuntu/Debian: ```bash sudo add-apt-repository ppa:appimagelauncher-team/stable sudo apt update sudo apt install appimagelauncher ``` Sonra AppImage'a çift tıklayın → "Integrate" seçin.

3. 3

   6b. .deb kurulumu (Ubuntu/Debian/Mint/Pop!_OS)

   .deb dosyası apt ile kurulabilir: ```bash cd ~/Downloads sudo apt install ./kulak-linux-x64.deb ``` apt eksik bağımlılıkları otomatik çözer. Kurulum bittiğinde: • Kulak uygulama menüsüne eklenir (Activities → Kulak'ı ara) • Terminalden `kulak` komutuyla da çalıştırabilirsiniz • Güncellemeler `apt upgrade` ile otomatik (repo'ya abone olduğunuzda) **Kaldırma:** ```bash sudo apt remove kulak ```

4. 4

   7. Kulak'ı ilk kez çalıştırın

   Uygulama menüsünden veya terminalden Kulak'ı başlatın: ```bash kulak # .deb kurulumu ./Kulak-linux-x64.AppImage # AppImage ``` İlk açılışta: 1. Kulak onboarding ekranını gösterir 2. Ses sistemini otomatik tespit eder (PulseAudio/PipeWire) 3. Sanal sink + source'u otomatik kurar 4. "Sanal mikrofon hazır" mesajını gösterir Eğer sanal mikrofon kurulmazsa: ```bash kulak --setup-virtual-mic ``` komutu manuel tetikler.

5. 5

   8. Mikrofon iznini verin

   Modern desktop ortamlarında (GNOME, KDE Plasma) ilk mikrofon erişiminde xdg-desktop-portal üzerinden bir onay iste gelir: > "Kulak mikrofonunuza erişmek istiyor" **İzin Ver** seçin. Bu onay kalıcıdır. AppImage çalıştırıyorsanız bazı durumlarda portal araya girmeyebilir — o zaman Kulak doğrudan PulseAudio'dan erişmeye çalışır, bu da kullanıcı seviyesinde çalışır (root gerektirmez).

6. 6

   9. Google ile giriş yapın

   Kulak ana ekranında **"Sign in with Google"**'a tıklayın. Varsayılan tarayıcınız (Firefox, Chrome, Chromium) açılır: 1. Google hesabınızı seçin 2. İzinleri onaylayın 3. Tarayıcı "Giriş başarılı" der, otomatik olarak Kulak'a döner **xdg-open gereksinimi:** AppImage tarayıcıyı açmak için `xdg-open` komutunu kullanır. Yüklü değilse: ```bash sudo apt install xdg-utils # Ubuntu/Debian sudo dnf install xdg-utils # Fedora sudo pacman -S xdg-utils # Arch ```

7. 7

   10. Dilleri seçin

   İki dropdown: • **"Ben konuşuyorum"** — anadiliniz • **"Karşı taraf"** — hedef dil 40+ dil mevcut.

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

Meet, Zoom ve Discord'da Kulak'ı mikrofon olarak seçin

Linux'ta sanal mikrofonun adı "Kulak Virtual Mic" (veya PulseAudio'da "Monitor of kulak-output") olacaktır.

1. 1

   11. Google Meet (tarayıcı) mikrofon seçimi

   Meet tarayıcıdan çalıştığı için tarayıcının mikrofon iznine bakar. **Firefox:** 1. meet.google.com → toplantıya katılın 2. Adres çubuğundaki mikrofon ikonuna tıklayın → "Kulak Virtual Mic" seçin 3. Meet içinde Ayarlar → Ses → Mikrofon → **"Kulak Virtual Mic"** **Chrome / Chromium:** 1. meet.google.com → toplantıya katılın 2. Meet Ayarları → Ses → Mikrofon → **"Kulak Virtual Mic"** **Gürültü iptali** ayarını Meet içinde **Kapalı** yapın.

2. 2

   12. Zoom (native Linux client) mikrofon seçimi

   1. Zoom → ⚙️ Ayarlar → **Ses** 2. **Mikrofon** dropdown → **"Kulak Virtual Mic"** (veya "Monitor of kulak-output") 3. "Otomatik ses seviyesi" kapalı 4. "Arka plan gürültüsünü bastır" → **Düşük** Zoom bazen cihaz listesini cache'ler. Kulak'ı Zoom'dan önce başlatın.

3. 3

   13. Microsoft Teams (Linux) — artık yok

   Microsoft Teams Linux istemcisini 2022'de kullanımdan kaldırdı. Linux'ta Teams kullanmanın yolları: • **teams.microsoft.com** tarayıcıdan (önerilen) • Chrome/Firefox üzerinden PWA olarak kur • Flatpak üzerinden 3. parti Teams wrapper'ları Tarayıcı yolu çalışır — mikrofon seçimini tarayıcı üzerinden yapın, tıpkı Meet gibi.

4. 4

   14. Discord için mikrofon seçimi

   1. Discord → Kullanıcı Ayarları (dişli) → **Ses ve Video** 2. **Giriş Cihazı** → **"Kulak Virtual Mic"** 3. **Gürültü bastırma** → **Yok** 4. **Yankı engelleme** → **Kapalı**

5. 5

   15. Test çağrısı

   Kulak → Menü → **"Test Çağrısı"**. Bot açılır, sesli test yaparsınız. Başarılıysa hazırsınız. Başarısızsa sorun giderme bölümüne geçin.

Sorun giderme

Yaygın sorunlar ve çözümleri

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

1. 1

   Sorun: Sanal mikrofon oluşturulmadı

   **Çözüm:** Kulak'ın kendi teşhis komutunu çalıştırın: ```bash kulak --doctor ``` Bu komut ses cihazlarını, modül durumunu, ses sunucusunu ve yaygın hataları raporlar. Manuel düzeltme: ```bash pactl load-module module-null-sink sink_name=kulak-output sink_properties=device.description=Kulak_Output pactl load-module module-remap-source master=kulak-output.monitor source_name=kulak-virtual-mic source_properties=device.description=Kulak_Virtual_Mic ``` Kalıcı hale getirmek için: ```bash echo 'load-module module-null-sink sink_name=kulak-output' >> ~/.config/pulse/default.pa echo 'load-module module-remap-source master=kulak-output.monitor source_name=kulak-virtual-mic' >> ~/.config/pulse/default.pa ```

2. 2

   Sorun: 'pactl' komutu bulunamadı

   **Çözüm:** ```bash # Ubuntu/Debian sudo apt install pulseaudio-utils # Fedora sudo dnf install pulseaudio-utils # Arch sudo pacman -S libpulse ```

3. 3

   Sorun: PipeWire çalışıyor ama null-sink oluşmuyor

   **Çözüm:** PipeWire'da PulseAudio uyumluluk katmanı (`pipewire-pulse`) kurulu olmalı: ```bash sudo apt install pipewire-pulse # Ubuntu sudo dnf install pipewire-pulseaudio # Fedora sudo pacman -S pipewire-pulse # Arch ``` Ayrıca `wireplumber` servisinin çalıştığından emin olun: ```bash systemctl --user status wireplumber ``` Çalışmıyorsa: ```bash systemctl --user enable --now wireplumber ```

4. 4

   Sorun: AppImage açılmıyor, 'cannot open' hatası

   **Çözüm:** 1. İzin ekleyin: ```bash chmod +x Kulak-linux-x64.AppImage ``` 2. FUSE kurulu mu kontrol edin: ```bash fusermount --version ``` Yoksa: ```bash sudo apt install fuse libfuse2 # Ubuntu 22.04+ sudo dnf install fuse fuse-libs # Fedora ``` 3. Hâlâ olmuyorsa AppImage'ı --no-sandbox bayrağıyla çalıştırın: ```bash ./Kulak-linux-x64.AppImage --no-sandbox ```

5. 5

   Sorun: Wayland'de overlay görünmüyor

   **Çözüm:** Wayland'de overlay için `xdg-desktop-portal` gerekir: ```bash # GNOME sudo apt install xdg-desktop-portal xdg-desktop-portal-gtk # KDE sudo apt install xdg-desktop-portal xdg-desktop-portal-kde ``` Son çare olarak X11 oturumunda oturum açın (giriş ekranında dişli ikonuna tıklayın → "GNOME on Xorg").

6. 6

   Sorun: .deb kurulumu bağımlılık hatası veriyor

   **Çözüm:** `apt install ./kulak-linux-x64.deb` yerine: ```bash sudo dpkg -i kulak-linux-x64.deb sudo apt --fix-broken install ``` Bu ikili komut eksik bağımlılıkları zorla çözer.