Skip to content

efeyazgi/LexiSub

Repository files navigation

🌐 LexiSub — Altyazı Çevirisi

Udemy ve Coursera altyazılarını gerçek zamanlı çevir, kelime öğren, dil becerilerini geliştir.

Chrome Extension Manifest V3 DeepL API License

LexiSub Logo

✨ Özellikler

🔄 Gerçek Zamanlı Altyazı Çevirisi

  • Udemy ve Coursera video altyazılarını DeepL, Google Translate veya MyMemory ile anında çevir
  • 29+ dil desteği (İngilizce, Almanca, Fransızca, İspanyolca, Japonca…)
  • Kaynak dili otomatik algılama veya manuel seçim
  • Akıllı ve dil-bazlı önbellekleme ile API kullanımını optimize et
  • Kesintisiz deneyim için otomatik Yedek Servis (Fallback) desteği

🌍 Çift Dil Modu

  • Orijinal ve çeviri altyazıyı aynı anda görüntüle
  • Orijinal metnin boyut, renk ve arka planını bağımsız özelleştir
  • Dil öğrenirken bağlamı kaybetme

🖱️ Kelime Tıklama Çevirisi

  • Altyazıdaki herhangi bir kelimeye tıklayarak anında çeviri al
  • Birden fazla kelime seçerek kalıp/ifade çevirisi yap
  • Tooltip üzerinden kelimeyi tek tıkla kelime havuzuna ekle

📖 Kelime Havuzu (Vocabulary Bank)

  • Öğrenmek istediğin kelimeleri kaydet
  • Bağlam cümlesiyle birlikte sakla
  • Arama, filtreleme ve CSV dışa aktarma
  • vocab.html üzerinden tüm kelimeleri yönet

🎨 Görsel Özelleştirme

  • Yazı tipi ailesi seçimi (Inter, Roboto, Noto Sans ve dahası)
  • Yazı boyutu, renk ve arka plan ayarları
  • Arka plan opaklığı kontrolü
  • Hazır tema presetleri (Klasik, Sinematik, Minimal)
  • Altyazıyı sürükleyerek konumlandır + tek tıkla varsayılana döndür

⌨️ Klavye Kısayolları

Kısayol İşlev
Alt+T Çeviri modunu aç/kapat
Alt+S Altyazı boyutunu değiştir
Alt+D Çift dil modunu aç/kapat

🌐 Desteklenen Platformlar

Platform Durum
Udemy ✅ Tam destek
Coursera ✅ Tam destek

📸 Ekran Görüntüleri

🎬 Çeviri ve Kelime Öğrenme

Çift Dil Modu Kelime Tıklama Çevirisi
Orijinal ve çeviri altyazıyı aynı anda gör Herhangi bir kelimeye tıkla, anında çeviri al

⚙️ Popup Ayar Paneli

Tema & Metin Çeviri & Çift Dil İstatistikler & Havuz Kısayollar
Tema presetleri, font, renk ve arka plan ayarları DeepL API, dil seçimi ve çift dil modu API kullanımı, önbellek ve kelime havuzu Klavye kısayolları ve kaydetme

📖 Kelime Havuzu Sayfası

Kaydettiğin tüm kelimeleri bağlam cümlesiyle birlikte görüntüle, ara ve CSV olarak dışa aktar.


🚀 Kurulum

Chrome Web Store'dan (yakında)

Extension inceleme sürecindedir.

Manuel Kurulum (Geliştirici Modu)

  1. ⬇️ ZIP İndir — yeşil "<> Code" butonundan da indirebilirsin
  2. ZIP'i bir klasöre çıkart
  3. Chrome'da chrome://extensions adresine git
  4. Geliştirici modu'nu aç (sağ üst köşe)
  5. "Paketlenmemiş öğe yükle" butonuna tıkla
  6. Çıkarttığın lexisub klasörünü seç
  7. Uzantı simgesi araç çubuğunda görünecektir ✅
Alternatif: Git ile klonlama (geliştiriciler için)
git clone https://github.com/efeyazgi/lexisub.git

Ardından yukarıdaki 3-7 adımlarını takip edin.


⚙️ Yapılandırma

Çeviri Servisleri (Multi-Provider)

LexiSub, esnek çeviri seçenekleri sunar. İstediğiniz servisi seçebilir ve hata durumunda otomatik Yedek Servis (Fallback) özelliğini kullanabilirsiniz:

  1. Google Translate: Tamamen ücretsiz ve limitsizdir. API anahtarı gerektirmez. (Önerilen)
  2. MyMemory: Ücretsizdir (günde 5000 kelime limitli). API anahtarı gerektirmez.
  3. DeepL API: Ücretsiz DeepL hesabı gerektirir. En yüksek çeviri kalitesini sunar ancak ayda 500K karakter kotası vardır.

Çeviri Servisi Karşılaştırması

Özellik Google Translate MyMemory DeepL
Maliyet ✅ Ücretsiz (Limitsiz) ✅ Ücretsiz (5.000 kelime/gün) ✅ Ücretsiz (500.000 karakter/ay)
Kalite ⭐⭐⭐ İyi ⭐⭐⭐ İyi ⭐⭐⭐⭐⭐ Mükemmel
API Key ❌ Gerekli değil ❌ Gerekli değil ✅ Gerekli
Hız Çok hızlı Hızlı Hızlı
Önerilen Kullanım Günlük kullanım Yedek servis Profesyonel çeviriler

💡 Hangi Çeviri Servisini Seçmeliyim?

Yeni kullanıcılar için:

  • Google Translate (Önerilen)
    • Kurulum gerektirmez
    • Limitsiz kullanım
    • Yeterli çeviri kalitesi
    • Anında başlayabilirsiniz

Profesyonel içerik için:

  • DeepL API
    • En yüksek çeviri kalitesi
    • Akademik ve teknik metinler için ideal
    • Aylık 500.000 karakter ücretsiz kota
    • API anahtarı kurulumu gerekir

Yedek servis olarak:

  • MyMemory
    • Otomatik fallback (yedekleme) için
    • API kesintilerinde devreye girer
    • Günlük 5.000 kelime limiti

DeepL Kurulumu (İsteğe Bağlı):

  1. DeepL API sayfasına gidin
  2. DeepL API Free planına kaydolun
  3. Hesap ayarlarından API anahtarınızı kopyalayın
  4. LexiSub popup'ında API Key alanına yapıştırın ve "🔌 Bağlantıyı Test Et" butonuyla doğrulayın

🔒 Güvenlik ve Gizlilik

📄 Detaylı bilgi için: Gizlilik Politikamızı (Privacy Policy) okuyun.

API anahtarınız yalnızca sizin tarayıcınızda saklanır.

API Anahtarı Güvenliği

Güvenlik Katmanı Açıklama
🔐 Yerel Depolama API anahtarınız chrome.storage.sync ile yalnızca tarayıcınızda şifreli olarak saklanır. Hiçbir sunucuya gönderilmez.
🚫 Sunucu Yok LexiSub'un kendine ait bir backend sunucusu yoktur. Çeviri istekleri doğrudan tarayıcınızdan Seçtiğiniz Servise gider.
🔒 Manifest V3 Chrome'un en güncel ve güvenli eklenti mimarisi kullanılır. Service worker izolasyonu ile arka plan işlemleri korunur.
🌐 Minimum İzin Yalnızca storage, tabs, host platformları (udemy.com, coursera.org) ve çeviri sağlayıcıları (deepl.com, googleapis.com, mymemory.net) için izin kullanılır.

Detaylı veriler, izinler ve süreçler için lütfen Gizlilik Politikamızı (Privacy Policy) inceleyin.

⚠️ Önemli Uyarılar

Caution

API anahtarınızı asla kimseyle paylaşmayın!

  • Anahtarınız DeepL hesabınıza bağlıdır ve kötüye kullanılabilir
  • Başkalarının bilgisayarında LexiSub kullanacaksanız kendi anahtarınızı girmeyin
  • Şüpheli bir durumda DeepL hesap ayarlarından anahtarınızı yenileyin

Warning

API anahtarını içeren ekran görüntülerini paylaşmayın!

  • Popup'taki 👁 butonu anahtarınızı görünür yapar — ekran paylaşımında dikkat edin
  • .env veya config dosyalarına anahtarınızı yazmayın — bu bir tarayıcı eklentisidir, anahtarınız Chrome'un güvenli depolama alanında korunur

Veri Akışı

Tarayıcınız (Chrome) ──HTTPS──▶ DeepL API ──▶ Çeviri Sonucu
       ▲                                            │
       └────────────────────────────────────────────┘
              ❌ Ara sunucu YOK — Doğrudan bağlantı

🏗️ Teknik Mimari

lexisub/
├── manifest.json          # Manifest V3 yapılandırması
├── popup.html / popup.js  # Eklenti popup UI'ı ve ayar yönetimi
├── vocab.html / vocab.js  # Kelime havuzu görüntüleyici
├── logo.png               # Eklenti ikonu
└── src/
    ├── utils/             # Paylaşılan sabitler, yardımcılar, logger
    ├── background/        # Service worker (ES6 modüller) — API, önbellek, kelime havuzu
    └── content/           # İçerik scriptleri (namespace pattern) — altyazı, overlay, tooltip
Bileşen Sorumluluk
Background (Service Worker) Multi-provider API çağrıları, dil-bazlı çeviri önbelleği, kelime havuzu CRUD
Content Script Udemy ve Coursera DOM gözlemi, altyazı yakalama, overlay render, tooltip, sürükleme
Popup Kullanıcı ayarları, tema ve çeviri servisi seçimi, API durumu, kelime havuzu erişimi
Vocab Viewer Kaydedilen kelimeleri listeleme, arama, silme, CSV export

📋 Sürüm Geçmişi

v3.6.0 — Multi-Provider & Akıllı Önbellek

  • ✅ DeepL'e ek olarak Google Translate (Limitsiz/Ücretsiz) ve MyMemory servisleri eklendi
  • ✅ Servis çökmesi durumunda kesintisiz deneyim için Yedek Servis (Fallback) sistemi eklendi
  • ✅ Dil değişikliklerinde önceki dildeki çevirilerin ekranda kalmasına sebep olan "Cache Bug" düzeltildi (Cache artık dile duyarlı)
  • ✅ Gizlilik Politikası (Privacy Policy) dökümanı eklendi
  • ✅ Proje klasör yapısı düzenlendi (CSS dosyaları src/css klasörüne taşındı).

v3.5.0 — Coursera Desteği & Modüler Mimari

  • ✅ Coursera platform desteği (altyazı çevirisi, kelime tıklama, VTT prefetch)
  • ✅ Modüler mimari (ES6 modüller + namespace pattern)
  • ✅ Platform-bağımsız selector ve ID sistemi

v3.4.0 — Kelime Çevirisi & Kelime Havuzu

  • ✅ Kelimeye tıklayarak anında çeviri
  • ✅ Kalıp/ifade seçimi ve çevirisi
  • ✅ Kelime havuzu (kaydet, yönet, CSV export)
  • ✅ Altyazı konumunu sıfırlama butonu
  • ✅ Sürükleme ve tıklama çakışması düzeltildi

v3.3.0 — Font Seçimi & Word Click Altyapısı

  • ✅ Google Fonts font ailesi seçeneği
  • ✅ Kelime tıklama çevirisi altyapısı

v3.2.0 — Çoklu Dil & Tema Presetleri

  • ✅ 29+ dil desteği
  • ✅ Çift dil modu
  • ✅ Tema presetleri (Klasik, Sinematik, Minimal)
  • ✅ Klavye kısayolları

🤝 Katkıda Bulunma

  1. Bu repoyu fork'layın
  2. Feature branch oluşturun (git checkout -b feature/yeni-ozellik)
  3. Değişikliklerinizi commit'leyin (git commit -m 'Yeni özellik eklendi')
  4. Branch'inizi push'layın (git push origin feature/yeni-ozellik)
  5. Pull Request açın

📄 Lisans

Bu proje MIT Lisansı ile lisanslanmıştır.


Geliştirici: Efe YAZGI

⭐ Beğendiyseniz repo'ya yıldız vermeyi unutmayın!

About

Udemy ve Coursera Eğitim Platformları İçin Modüler Altyazı Uzantısı

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors