TaxVideoConvert

YouTube videolarını en yüksek kalitede önizleyin, kesin ve istediğiniz formatta dışa aktarın!
Belgeleri Keşfedin »

Demo Görüntüle · Hata Bildir · Özellik İste

İçindekiler

1. Proje Hakkında
   • Kullanılan Teknolojiler
2. Başlarken
   • Gereksinimler
   • Kurulum
   • FFmpeg ve yt-dlp Kurulumu (Vendor)
   • Otomatik Release Yayınlama
3. Kullanım
4. Güvenlik Yamaları
5. Lisans
6. İletişim

---

🚀 Proje Hakkında

TaxVideoConvert, içerik üreticileri için geliştirilmiş Electron tabanlı, güçlü bir video işleme aracıdır. YouTube videolarını (kendi kanalınızdakiler vb.) doğrudan bağlantı üzerinden alır, en yüksek kalitede (8K'ya kadar) önizleme sunar ve yeniden kodlamaya (transcode) gerek kalmadan veya isteğe bağlı formatlarda kırpmanıza olanak tanır.

Öne Çıkan Özellikler:

• 🎞️ Kayıpsız Kesim: "Copy" codec modu ile videoyu yeniden işlemeden saniyeler içinde kesin.
• 🎧 Format Desteği: MP4, MKV, WebM konteynerleri; H.264, HEVC, VP9, AV1 video codec'leri.
• 🔒 Güvenli Proxy: Önizleme sırasında CORS hatalarını aşan, SSRF korumalı dahili proxy.
• 🎛️ Gelişmiş Kodekler: ProRes, Opus, FLAC, PCM (WAV) gibi profesyonel ses ve video seçenekleri.

(başa dön)

🛠️ Kullanılan Teknolojiler

Proje, modern ve güvenilir açık kaynak kütüphaneler üzerine inşa edilmiştir.

• 
• 
• ffmpeg-static & fluent-ffmpeg
• yt-dlp
• Express.js (Dahili Proxy Sunucusu)

(başa dön)

---

⚡ Başlarken

Projeyi yerel makinenizde çalıştırmak için aşağıdaki adımları takip edin.

Gereksinimler

• Node.js (v16 veya üzeri önerilir)
• npm

Kurulum

1. Repoyu klonlayın:

   git clone https://github.com/kullaniciadi/TaxVideoConvert.git

2. Proje dizinine gidin ve paketleri yükleyin:

   cd TaxVideoConvert
   npm install

⚙️ FFmpeg ve yt-dlp Kurulumu (Vendor)

Bu uygulama, video işleme işlemleri için harici araçlara ihtiyaç duyar. Varsayılan olarak npm paketleri kullanılsa da, manuel kurulum (vendor klasörü) prodüksiyon ortamları için önerilir.

1. Uygulamanın ana dizininde vendor adında bir klasör oluşturun.
2. İçerisine ffmpeg ve yt-dlp klasörlerini ekleyin.

Dosya Ağacı Yapısı:

TaxVideoConvert/
├── src/
├── package.json
└── vendor/
    ├── ffmpeg/
    │   └── ffmpeg.exe    <-- FFmpeg binary dosyasını buraya koyun
    └── yt-dlp/
        └── win/
            └── yt-dlp.exe  <-- yt-dlp binary dosyasını buraya koyun

Not: Uygulama başlatıldığında önce vendor klasörünü kontrol eder. Bulamazsa sistem PATH'indeki veya node_modules içindeki statik binary'leri kullanmaya çalışır.

(başa dön)

Otomatik Release Yayınlama

GitHub Actions, v* formatında tag gönderildiğinde Windows installer üretir ve GitHub Release'e yükler. Aynı tag için GitHub, kaynak kod zip ve tar.gz arşivlerini Release sayfasında otomatik gösterir.

Değişiklikleri commitledikten sonra yeni sürüm tag'ini oluşturup gönderin:

npm version patch
git push origin main --tags

npm version patch, örneğin 1.0.9 sürümünü 1.0.10 yapar, commit oluşturur ve v1.0.10 tag'ini ekler.

(başa dön)

---

🎮 Kullanım

1. Uygulamayı başlatın:

   npm start

2. Ana ekrandaki URL kutusuna işlemek istediğiniz YouTube video bağlantısını yapıştırın.
3. Editör ekranında:
   • Timeline: Videoyu izleyin ve kesmek istediğiniz başlangıç/bitiş noktalarını belirleyin.
   • Ayarlar Paneli (Sağ Taraf):
     • Mod: Sadece Video, Sadece Ses veya İkisi Bir Arada.
     • Kalite: 144p'den 8K'ya kadar seçim yapın.
     • Codec: H.264 (Hızlı), HEVC (Verimli) veya Copy (Kayıpsız/Hızlı).
4. "Dışa Aktar" butonuna basın ve işlemin tamamlanmasını bekleyin.

(başa dön)

---

🛡️ Güvenlik Yamaları

Uygulama güvenliği en üst düzeyde tutulmuş ve bilinen kritik Node.js modül zafiyetlerine karşı 2026 itibarıyla manuel yamalar uygulanmıştır:

• ✅ SSRF Koruması: Dahili proxy sunucusu, yerel ağ saldırılarını (localhost, 192.168.x.x vb.) engeller.
• ✅ Prototype Pollution: lodash ve js-yaml kütüphanelerindeki prototip kirliliği açıkları kapatıldı.
• ✅ Zip/Tar Traversal: node-tar modülü sembolik bağlantı saldırılarına karşı sertleştirildi.
• ✅ DoS Koruması: qs modülündeki bellek taşırma (memory exhaustion) açığı giderildi.

(başa dön)

---

📜 Lisans

Bu proje Apache License 2.0 altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakınız.

(başa dön)