Destek

Uzantıyla ilgili sık sorulan sorular ve yaygın sorunların çözümü. Çözüm bulamazsanız aşağıdaki iletişim kanallarından ulaşabilirsiniz.

Sık sorulan sorular

Uzantı ücretli mi?

Hayır, uzantının kendisi tamamen ücretsiz ve MIT lisansı ile açık kaynaktır. Ancak uzantının kullandığı OpenAI API ücretlidir; kendi OpenAI hesabınızın bakiyesinden düşer.

API anahtarımı nereden alırım?

platform.openai.com/api-keys adresinden "Create new secret key" ile oluşturabilirsiniz. Anahtar sk- ile başlar. Uzantı popup'ına yapıştırdığınızda otomatik kaydedilir ve yerel olarak saklanır.

Otomatik üretilen (ASR) altyazılar çevriliyor mu?

Evet. Hem yükleyenin eklediği manuel altyazılar hem de YouTube'un otomatik speech-to-text ile oluşturduğu ASR altyazıları çevrilir. ASR altyazıları genelde daha parçalı ve bazen hatalı olabildiği için çeviri kalitesi de kaynak metnin kalitesine bağlıdır.

Shorts videolarında çalışıyor mu?

Evet. /watch, /shorts/, /embed/ ve /live/ tüm YouTube sayfa formlarında çalışır. Ancak çok kısa Shorts videolarında ilk çeviri tamamlanmadan video bitebilir; önbellek sayesinde tekrar izlediğinizde çeviri anında gelir.

Neden YouTube'un kendi altyazı butonuna tıklanıyor gibi görünüyor?

YouTube, uzantı kaynaklı altyazı isteklerine bazen boş yanıt verir. Güvenilir çözüm, YouTube'un kendi altyazı pipeline'ını başlatıp yanıtı intercept etmektir. Bu nedenle uzantı, sizin adınıza CC butonuna tıklar ve ardından YouTube'un kendi altyazı indirme isteğinin yanıtını dinler. Bu yöntem Language Reactor ve benzeri uzantıların kullandığı standart bir tekniktir.

API anahtarım güvende mi?

Anahtar chrome.storage.local üzerinde yerel olarak tutulur ve chrome.storage.sync'e yazılmaz. Content script'lere anahtar iletilmez; yalnızca hasApiKey: boolean sinyali paylaşılır. Yalnızca çeviri isteği sırasında api.openai.com adresine iletilir.

Hangi Chrome sürümü gerekli?

Chrome 116 veya üzeri önerilir. Manifest V3 Service Worker uyumluluğu için gerekli.

Programlama terimleri de çevriliyor mu?

Sistem prompt'unda bazı terimler (Laravel, React, Vue, controller, middleware, API, endpoint vb.) orijinal İngilizce hâlinde bırakılacak şekilde tanımlanmıştır. YouTube içeriği çeşitli konularda olduğundan daha genel bir çeviri mantığı uygulanır.

Yaygın sorunlar ve çözümleri

Altyazı görünmüyor

1. Uzantı simgesine tıklayıp API anahtarının dolu olduğunu doğrulayın.
2. Popup'taki aç/kapat düğmesinin açık olduğunu kontrol edin.
3. Videonun İngilizce altyazısı olduğundan emin olun (YouTube'un kendi CC butonunda seçilebilen diller).
4. Sayfayı yenileyin; bazı SPA geçişlerinde yenileme sorunu çözebilir.
5. Video bir /shorts/ URL'si ise kısa formatta altyazı olmayabilir.

"Boş altyazı yanıtı" sorunu

YouTube bazı videolara sunucu tarafı filtre uyguluyor. Uzantı 4 katmanlı fallback zinciri ile bunu çözmeye çalışır:

1. Intercept cache (aynı video için önceden yakalanan yanıt)
2. Canlı intercept (YouTube'un kendi fetch'ini yakala)
3. Farklı fmt'lerle (srv3, json3, vtt) yeniden deneme
4. InnerTube fresh player response (ANDROID, IOS, WEB client fallback'i)
5. Son çare: video.textTracks API

Bu zincir başarısız olursa sorunu hata bildirimi olarak açın.

"Geçersiz API key" hatası

API anahtarının sk- ile başladığını, tamamının yapıştırıldığını ve OpenAI hesabınızın aktif olduğunu doğrulayın. platform.openai.com/api-keys adresinden yeni anahtar oluşturarak deneyin.

"OpenAI kota aşıldı" hatası

OpenAI hesabınızın bakiyesi bitmiş olabilir. platform.openai.com/usage adresinden kullanımınızı kontrol edin, billing sayfasından bakiye yükleyin.

SPA geçişte çeviri durdu

Uzantı YouTube'un yt-navigate-finish eventlerini ve URL değişikliklerini takip eder. Nadir durumda kaçırılabilir. Sayfayı yenilemek çoğu zaman çözer. Tekrarlayan durumda hata bildirin.

Programatik CC tıklaması fark ediliyor mu?

Uzantı, YouTube'un kendi altyazı butonuna bir kez click at'ar. Kullanıcı arayüzü bu durumda CC'nin etkin olduğunu gösterir; bu normal davranıştır. Butonu tekrar manuel kapatırsanız uzantı intercept yapamayacağı için çeviri durur.

Hata bildirimi

Bir hatayla karşılaştıysanız GitHub Issues üzerinden bildirmek en hızlı yoldur. Şunları ekleyin:

• Chrome sürümü (chrome://version)
• Uzantı sürümü (popup alt bölümü veya chrome://extensions)
• Hatanın yaşandığı video URL'si (mümkünse herkese açık bir video)
• Altyazı türü (manuel mi, otomatik üretilen mi?)
• Adım adım tekrar etme yöntemi
• Beklenen davranış / gerçek davranış
• Chrome DevTools konsol çıktısı (varsa)

İletişim

• GitHub Issues: github.com/erhanurgun/youtube-translator/issues
• E-posta: [email protected]
• Web: icin.tr/me

Güvenlik açığı bildirimi için doğrudan e-posta kullanın; halka açık issue açmayın.