📦 Kurulum Rehberi

Paddy Soundboard'u sisteminize kurmak için adım adım rehber

🪟 Windows Kurulumu (Önerilen)

Sistem Gereksinimleri

  • İşletim Sistemi: Windows 10/11 (64-bit)
  • Disk Alanı: ~80 MB (ses kütüphanesi hariç)
  • FFmpeg: Sadece YouTube indirme özelliği için gerekli (opsiyonel)

✨ Python ve tüm bağımlılıklar installer içinde! Ayrıca kurmanıza gerek yok.

1

Installer'ı İndirin

GitHub Releases sayfasından son sürümü indirin:

Paddy-Soundboard-Setup-v1.0.0.exe (~80 MB)
2

Kurulum Sihirbazını Çalıştırın

Setup dosyasını çalıştırın ve kurulum klasörünü seçin:

  • Varsayılan konum: C:\Program Files\Paddy Soundboard\
  • Masaüstü ve Başlat Menüsü kısayolları oluşturulacak
  • Ayarlar ve kütüphane %APPDATA%\Paddy\ konumunda saklanacak
3

FFmpeg Kurulumu (Opsiyonel)

YouTube indirme özelliğini kullanmak istiyorsanız FFmpeg kurun:

https://www.gyan.dev/ffmpeg/builds/

Alternatif: Chocolatey ile kurulum:

choco install ffmpeg

⚠️ FFmpeg sadece YouTube indirme için gerekli. Ses çalma için gerekli değil!

4

Virtual Audio Cable (Opsiyonel)

Discord/TeamSpeak gibi uygulamalara ses göndermek için:

Detaylı kurulum için Voicemeeter Rehberini inceleyin.

5

Çalıştırma

Masaüstü veya Başlat Menüsünden Paddy'yi başlatın:

✅ Paddy kullanıma hazır!

🔧 Gelişmiş: Kaynak Koddan Çalıştırma

Geliştirici veya özelleştirme yapmak istiyorsanız:

git clone https://github.com/PaddySoundboard/Paddy.git cd Paddy pip install -r requirements.txt python main.py

Gereksinimler: Python 3.9+, FFmpeg (PATH'te olmalı)

🎙️ Voicemeeter Kurulumu (Opsiyonel ama Tavsiye Edilir)

Sanal ses kanalları için Voicemeeter Banana kullanmanızı öneriyoruz:

  1. VB-Audio'dan Voicemeeter Banana'yı indirin: https://vb-audio.com/Voicemeeter/banana.htm
  2. VB-Audio Virtual Cable'ı indirin: https://vb-audio.com/Cable/
  3. Her ikisini de kurun ve bilgisayarı yeniden başlatın
  4. Ayrıntılı ayarlar için Voicemeeter Rehberi'ne bakın

🐧 Linux Kurulumu

Native Kurulum (Tavsiye Edilir)

PyQt6 Linux'ta native olarak çalışır:

Ubuntu/Debian:

sudo apt update sudo apt install python3 python3-pip ffmpeg portaudio19-dev git clone https://github.com/PaddySoundboard/Paddy.git cd Paddy pip3 install -r requirements.txt python3 main.py

Fedora:

sudo dnf install python3 python3-pip ffmpeg portaudio-devel git clone https://github.com/PaddySoundboard/Paddy.git cd Paddy pip3 install -r requirements.txt python3 main.py

Arch Linux:

sudo pacman -S python python-pip ffmpeg portaudio git clone https://github.com/PaddySoundboard/Paddy.git cd Paddy pip install -r requirements.txt python main.py

Sanal Ses Kablosu (Linux)

PulseAudio ile loopback modülü kullanın:

pactl load-module module-null-sink sink_name=VirtualCable pactl load-module module-loopback source=VirtualCable.monitor

Detaylı bilgi için Linux Rehberi'ne bakın

🔧 Sorun Giderme

"Python bulunamadı" hatası

Python'un PATH'e eklendiğinden emin olun. Terminali yeniden başlatın veya bilgisayarı yeniden başlatın.

python --version

"FFmpeg bulunamadı" hatası

FFmpeg'in PATH'de olduğunu kontrol edin:

ffmpeg -version

"ModuleNotFoundError" hatası

Bağımlılıkları yeniden yükleyin:

pip install -r requirements.txt --force-reinstall

Ses çıkmıyor

  • Ayarlar → Çıkış Cihazı'nı kontrol edin
  • Voicemeeter kullanıyorsanız VAIO Input seçili olmalı
  • Ses dosyasının formatını kontrol edin (MP3, WAV, FLAC desteklenir)