Bazıları, altyazılar için zaten birçok yapay zeka otomatik çeviri aracı olduğunu söylüyor, peki bunun anlamı ne?
Doğru, çevrimiçi video çevirisi için birçok araç var ve ben de birçoğunu kullandım. Ancak her zaman yeterince doğru olmadıklarını veya kalitenin düşük olduğunu, hatta bazen bir sürü hata çıkardıklarını düşündüm.
Ayrıca, Twitter ve WeChat Kanallarında sık sık yurtdışı videoları paylaşıyorum, bu yüzden bu araç setini oluşturmaya karar verdim—aslında yurtdışı videolarını yerel platformlara taşımanıza yardımcı olabilir, hehe.
Bu araç setini altı aydır kullanıyorum, birçok kez ayarladım ve artık oldukça olgunlaştı. Temizledim ve herkes için açık kaynak olarak yayınladım.

Kurulduktan sonra, tek bir cümle söylemeniz yeterli: "Bu bağlantıyı Çince altyazılı bir videoya çevir," gerisini otomatik olarak halleder: indirme, yazıya dökme, çevirme, düzeltme, altyazı ekleme ve transkript oluşturma—tam bir paket.
Yazıya dökme işlemi tamamen kendi bilgisayarınızda çalışır ve hiçbir API ücreti ödemezsiniz. Çeviri, zaten kurulu olan yapay zekanızı kullanır. Sadece İngilizce değil; Japonca, Korece, Fransızca ve diğer yabancı dil videoları da Çince altyazıya dönüştürülebilir.
Temelde, sadece birkaç betik ve bir kılavuzdan ibaret. Claude Code'a bağlı değil—OpenClaw, Gemini ve Codex de kullanabilir; tek fark, her aracın "becerileri" yükleme şeklidir.
Aşağıda, kurulum ve ilk videonuzu çalıştırma adımları yer almaktadır.
Bu şey tam olarak ne yapabilir?
Bir video bağlantısı (YouTube, Bilibili, Douyin hepsi çalışır) veya yerel bir video dosyası verin, bu beş adımı tek seferde tamamlayacaktır:
İndir → Yazıya Dök → Çevir → Düzelt → Altyazı Ekle
...ve son olarak bir transkript çıktısı verir.

Detaylandırmak gerekirse:
- Videoyu indir (veya doğrudan yerel bir dosya kullan).
- Sesi çıkar ve hassas zaman damgalarıyla orijinal altyazılara dönüştürmek için Whisper kullan.
- Orijinal metni Çince'ye çevir ve Çince izleme alışkanlıklarına uygun altyazılar haline getir.
- Altyazıları videoya ekleyerek Çince altyazılı bir video çıktısı ver.
- Aynı anda, kolay arşivleme veya makaleye dönüştürme için bir Markdown transkripti oluştur.
Dil fark etmez. İngilizce, Japonca, Korece, Fransızca, İspanyolca—Whisper anlayabildiği sürece Çince altyazıya dönüştürülebilir. Kaynak dili otomatik olarak tanır ve çevirir. Çince videolar için sadece yazıya döker ve transkript oluşturur, çeviri adımını atlar.
İki altyazı seçeneği vardır. Biri temiz bir ekran için sadece Çince. Diğeri ise iki dilli (Çince/İngilizce), büyük Çince metin ve küçük İngilizce metin ile, dinleme pratiği yapmak isteyenler için idealdir.
Herhangi bir komut hatırlamanıza gerek yok. Sadece sade dil kullanın: "İki dilli altyazı istiyorum," "Filigran yok," "Hızlı mod kullan"—hepsini anlar.
Basitçe söylemek gerekirse, dört veya beş yazılım ve bir veya iki saatlik iş gerektiren bir süreci tek bir cümleye sıkıştırır.
Mevcut araçlardan farkı nedir?
Piyasada birçok altyazı aracı var. Ben üç şeyi önemsiyorum ve bu araç özellikle bunlar için oluşturuldu.
Birincisi: Yerel, ücretsiz ve çevrimdışı. Yazıya dökme, OpenAI'nin açık kaynak Whisper modelini kullanır. Apple Silicon Mac'lerde otomatik olarak GPU hızlandırmasını kullanır. Tüm yazıya dökme işlemi bilgisayarınızda gerçekleşir—yükleme yok, ücret yok. Çeviri, zaten sahip olduğunuz yapay zekayı yeniden kullanır, bu nedenle ayrı bir çeviri API'sine gerek yoktur.
İkincisi: Hassas zaman damgaları. Birçok araçta altyazılar konuşmacının önüne geçer veya cümleleri garip bir şekilde keser. Bu araç, her kelimenin söylendiği ana kadar hassas zaman damgaları alır ve "cümle + nefes durağı"na göre keser, böylece altyazılar konuşmacı düşüncesini tam olarak bitirdiğinde değişir.
Üçüncüsü: İnsanlar için altyazılar, sadece ham makine çevirisi değil. Yanlış duyulan özel isimleri otomatik olarak düzeltir (Claude genellikle "cloud" olarak duyulur, MCP "NCP" olarak), cümleleri anlamsal olarak böler, satırları on iki karakterin altında tutar ve teknik terimler için İngilizce'yi korur. İki dilli modda, Çince büyük ve İngilizce küçüktür, aynı boyutta iki satırın üst üste binmesi yerine net bir şekilde ayrılır.
Bunlar, yüzlerce video üzerinde geliştirdiğim ve hepsi kurallara dahil edilmiş detaylardır.
Sonuçlar neye benziyor
a16z tarafından yakın zamanda yayınlanan, eski OpenAI CTO'su Mira Murati ile yapılan bir röportajı deneyelim. Araçtan iki dilli altyazı istedim.
Orijinal sözlerinde bir metafor vardı:
Bu daha çok, her iki kişinin de pedal çevirdiği bir tandem bisiklet gibi.
Makine çevirisi size hantal, kelimesi kelimesine bir çeviri verebilir. Bu araç bunu şu şekilde çevirir: "Bu daha çok, her iki kişinin de birlikte pedal çevirdiği iki kişilik bir bisiklet gibi."
Doğal ve akıcı. Özel isimler de iyi işlenir; "Thinking Machines" gibi şirket isimleri, zorla çevrilmek yerine İngilizce olarak bırakılır.

Sadece "Link + Bu videoyu çevir" gönderirsiniz, önce saf Çince mi yoksa iki dilli mi istediğinizi sorar—genelde Çince'ye çevirdiğim için bu iki seçeneği varsayılan olarak bıraktım, ancak aslında herhangi bir dile çevirebilir.

Altyazılı videoya ek olarak, orijinal ve Çince metnin yan yana olduğu bir transkript de oluşturur.

Tam paragraf şöyle görünür:
Bu daha çok, kendi başına kaçıp medeniyeti geride bırakmayan, ancak her iki kişinin de pedal çevirdiği bir tandem bisiklet gibi bir sistem inşa etmek gibidir. Yokuş yukarıda, belki daha güçlü olan kişi daha sert pedal çevirir, ancak her iki kişinin de elleri gidonlardadır.
En pratik kısmı, dil bağımsız olmasıdır. Aynı röportaj, Çince, Japonca, Korece, Arapça veya Fransızca için iki dilli altyazılara çevrilebilir—çeviri üstte ve İngilizce altta, net bir şekilde önceliklendirilmiş olarak. Sağdan sola Arapça bile düzgün bir şekilde hizalanır:

On dakikalık videolar sorun değil ve bir buçuk saatin üzerindeki uzun videolar da kolayca işlenir.
Aslında üç beceridir
Depoyu açtığınızda, her biri işin bir bölümünü yöneten üç klasör göreceksiniz. Ayrı ayrı veya birbirine bağlı olarak kullanılabilirler:
- xiaohu-video-md: Komutan. İndirme, yazıya dökme, çeviri çağırma, altyazı ekleme ve transkript çıktısı vermekten sorumludur.
- xiaohu-subtitle-polish: Altyazı çevirisi ve düzeltmesinde uzmanlaşmıştır. Hata düzeltme, çeviri, cümle bölme, zaman hizalama ve iki dilli biçimlendirmeyi yönetir.
- xiaohu-video-download: Saf bir indirme aracıdır. Videoları, sesi veya tüm oynatma listelerini indirir ve ayrıca yerel videolara altyazı ekleyebilir.

Bir videoyu çevirirken, xiaohu-video-md orkestratördür ve çeviri adımı için xiaohu-subtitle-polish'i çağırır. Bununla uğraşmanıza gerek yok; sadece bu üç parçanın var olduğunu bilin.
Adım Adım Kurulum
Bu araç şu anda Mac için optimize edilmiş olup, Apple Silicon'da en sorunsuz şekilde çalışır. Kurmanın iki yolu vardır: kolay yolu istiyorsanız, aşağıdaki metni yapay zekanıza yapıştırmanız yeterli; neler olduğunu bilmek veya hatalardan korkuyorsanız, manuel adımları izleyin.
Tembel Sürüm: Bunu yapay zekanıza verin
Yapay zeka kodlama aracınızı (Claude Code, Codex, OpenClaw) açın ve aşağıdakini aynen kopyalayıp yapıştırın. Sisteminizi belirleyecek, bağımlılıkları yükleyecek, depoyu klonlayacak ve kurulum betiğini çalıştıracak, gerektiğinde size sorular soracaktır:
Bu video çeviri aracını kurmama yardım et: https://github.com/xiaohuailabs/xiaohu-video-translate Bu sırayı takip et: 1. Sistemimi kontrol et: Mac veya Windows; Mac ise Apple Silicon (M serisi) olup olmadığını kontrol et. 2. Bağımlılıkları yükle: yt-dlp, ffmpeg, whisper-cpp (Mac için brew install kullan, Windows için WSL veya winget). Yazıya dökme motoru: Apple Silicon için mlx-whisper, diğerleri için faster-whisper kur. 3. Bu depoyu git clone ile klonla, dizine gir ve bash install.sh çalıştırarak üç beceriyi beceri dizinime yükle. 4. Kurulduktan sonra, xiaohu-video-md becerisindeki config.json'u bul (Claude Code için, ~/.claude/skills/ konumundadır). Bitmiş ürünleri nereye kaydetmek istediğimi sor ve output_dir'i tam yola değiştirmeme yardım et. 5. Son olarak, tüm bağımlılıkların kurulu olup olmadığını kontrol et ve kullanmaya başlayıp başlayamayacağımı söyle.
Her adımda ne yaptığını kısaca açıkla; bir bağımlılık başarısız olursa, dur ve bana sor, sadece devam etme.
Temelde aşağıdaki üç adımı sizin için çalıştırır. Kendiniz yapmak veya sorun gidermek istiyorsanız, manuel sürümü izleyin.
Adım 1: Temel araçları yükleyin
İlk olarak, Homebrew'in kurulu olduğundan emin olun. Ardından üç aracı yüklemek için bu komutu çalıştırın:
brew install yt-dlp ffmpeg whisper-cpp
Ardından, bir yazıya dökme motoru yükleyin. Apple Silicon Mac'ler için GPU hızlandırması için bunu kullanın (--break-system-packages bayrağı yalnızca daha yeni bir sistem kısıtlamasını aşmak içindir; sisteminize zarar vermez):
pip3 install --break-system-packages mlx-whisper
Apple Silicon'da değilseniz, genel sürümü kullanın:
pip3 install --break-system-packages faster-whisper

Adım 2: Becerileri Claude'a yükleyin
Depoyu klonlayın ve kurulum betiğini çalıştırın:
git clone https://github.com/xiaohuailabs/xiaohu-video-translate.git cd xiaohu-video-translate bash install.sh
Bu betik, üç beceriyi Claude'un beceri dizinine kopyalar, yapılandırma dosyalarını oluşturur ve bağımlılıkları kontrol eder. Her şey [OK] gösteriyorsa, hazırsınız. Bir şey [Missing] gösteriyorsa, düzeltmek için istemleri izleyin. (Buradaki yollar örnek olarak Claude Code'u kullanır; diğer araçlar için dizini değiştirmeniz yeterlidir).

Adım 3: Sonuçları nereye koyacağını söyleyin
~/.claude/skills/xiaohu-video-md/config.json dosyasını açın ve output_dir'i istediğiniz klasör yoluna değiştirin (örneğin, /Users/kullaniciadiniz/Documents/VideoTranslation).
Geçici dosyalar tmp/ klasörüne, transkriptler data/ klasörüne gider ve bitmiş videolar varsayılan olarak İndirilenler klasörünüze gider.
Yazıya dökme modelini manuel olarak indirmenize gerek yok. İlk çalıştırdığınızda,
mlx-whisperonu indirecek (yaklaşık 1,5 GB) ve daha sonra tekrar kullanacaktır.
İşlem tamamlandığında, yapay zeka aracınızı yeniden başlatın ve kullanıma hazırsınız.

Windows Kullanıcıları Buraya Baksın
Yukarıdakiler Mac içindir. Windows da çalıştırabilir, ancak birkaç fark vardır:
En kolay yol WSL (Windows Subsystem for Linux) kullanmaktır. Kurulduktan sonra, bunları yükleyin ve betik olduğu gibi çalışacaktır:
sudo apt install ffmpeg pip3 install yt-dlp faster-whisper
WSL kullanmak istemiyorsanız:
- Motor olarak faster-whisper kullanın.
- Kurulum betiğini Git Bash kullanarak çalıştırın veya klasörleri manuel olarak kopyalayın.
- Altyazı yazı tipini değiştirin. Varsayılan, Mac'in PingFang SC'sidir. Metnin kutular olarak görünmesini önlemek için komutlarda Microsoft YaHei olarak değiştirin.

Nasıl kullanılır
Kurulduktan sonra, tek bir cümle yeterlidir. Şunun gibi şeyler söyleyebilirsiniz:
- "Bu bağlantıyı Çince altyazılı bir videoya çevir + [Link]"
- "Bu videoyu çevir, iki dilli altyazı istiyorum + [Link]"
- "Bu videoyu metne dönüştür + [Link]" (Sadece Markdown oluşturur)
- "Bu yerel videoya Çince altyazı ekle + [Yol]"
- "Bu videoyu indir + [Link]"
- "Yazıya dökme için hızlı mod kullan"
- "Çevirirken filigran yok"
Dikkat edilmesi gereken birkaç tuzak
YouTube bazen indirme başarısız olur (403 hatası). YouTube'un risk kontrolü sıkılaştı. Betik, yeniden denemek için tarayıcınızdan çerezleri okumaya çalışır. Hala başarısız olursa, bir proxy kullanın.
Altyazılar kutular olarak görünür. Bu bir yazı tipi indeksleme sorunudur. Sisteminizde bulunan bir yazı tipi kullandığınızdan emin olun (Mac'te PingFang SC gibi).
Douyin, tek seferlik bir giriş gerektirir. douyin_login.py betiğini çalıştırın ve QR kodunu tarayın. Bu giriş bilgileri yalnızca bilgisayarınızda kalır.
Al ve kullan
Depo adresi:
github.com/xiaohuailabs/xiaohu-video-translate
Kod MIT lisanslıdır. Filigranları, stilleri veya yazı tipi boyutlarını değiştirmekte özgürsünüz. Sadece bir hatırlatma: yapılandırma dosyalarınızı veya Douyin giriş bilgilerinizi herkese açık depolara yüklemeyin.
Bu, her gün kullandığım bir araç, bir oyuncak değil. İşinize yararsa, yıldız verin. Sorun yaşarsanız, bir sorun bildirimi açın.
Bir dahaki sefere, makale illüstrasyon becerimin kaynak kodunu açacağım—kişisel bir IP görseli kullanarak makaleler için illüstrasyonlar oluşturmak, bu yazıdakiler gibi.





