YouT Video Mp3 Downloader v1.0.0

📸 Ekran Görüntüsü

✨ Özellikler

• 🎥 Video indirme (MP4 formatında, en iyi kalitede)
• 🎵 Ses indirme (MP3 formatında, 192kbps)
• 🎬 Video ve ses birlikte indirme
• 📁 İndirme klasörü seçimi (son seçilen klasör hatırlanır)
• 📊 Gerçek zamanlı ilerleme göstergesi
• 🎨 Modern ve kullanıcı dostu dark tema arayüz
• ⚡ FFmpeg otomatik kurulumu (Windows için)
• ✅ URL validasyonu (sadece geçerli YouTube linkleri)
• 🔄 Arka plan indirme (uygulama donmaz)
• 💾 Ayarlar hatırlama (indirme klasörü vb.)

Gereksinimler

• Python 3.7 veya üzeri
• FFmpeg (opsiyonel ama önerilir - en iyi kalite için gerekli)

FFmpeg Kurulumu

FFmpeg olmadan da çalışır, ancak:

• Video kalitesi biraz düşük olabilir
• MP3 dönüştürme yapılamaz (ses dosyası orijinal formatta indirilir)
• Video ve ses birleştirme yapılamaz

Otomatik Kurulum (Önerilen - Windows):
Uygulama içinde FFmpeg yoksa, "FFmpeg'i Otomatik Kur" butonuna tıklayarak FFmpeg'i otomatik olarak indirip kurabilirsiniz. Bu özellik şu anda sadece Windows için desteklenmektedir.

Manuel Kurulum:

Windows:

1. FFmpeg Windows Builds adresinden indirin
2. ZIP dosyasını açın ve bin klasöründeki ffmpeg.exe dosyasını:
3. Sistem PATH'ine ekleyin, VEYA
4. Uygulama klasörüne kopyalayın

Alternatif (Chocolatey ile):

choco install ffmpeg

Alternatif (Scoop ile):

scoop install ffmpeg

Linux:

sudo apt-get install ffmpeg

macOS:

brew install ffmpeg

Kurulumu kontrol etmek için:

ffmpeg -version

📦 Kurulum

Seçenek 1: Windows Exe (En Kolay)

1. Releases sayfasından son sürümü indirin
2. YouT-Video-Mp3-Downloader.exe dosyasını çalıştırın
3. Python kurulumu gerektirmez

Seçenek 2: Kaynak Koddan

1. Python Kurulumu

Python 3.7 veya üzeri sürüm gereklidir. Python'u buradan indirin.

2. Projeyi İndirin

git clone https://github.com/onderxyilmaz/YouT-Video-Mp3-Downloader.git
cd YouT-Video-Mp3-Downloader

veya ZIP olarak indirip açın.

3. Gerekli Paketleri Yükleyin

pip install -r requirements.txt

Gerekli paketler:

• yt-dlp - YouTube video indirme
• customtkinter - Modern GUI
• pillow - Görüntü işleme
• requests - FFmpeg indirme

🚀 Kullanım

Uygulamayı Başlatın

Windows Exe:

• YouT-Video-Mp3-Downloader.exe dosyasını çift tıklayın

Kaynak Kod:

python youtube_downloader.py

Adım Adım:

1. YouTube URL'sini girin
2. Video URL'sini yapıştırın
3. URL otomatik olarak doğrulanır

4. Geçersiz URL'lerde indirme butonu pasif kalır

5. İndirme tipini seçin

6. 🎥 Video: Sadece video (MP4)
7. 🎵 Ses: Sadece ses (MP3)

8. 🎬 Her İkisi: Hem video hem ses ayrı dosyalar olarak

9. İndirme klasörünü seçin

10. Varsayılan: Downloads klasörü
11. Son seçtiğiniz klasör hatırlanır

12. Manuel yazma devre dışı, buton ile seçim yapılır

13. İndirmeyi başlatın

14. İlerleme çubuğu gerçek zamanlı güncellenir
15. İndirme sırasında form kilitlenir
16. Tamamlandığında bildirim alırsınız

🎯 Desteklenen URL Formatları

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://www.youtube.com/watch?v=VIDEO_ID&list=...

📝 Notlar

• ✅ İndirme işlemi arka planda çalışır, uygulama donmaz
• 💾 İndirilen dosyalar seçtiğiniz klasöre kaydedilir
• 🎬 FFmpeg varsa: Video MP4, ses MP3 formatında indirilir
• ⚠️ FFmpeg yoksa: Dosyalar orijinal formatlarında indirilir (webm, m4a vb.)
• 📊 Uygulama başlangıçta FFmpeg durumunu gösterir
• ⏱️ Uzun videolar için indirme süresi uzun olabilir
• 🌐 İnternet hızınız indirme süresini etkiler

🐛 Bilinen Sorunlar

• Bazı yaş kısıtlamalı videolar indirilemeyebilir
• Çok uzun (>2 saat) videolarda yavaşlama olabilir
• Bazı premium içerikler desteklenmez

🔧 Windows Exe Oluşturma

Uygulamayı kendiniz .exe dosyasına dönüştürmek için:

# Otomatik
python build_exe.py

# Manuel
pip install pyinstaller
pyinstaller --onefile --windowed youtube_downloader.py

Detaylı bilgi için build_instructions.md dosyasına bakın.

🔄 Sürüm Geçmişi

v1.0.0 (2024)

• ✨ İlk stabil sürüm
• 🎥 Video/Ses/Her İkisi indirme desteği
• ⚡ FFmpeg otomatik kurulum (Windows)
• 📁 Klasör seçimi ve hatırlama
• ✅ URL validasyonu
• 🎨 Modern dark tema arayüz
• 📦 Windows exe desteği

🤝 Katkıda Bulunma

Katkılarınızı bekliyoruz! Lütfen şu adımları izleyin:

1. Bu repo'yu fork edin
2. Feature branch'i oluşturun (git checkout -b feature/AmazingFeature)
3. Değişikliklerinizi commit edin (git commit -m 'Add some AmazingFeature')
4. Branch'inizi push edin (git push origin feature/AmazingFeature)
5. Pull Request açın

Detaylı bilgi için CONTRIBUTING.md dosyasına bakın.

💝 Destek

Bu proje tamamen ücretsizdir ve açık kaynaklıdır. Eğer yararlı bulduysanız:

• ⭐ GitHub'da yıldız vererek
• 🐛 Hata bildirerek
• 📣 Sosyal medyada paylaşarak
• 💰 Kahve ısmarlayarak destek olabilirsiniz

⚖️ Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.

⚠️ Yasal Uyarı

ÖNEMLİ: Bu araç yalnızca eğitim amaçlıdır. Kullanıcılar, bu aracı kullanırken YouTube'un Kullanım Şartları'na ve telif hakkı yasalarına uymakla yükümlüdür.

• ✅ Sadece kendi içeriklerinizi indirin
• ✅ Telif hakkı izniniz olan videoları indirin
• ✅ Eğitim ve kişisel kullanım için kullanın
• ❌ Ticari amaçla kullanmayın
• ❌ Başkalarının telif haklarını ihlal etmeyin

Sorumluluk Reddi: Geliştirici, bu aracın yanlış kullanımından kaynaklanan herhangi bir yasal sorundan sorumlu değildir.

📧 İletişim

UnderSpeed - Onder Yilmaz

Proje Linki: https://github.com/onderxyilmaz/YouT-Video-Mp3-Downloader

🙏 Teşekkürler

Bu proje şu harika açık kaynak projeleri kullanmaktadır:

• yt-dlp - YouTube indirme motoru
• CustomTkinter - Modern GUI framework
• FFmpeg - Medya işleme