Skip to main content

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?

  1. Herhangi bir uygulamada Türkçe metni seçin.
  2. Ctrl+Shift+Space'e basın.
  3. 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)

  1. Son sürüm sayfasından tr2en-…-windows-x64-kurulum.exe dosyasını indirip çalıştırın (~38 MB). Python ve yönetici izni gerekmez.
  2. 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.
  3. 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 .sha256 dosyası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ıp tr2en.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

PyPI'den, 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)

  1. https://aistudio.google.com/apikey adresinde Create API key ile anahtar oluşturun ve kopyalayın.
  2. 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')
  1. 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_degiskeni alanına anahtarın kendisini değil, kaydettiğiniz ortam değişkeninin adını yazın (yukarıdaki PowerShell komutunda GEMINI_API_KEY yerine o adı kullanın).
  • Ollama'da düşünen modeller (qwen3 ailesi) için uyumlu_dusunmeyi_kapat = true yapı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 servisler https:// 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.

Kısayol tuşu programa gitmez: metin seçiliyse tr2en çevirir; seçim yoksa tuşu programa geri gönderir (ör. kısayolunuz Ctrl+P ise, seçim yokken programın kendi Ctrl+P işi yine çalışır). tr2en duraklatıldığında ve terminalde tuş olduğu gibi programa gider.

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.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tr2en 0.1.5
File Size Uploaded Provenance Actions
tr2en-0.1.5.tar.gz 199.5 kB With provenance Details for tr2en-0.1.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tr2en 0.1.5
File Interpreter ABI Platform Actions
tr2en-0.1.5-py3-none-any.whl Python 3 none any Details for tr2en-0.1.5-py3-none-any.whl

Total release size: 266.8 kB

Release files / tr2en-0.1.5.tar.gz

Download URL tr2en-0.1.5.tar.gz
Size 199.5 kB
Tags Source
SHA-256 checksum
How to use checksums
3bf09dc72a38c0e155ca295d2fd781f47a8264990b9992e13030fcc8b0038ef3
BLAKE2b-256 checksum
How to use checksums
517c25a51fd8df5a1439aa6d3d5dae99e085dea62fe13d25d229384d42adedd0
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 log

Release files / tr2en-0.1.5-py3-none-any.whl

Download URL tr2en-0.1.5-py3-none-any.whl
Size 67.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2b9fa36616b7a7e2c3cfc4e9f5323020b6b9c68954e3373ecb920725b36e9886
BLAKE2b-256 checksum
How to use checksums
9d45102b9ac142d3020c72a98e39b4edada9bdce10eb8cc3393b4c92ae3002d8
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 log

Security for tr2en 0.1.5

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.

Select from 2 files

Attestation for tr2en-0.1.5.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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page