Terminalden kullanım (CLI)

Terminalde transcript1 komutuna bir video bağlantısı veya bilgisayarınızdaki ses ya da video dosyasının yolunu verin. CLI kaydı yazıya çevirip metni getirir; Node.js kurmanız gerekmez. YouTube, X, TikTok, Instagram, Facebook ve Bluesky bağlantılarıyla çalışır. Diğer platformlar için gereken sürümleri aşağıda, bağlantı biçimlerini ve kısıtlamaları Kaynaklar ve seçenekler sayfasında bulabilirsiniz.

Sosyal medya bağlantıları için en az CLI 1.2.0 gerekir. CLI 1.1.0 ve eski sürümler yalnızca YouTube bağlantılarını tanır; diğerlerini API'ye göndermeden reddeder. Sürümünüzü transcript1 update ile güncelleyin.

Bu minimum sürüm yukarıdaki altı platform içindir. Twitch, Dailymotion, Pinterest, LinkedIn ve Snapchat kullanacaksanız ilgili platformun desteğini içeren bir CLI sürümü yükleyin. Eski sürümler bu bağlantıları API'ye ulaşmadan reddedebilir.

Sosyal medya gönderisi herkese açık olmalıdır. Gönderide birkaç video varsa yalnızca ilkini yazıya çeviririz. Kısa bağlantıların hangilerinin çalıştığını ve diğer sınırları Kaynaklar ve seçenekler sayfasından kontrol edin.

Kurulum

macOS veya Linux'ta x64 ve ARM64 için şu komutu çalıştırın:

curl -fsSL https://transcript1.com/install.sh | sh

Kurulum, çalıştırılabilir dosyayı ~/.local/bin klasörüne koyar. Klasörü PATH'e eklemeniz gerekiyorsa ne yapmanız gerektiğini terminalde gösterir. Farklı bir konum için TRANSCRIPT1_INSTALL_DIR ayarlayın.

Komutu kısaca t1 yazarak da çağırabilirsiniz. zsh kullanıyorsanız kurulum, ~/.zshrc dosyasına alias transcript1='noglob transcript1' satırını ekler. Böylece ? içeren bağlantılar tırnaksız da çalışır. Kabuk ayarlarınızın değişmesini istemiyorsanız TRANSCRIPT1_NO_MODIFY_SHELL=1 kullanın.

Windows x64 için PowerShell'de çalıştırın:

irm https://transcript1.com/install.ps1 | iex

Windows kurulumu dosyaları %LOCALAPPDATA%\Programs\transcript1 klasörüne yerleştirir. Kısa komut olarak t1.cmd ekler ve klasörü kullanıcınızın PATH değişkenine kaydeder. Komutun tanınması için yeni bir terminal açın.

Hesabınızı bağlayın

Bağlantıyı başlatın:

transcript1 login

Komut, tarayıcıda transcript1.com adresini açar. SSH üzerinden veya ekransız bir ortamda çalışıyorsanız bunun yerine açmanız gereken bağlantıyı gösterir. Terminaldeki kod ile sayfadaki kodun aynı olduğunu kontrol edip “Approve” düğmesine tıklayın. CLI onayınızı bekler, ardından transcript1 CLI (<computer name>) adlı anahtarı kaydeder. Bu anahtarı paneldeki “API keys” sayfasında görebilirsiniz.

Tarayıcının açılmasını istemiyorsanız transcript1 login --no-browser çalıştırın; bağlantıyı terminalden alın.

Elinizde API anahtarı varsa transcript1 login --with-key ile yapıştırabilirsiniz. Anahtarı standart girdiden okumak da mümkündür: transcript1 login < key.txt.

CI veya ajan kullanıyorsanız TRANSCRIPT1_API_KEY ortam değişkenini ayarlayın. Bu değer, bilgisayarda kayıtlı anahtarın önüne geçer. Etkileşimli terminali veya anahtarı olmayan bir ajan, transcript1 login < /dev/null çalıştırıp onay bağlantısını size iletebilir.

Bağlantıyı kesmek için transcript1 logout çalıştırın. Komut CLI anahtarını iptal eder ve yerel kaydını kaldırır. Anahtarı sunucuda iptal edemezse yerel kaydı yine kaldırır ve “API keys” sayfasından iptal etmenizi ister. Elle yapıştırdığınız anahtarları da o sayfadan iptal etmelisiniz.

Bir video bağlantısı gönderin

transcript1 'https://youtu.be/dQw4w9WgXcQ'

CLI transkripsiyonun bitmesini bekler ve metni stdout'a yazar. YouTube, X, TikTok, Bluesky, Dailymotion ve LinkedIn'de önce videonun kendi dilindeki kullanılabilir altyazıyı alırız. Altyazı yoksa sesi yapay zeka ile yazıya çeviririz. İlerleme bilgisi stderr'e yazıldığı için transkript metnine karışmaz.

zsh kullanırken bağlantıları tırnak içine almanız iyi olur. Tırnaksız & komutu böler. Kurulumun eklediği alias kullanılmıyorsa ? de dosya eşleştirme karakteri olarak yorumlanır.

Bilgisayarınızdaki dosyayı gönderin

transcript1 interview.mp3
transcript1 -f srt -o interview.srt interview.mp3

mp3, wav, m4a, flac, ogg, opus, mp4, mov, webm ve mkv dosyalarını yükleyebilirsiniz. Boyut limiti 2 GB'dır (2.000.000.000 bayt). CLI yüklemeyi yapar, ardından transkripsiyon tamamlanana kadar bekler.

Birden fazla kaydı birlikte işleyin

Aynı komuta birkaç dosya, bağlantı veya bir klasör yolu verebilirsiniz:

transcript1 interview.mp3 lecture.mp4
transcript1 -o transcripts/ ./recordings
transcript1 --jobs 4 -o transcripts/ interview.mp3 'https://youtu.be/dQw4w9WgXcQ'

recordings/*.mp3 gibi dosya kalıpları Windows'ta da çalışır. Klasör yolu verdiğinizde yalnızca doğrudan o klasörde bulunan medya dosyaları alınır ve ada göre sıralanır. Birden fazla kayıt işlenirken varsayılan kayıt yeri ./transcripts klasörüdür; her kayıt için ayrı dosya oluşturulur. Aynı anda kaç kayıt işleneceğini --jobs ile 1–20 arasında seçin. Varsayılan değer 2'dir.

Bağlantıları veya dosya yollarını stdin'den okumak için - verin. Her satırda tek kaynak olmalıdır. macOS veya Linux terminalinde örnek kullanım:

transcript1 -o transcripts/ - < inputs.txt

Boş satırları ve # ile başlayanları atlarız. Birebir aynı dosya yolu veya bağlantı birden fazla yazılmışsa yalnızca bir kez işlenir.

Tek kayıt gönderirken -o ile dosya adını belirtin. Verdiğiniz yol mevcut bir klasörse veya / ile bitiyorsa klasör olarak kullanılır. Birden fazla kayıtta -o her zaman klasör yoludur. Klasör yoksa CLI oluşturur.

YouTube bağlantılarında ve yerel dosyalarda, kaydedilecek transkript dosyası zaten varsa o kayıt atlanır. Baştan işlemek ve dosyanın üzerine yazmak için --overwrite ekleyin:

transcript1 --overwrite -o transcripts/ ./recordings

Formatı ve ayarları seçin

Konuşmacı ayırmayı zaman damgalarıyla birlikte açmak için:

transcript1 --speakers --timestamps --language en interview.mp3

--speakers ile --source captions birlikte çalışmaz. auto seçiliyken konuşmacı ayırmayı açarsanız altyazıları atlayıp doğrudan STT kullanırız. YouTube ve X'in altyazı desteği aynı şekilde devam eder; TikTok, Bluesky, Dailymotion ve LinkedIn'deki kullanılabilir altyazıları da alabiliriz. YouTube dışındaki altyazılarda otomatik oluşturulanlar dahil yalnızca segment zamanları bulunur (words: null). Platform farklarını ve dil seçimini Kaynaklar ve seçenekler sayfasından inceleyebilirsiniz.

Script ve ajanlardan kullanın

Terminal komutu çalıştırabilen ajanlar CLI kurabilir ve TRANSCRIPT1_API_KEY ayarladıktan sonra transcript1 <link> veya transcript1 <file> kullanabilir. İstemciniz MCP kullanıyorsa MCP sunucusu kurulumunu izleyin.

Otomasyonda --json kullanın. Her kayıt tamamlandıkça stdout'a tek satırlık JSON yazılır. İlerleme, işlem özeti ve güncelleme bildirimi gösterilmez:

transcript1 --json 'https://youtu.be/dQw4w9WgXcQ'

Tamamlanan her kaydın JSON satırında API transkripsiyon nesnesine ek olarak input ve reused bulunur. Transkript dosyaya kaydedildiyse transcript yerine file gönderilir. Henüz transkripsiyon kimliği oluşmadan hata alırsanız satırda input ile code ve message alanlarını taşıyan bir error nesnesi olur. Atlanan kayıtlarda input, skipped (exists veya out_of_minutes) ve varsa file bulunur. exists yalnızca YouTube bağlantıları ve yerel dosyalar için kullanılır.

Tek kayıt için -o vermeden --json çalıştırırsanız transkript JSON nesnesinde yer alır; -f dikkate alınmaz. Birden fazla kayıtta -o vermeseniz de transkriptler ./transcripts klasörüne yazılır. Bu durumda JSON satırları transcript yerine file içerir. Dosya yazılan her kullanımda dosyanın formatını -f belirler. Yalnızca ilerlemeyi ve işlem özetini gizlemek, metni ve hataları görmeye devam etmek için -q veya --quiet seçin.

Transkripsiyonu başlatıp beklemeden terminale dönmek, metni daha sonra almak için:

transcript1 --no-wait interview.mp3
transcript1 get <id>

<id> yerine ilk komutun verdiği kimliği koyun. --no-wait yalnızca kimliği ve durumu, --json ile kullanılırsa JSON nesnesini yazdırır. get çağrısı transkripsiyon devam ediyorsa bekler. Bu komutta -f, -o, --timestamps, --no-wait, --json ve -q kullanılabilir.

CLI sürümünü güncelleyin

transcript1 update

stderr bir terminale bağlıysa CLI, 24 saatte en fazla bir kez yeni sürüm kontrolü yapar. Yeni sürüm varsa haber verir. Kontrolü kapatmak için TRANSCRIPT1_NO_UPDATE_CHECK=1 ayarlayın. --json veya -q kullanırken de bu bildirim gösterilmez.

Çıkış kodunu kontrol edin

Tüm komut ve seçenekleri görmek için transcript1 --help çalıştırın. Yalnızca transcript1 yazmanız da yardım metnini açar.