SubLens
Ekranın istediğin bölümündeki altyazı ve diyalogları okur, çevirisini anında oyunun üstünde gösterir. Windows 10/11.
English: README.md
İndirme
Releases sayfasından SubLens.exe dosyasını indirip çalıştır. Kurulum gerekmez.
Exe, PyInstaller ile derlenmiştir ve kod imzası yoktur. Bu yüzden Windows SmartScreen ya da bazı antivirüs motorları uyarı verebilir. İstersen kaynak koddan da çalıştırabilirsin.
Hızlı başlangıç
- F2'ye bas ve oyundaki altyazının etrafına kutu çiz. İki satırlık altyazılarda iki satırı da kapsa.
- Dilleri ve çevirmeni seç. Google Translate kurulum gerektirmez.
- F4'e bas ve oyuna geç.
Metin kötü okunuyorsa ekranda altyazı varken Otomatik ayarla düğmesine bas.
SubLens metni Windows OCR ile okur, bu yüzden kaynak dilin OCR paketi kurulu olmalıdır. Paket eksikse uygulama bunu söyler ve kurulum komutunu verir.
Özellikler
Okuma
- Windows 10/11'de yerleşik Windows OCR kullanılır. Ayrı bir OCR programı gerekmez.
- Üç metin stili vardır: Otomatik, Parlak altyazı ve Diyalog kutusu. Otomatik ayarla en iyi okuma ayarlarını kendisi seçer.
- Alt alta gelen satırlar tek cümle olarak birleştirilir, her konuşmacı etiketi yeni paragraf başlatır.
- Tuş ikonları, semboller ve küçük arayüz ipuçları ayıklanır.
- Yarı saydamken bozuk okunan metin, okunaklı hale gelene kadar bekletilir. Bozuk okuma çevrildiyse temiz okuma onun yerine geçer.
- Bozuk konuşmacı etiketleri düzeltilir ("eter:" ya da "Peter." → "Peter:").
- Kayan altyazılar (YouTube, yayınlar) tek akış olarak izlenir, böylece satırlar iki kez çevrilmez.
Çeviri
| Motor | Kurulum | Not |
|---|---|---|
| Google Translate | Yok | Ücretsiz ama gayri resmi uç nokta olduğu için sınırlanabilir |
| DeepL | API anahtarı (ücretsiz planı var) | Önceki satırları bağlam olarak kullanır |
| AI (OpenAI uyumlu) | LM Studio ya da Ollama (yerel) veya OpenAI, OpenRouter, Groq anahtarı | Konuşma bağlamını, oyun bağlamını ve sözlüğü kullanır |
| Claude | Anthropic API anahtarı | Bağlam özellikleri yukarıdakiyle aynı |
| Gemini | Google AI Studio anahtarı | Bağlam özellikleri yukarıdakiyle aynı |
- AI motorlarına önceki satırlar çevirileriyle birlikte gider, bu yüzden kısa cevaplar doğru çevrilir: "Bunu denemelisin." cümlesinden sonra gelen "Neyi?", "What?" değil "Try what?" olur.
- Sözlük: adları çevirmeden bırakabilir ya da belirli bir karşılığı zorlayabilirsin.
- Oyun profilleri: alan, dil, okuma ayarları, bağlam ve sözlük oyun bazında saklanır. Oyunun exe'sine bağlanırsa kendiliğinden yüklenir.
Çeviri katmanı ve uygulama
- Altyazıya göre boyutlanan, sürüklenebilir bir katman. Ekran yakalamaya görünmez, bu yüzden kendi çevirisini tekrar okumaz.
- Yazı boyutu, saydamlık, konum ve tıklamaların oyuna geçmesi ayarları.
- Türkçe ve İngilizce arayüz.
- Global kısayollar, oyun öne çıkmadığında otomatik duraklama ve kapatılabilir bildirimli sistem tepsisi simgesi.
Kısayollar
| Tuş | Global alternatif | İşlev |
|---|---|---|
| F2 | Ctrl+Alt+R | Alan seç |
| F3 | Ctrl+Alt+T | Tek seferlik çeviri |
| F4 | Ctrl+Alt+G | Başlat / durdur |
| Esc | Ctrl+Alt+H | Çeviri katmanını gizle |
Global kısayollar tam ekran oyunlarda da çalışır. Oyun yönetici olarak çalışıyorsa SubLens'i de yönetici olarak aç. Kısayollar henüz değiştirilemiyor. Klavyende F tuşları yoksa Ctrl+Alt kısayollarını ya da penceredeki düğmeleri kullan.
Kaynak koddan çalıştırma
Python 3.13 ile test edildi.
git clone https://github.com/bnsware/SubLens.git
cd SubLens
sublens.batsublens.bat sanal ortamı oluşturur, bağımlılıkları kurar ve uygulamayı başlatır. Elle yapmak için:
pip install -r requirements.txt
python main.pyTestleri python -m unittest discover tests ile çalıştırabilirsin.
Exe derleme
sublens_exe.batSonuç dist\SubLens.exe dosyasıdır.
Sorun giderme
| Belirti | Çözüm |
|---|---|
| "Windows OCR'da '…' dil paketi yok" | Windows Ayarları > Saat ve dil > Dil > dili ekle ("Optik karakter tanıma" işaretli olsun). |
| "Metin … gibi görünmüyor" | Kaynak dil yanlış seçilmiş. |
| Metin bozuk okunuyor | Altyazı ekrandayken Otomatik ayarla'yı kullan. Olmazsa Parlak altyazı'yı dene ve alanı altyazıya göre daralt. |
| Konuşmacı adının ilk harfleri eksik | Alan adı kesiyor. Alanı soldan biraz genişlet. |
| Çeviri gecikiyor | Google ve DeepL yerel modellerden hızlıdır. |
| Kısayollar oyunda çalışmıyor | SubLens'i yönetici olarak çalıştır. |
| Çeviri katmanı sürüklenmiyor | Ayarlar > Çeviri katmanı bölümünden tıklamaların oyuna geçmesini kapat. |
Ayarlar %APPDATA%\SubLens\config.json dosyasında tutulur. Sıfırlamak için dosyayı silmen yeterli. v1 ayarları otomatik taşınır.
Proje düzeni
SubLens/
├── main.py Giriş noktası
├── sublens/
│ ├── ocr.py Windows OCR ve görüntü filtreleri
│ ├── textproc.py İkon filtresi, satır birleştirme, konuşmacı etiketleri, sözlük
│ ├── pipeline.py Tarama ve çeviri thread'leri
│ ├── engines/ Çeviri motorları
│ └── ui/ Arayüz
├── tests/
├── _build.py PyInstaller derlemesi
├── sublens.bat Kaynak koddan çalıştırma
├── sublens_exe.bat Exe derleme
└── READMEapp*.md Uygulama içi yardım
İlk tek dosyalık sürüm 1.0 etiketinde duruyor.
Lisans
Yeni rehberler ve doküman güncellemeleri
Yeni rehberler, sürüm notları ve ipuçları bültenle gelsin. Ayda birkaç e-posta.
- Yeni araçlar ve projeler herkesten önce
- Abonelere özel erken erişim ve indirimler
- Ayda birkaç e-posta, tek tıkla çıkış
