Read this in English: English
tr2en — Türkçe → İngilizce çeviri katmanı
Yerel Türkçe İngilizce çeviri: metni seç, kısayola bas, İngilizcesi yerine gelsin. Windows için küçük bir tepsi uygulaması. Yapay zekâya (Claude, ChatGPT, Copilot…) İngilizce prompt yazmak, internetsiz çeviri ya da hızlı prompt çevirme için.
Durum: 0.1 Beta. Yeni ve erken bir sürüm; eksikler ve hatalar olabilir. Sorun görürseniz issue açın.
Ne yapar?
- Herhangi bir uygulamada Türkçe metni seçin.
- Ctrl+Shift+Space'e basın.
- Seçili metin İngilizcesiyle değişir. Panonuz (kopyaladığınız metin, resim, dosya) eski haline geri yüklenir.
Üç çevirmen seçeneği var (tepsi simgesinden değiştirilir):
| Çevirmen | Ne zaman | Gizlilik |
|---|---|---|
| Gemini (Google, kendi ücretsiz API anahtarınız) | Önerilen, en iyi kalite | Metin Google'a gider |
| Kendi modeliniz (OpenAI uyumlu her API ya da Ollama / LM Studio) | Başka bir servis ya da kendi bilgisayarınızdaki model | Servise göre; Ollama'da metin bilgisayardan çıkmaz |
| Yerel model (~230 MB, ilk açılışta bir kez iner) | Diğerleri yoksa / yanıt vermezse yedek, ya da "Yalnızca yerel" seçiliyse | Metin bilgisayardan çıkmaz |
İlk açılışta hangisini kullanmak istediğiniz sorulur.
Korumalar
- Kod, URL ve dosya yolları çeviriye girmez, aynen kalır (
src/main.py,https://…,`komut`). - Olumsuzluk kontrolü: "silme", "silmemiş", "-madan önce" gibi olumsuzluklar çeviride kaybolursa çeviri yapıştırılmaz, uyarı çıkar. (Bilinen sınır: olumsuzluğun başka kelimeye kaymasını — "yeni değil ama hızlı" → "new but not fast" — her zaman yakalayamaz.)
- Zaten İngilizce olan metin ya da cümleler olduğu gibi bırakılır.
- Yapay zekânın kesik, boş ya da "Sure, here is…" gibi açıklamalı yanıtları reddedilir; yerel modele geçilir.
- Parola yöneticilerinde (KeePass, 1Password, Bitwarden) çalışmaz.
Gizlilik
- Çevrilen metin hiçbir yere kaydedilmez. Tepsideki "Son işlemler" yalnızca saat, süre ve karakter sayısını gösterir.
- Klavye kancası yalnızca kısayolu tanımak için kullanılır; tuşlar kaydedilmez.
- Gemini seçiliyse metin Google'a gönderilir; ücretsiz katmanda Google bu metinleri ürünlerini geliştirmek için kullanabilir. Hassas metinler için "Yalnızca yerel" seçin.
- API anahtarları yalnızca istek başlığında gider, hiçbir dosyaya ya da log'a yazılmaz.
Kurulum
Kolay yol: kurulum dosyası (Windows 10/11)
- Son sürüm sayfasından
tr2en-…-windows-x64-kurulum.exedosyasını indirip çalıştırın (~38 MB). Python ve yönetici izni gerekmez. - Kurulum, Başlat menüsüne tr2en kısayolu ekler; isterseniz masaüstü kısayolu ve "Windows açılışında başlat" kutucuklarını da işaretleyin.
- Saatin yanında kırmızı/mavi TR → EN balon simgesi çıkar. Simge önce saatin yanındaki ^ (gizli simgeler) menüsünde görünebilir; sürekli görünsün isterseniz oradan görev çubuğuna sürükleyin. Uygulamayı kapattıysanız Başlat menüsünde "tr2en" yazıp yeniden açabilirsiniz.
- .exe henüz dijital imzalı değil; Windows "bilgisayarınızı korudu" (SmartScreen) uyarısı verirse Ek bilgi → Yine de çalıştır'a tıklayın. İndirdiğiniz dosyanın doğruluğunu sürümdeki
.sha256dosyasıyla kontrol edebilirsiniz. - Güncellemek için: yeni kurulum dosyasını çalıştırmanız yeterli; açıksa tr2en'i kendisi kapatır, ayarlarınız ve model korunur.
- Kaldırmak için: Ayarlar → Uygulamalar → tr2en → Kaldır. Ayarlarınızın ve indirilen modelin de silinmesini isteyip istemediğiniz sorulur.
- Kurulum istemiyorsanız (taşınabilir):
tr2en-…-windows-x64.zip'i kalıcı bir klasöre çıkarıptr2en.exe'yi çalıştırın. Güncellerken önce tepsiden Çıkış yapıp yeni zip'i aynı klasöre çıkarın.
Geliştiriciler için: uv ile
uv tool install "tr2en[uygulama,yerel]"
tr2en
(pip install "tr2en[uygulama,yerel]" da olur; Python ≥ 3.11.)
Kaynaktan çalıştırmak için: depoyu klonlayın, baslat-arkaplan.cmd (konsolsuz) ya da baslat.cmd (konsollu, hata ayıklama) dosyasını çalıştırın.
Gemini anahtarı (ücretsiz, önerilen)
- https://aistudio.google.com/apikey adresinde Create API key ile anahtar oluşturun ve kopyalayın.
- PowerShell'de aşağıdakini çalıştırın (panodaki anahtarı kullanıcı ortam değişkenine kaydeder, ekrana yazmaz):
[Environment]::SetEnvironmentVariable('GEMINI_API_KEY', (Get-Clipboard).Trim(), 'User')
- tr2en'i yeniden başlatın. Anahtar yoksa yalnızca yerel model kullanılır.
Ücretsiz katman (Kasım 2026): Gemini 3.5 Flash-Lite için dakikada 15, günde 500 istek.
Kendi modelinizi kullanın (isteğe bağlı)
Gemini önerilen seçenek, ama zorunlu değil. OpenAI uyumlu API sunan her servisi ya da bilgisayarınızdaki bir modeli bağlayabilirsiniz. ayarlar.toml'da dört satırı doldurun, sonra tepsiden Çevirmen → Kendi modelim'i seçin:
| Servis | uyumlu_adres |
uyumlu_model (örnek) |
uyumlu_anahtar_degiskeni |
|---|---|---|---|
| OpenAI | https://api.openai.com/v1 |
gpt-4o-mini |
OPENAI_API_KEY |
| OpenRouter (yüzlerce model) | https://openrouter.ai/api/v1 |
google/gemini-2.5-flash |
OPENROUTER_API_KEY |
| Groq | https://api.groq.com/openai/v1 |
llama-3.3-70b-versatile |
GROQ_API_KEY |
| DeepSeek | https://api.deepseek.com/v1 |
deepseek-chat |
DEEPSEEK_API_KEY |
| Ollama (yerel, ücretsiz) | http://localhost:11434/v1 |
qwen3.5:0.8b, llama3.2 |
(boş bırakın) |
| LM Studio (yerel) | http://localhost:1234/v1 |
yüklediğiniz model | (boş bırakın) |
uyumlu_anahtar_degiskenialanına anahtarın kendisini değil, kaydettiğiniz ortam değişkeninin adını yazın (yukarıdaki PowerShell komutundaGEMINI_API_KEYyerine o adı kullanın).- Ollama'da düşünen modeller (qwen3 ailesi) için
uyumlu_dusunmeyi_kapat = trueyapın: 0,8B'lik qwen3.5'te çeviri 22 sn'den ~1 sn'ye iniyor. - Yerel LLM'ler yavaşsa
uyumlu_zaman_asimi'ni artırın (varsayılan 15 sn). - Güvenlik için
http://yalnızca kendi bilgisayarınızdaki (localhost) servislerde kabul edilir; uzak servislerhttps://olmalı. - Korumalar (kod/URL koruma, olumsuzluk kontrolü) bu seçenekte de çalışır. Küçük modeller olumsuzluğu sık kaçırır; tr2en bu durumda çeviriyi yapıştırmaz.
Ayarlar
Tepsi menüsü: etkinleştir/duraklat, çevirmen, kısayol (Ctrl+Shift+Space / Ctrl+Shift+Y ya da Kendi kısayolum…), son işlemler, son çeviriyi göster, son orijinali kopyala, Windows açılışında başlat.
Kendi kısayolum…: seçince 10 saniye içinde istediğiniz birleşime basın (ör. Ctrl+Shift+K; Esc vazgeçer). Ctrl ya da Alt gerekir. Kabul edilmeyenler: Ctrl+C/V/X/Z/Y/A/S (tr2en kopyala-yapıştırla çalışır), Alt+F4 ve Ctrl+Alt (Türkçe klavyede AltGr ile aynıdır, ₺ @ yazar). Uyarı: kendi kısayolunuz başka bir programın kısayoluyla çakışırsa o programda o işlem ya da tr2en düzgün çalışmayabilir; tek değiştiricili kısayollar (ör. Ctrl+Q) daha sık çakışır. Bilinen çakışmalarda tr2en uyarır. Önerilen: varsayılan Ctrl+Shift+Space.
Diğer her şey %APPDATA%\tr2en\ayarlar.toml dosyasında (tepsiden "Ayarlar dosyasını aç"): zaman aşımı, Gemini modeli, kendi modeliniz, yasaklı uygulamalar, sona boşluk. Değiştirdikten sonra uygulamayı yeniden başlatın.
Ölçümler (19.11.2026, Windows 11)
| Durum | Bellek (RAM) |
|---|---|
| Boşta (kanca + tepsi, Gemini ile) | ~35–50 MB |
| Yerel model yüklü | ~300 MB (yüklenirken anlık tepe ~450 MB) |
| Çeviri | Süre |
|---|---|
| Yerel model, cümle başına | 0,1–0,6 sn |
| Gemini | genelde ~1 sn; yoğun saatlerde 4 sn'yi geçerse yerel modele düşülür |
Yerel model yalnızca gerektiğinde yüklenir; yalnızca Gemini kullanıyorsanız ~50 MB'ta kalır.
Token notu (dürüst haliyle)
Türkçe bir mesaj İngilizceye çevrilince mesajın kendisi %10–36 daha az token tutar (10 gerçek mesajla ölçüldü; o200k sayacında %10, cl100k'de %36). Ama Claude Code gibi araçlarda bir isteğin çoğu zaten İngilizce (kod, araç çıktıları, sistem talimatı); kullanıcı mesajı toplamın %1'inden azdır. Yani faturanızı belirgin düşürmez. Asıl fayda: modellerin İngilizce prompt'u daha iyi anlaması — özellikle küçük ve yerel modellerde.
Antivirüs uyarısı
tr2en kısayolu yakalamak için klavye kancası kullanır. Bazı antivirüsler bu davranışı şüpheli bulabilir. Kod açık; kanca yalnızca kısayolu tanır, hiçbir tuşu kaydetmez ya da göndermez.
Bilinen sınırlar
- Terminalde çalışmaz (Windows Terminal, cmd, PowerShell): seçili metin terminalde değiştirilemiyor. Sonraki sürümde kısayolla açılan bir yazma kutusu gelecek.
- Yerel model uzun ve dağınık metinde zayıftır ("tablo" → "painting" gibi); kritik metinde Gemini kullanın ya da sonucu kontrol edin.
- Şimdilik yalnızca Türkçe → İngilizce.
Geliştirme
uv run --extra test --extra yerel --extra uygulama pytest -q
Testler her push'ta GitHub Actions'ta Windows üzerinde çalışır. Kod üzerinde çalışan yapay zekâ ajanları için kurallar: AGENTS.md. Kod içindeki adlar Türkçedir.
Lisans
Kod MIT. İndirilen yerel model CC-BY-4.0: Helsinki-NLP/opus-mt-tc-big-tr-en modelinin CTranslate2 int8 dönüştürmesi, PolatOz/tr2en-model.
Metadata
Release files for tr2en 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tr2en-0.1.4.tar.gz | 195.1 kB | With provenance | Details for tr2en-0.1.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tr2en-0.1.4-py3-none-any.whl | Python 3 | none | any | Details for tr2en-0.1.4-py3-none-any.whl |
Total release size: 259.7 kB
Release files / tr2en-0.1.4.tar.gz
| Download URL | tr2en-0.1.4.tar.gz |
|---|---|
| Size | 195.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
257e7003eda8e0b6ebbfaaf9cd10bfd68692deb6e432496c4f61c554ac3d1347
|
|
BLAKE2b-256 checksum How to use checksums |
536a8a8f865cc1ac5dfc2424c311a716e1c15d09065699efd5fbb86cbc2e631c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.
Transparency logRelease files / tr2en-0.1.4-py3-none-any.whl
| Download URL | tr2en-0.1.4-py3-none-any.whl |
|---|---|
| Size | 64.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0373058de9643a6b56c3a7159f8265f15e6fc72133f1586400ff3d2d0efbbe6b
|
|
BLAKE2b-256 checksum How to use checksums |
2f0710e8607943904c3332e042bc4317fd5ac10d6e56d5735c995d99c6800bba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.
Transparency logSecurity for tr2en 0.1.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for tr2en-0.1.4.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.