# Terminalden kullanım (CLI) > Video bağlantılarını ve dosyaları terminalden yazıya çevirin. Klasörleri toplu işleyin, altyazıları kaydedin; script ve ajanlar için JSON alın. Canonical: https://transcript1.com/tr/docs/cli Language: tr Last updated: 2026-10-18 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](https://transcript1.com/tr/docs/sources-and-options) 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](https://transcript1.com/tr/docs/sources-and-options) sayfasından kontrol edin. ## Kurulum macOS veya Linux'ta x64 ve ARM64 için şu komutu çalıştırın: ```bash 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: ```powershell 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: ```bash 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 ()` adlı anahtarı kaydeder. Bu anahtarı paneldeki [“API keys” sayfasında](https://transcript1.com/dashboard/account/tokens) 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 ```bash 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 ```bash 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: ```bash 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: ```bash 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: ```bash transcript1 --overwrite -o transcripts/ ./recordings ``` ## Formatı ve ayarları seçin | Seçenek | Ne yapar? | |---|---| | `-f`, `--format` | Transkripti `text` (varsayılan), `srt`, `vtt` veya `json` olarak alın. `json`, API'nin transkripsiyon nesnesini verir. | | `--speakers` | Konuşmacı ayırmayı açar; metne Speaker 1, Speaker 2 gibi etiketler ekler. | | `--timestamps` | Metinde her satırı `[hh:mm:ss]` ile başlatır. Diğer formatlarda kullanılamaz. | | `--language` | Dili bir ISO 639-1 koduyla belirtin veya varsayılan `auto` ile otomatik algılatın. | | `--source` | Varsayılan `auto` veya doğrudan ses için `stt` seçin. YouTube, X, TikTok, Bluesky, Dailymotion ve LinkedIn'de kullanılabilir altyazı varsa `captions` da seçilebilir. `captions` (yalnızca altyazı) modunda ses indirilmez ve STT'ye geçilmez. | | `--fresh` | Bağlantı için son 24 saatte oluşturulmuş transkripsiyonu yeniden kullanmak yerine yeni işlem başlatır. | Konuşmacı ayırmayı zaman damgalarıyla birlikte açmak için: ```bash 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](https://transcript1.com/tr/docs/sources-and-options) sayfasından inceleyebilirsiniz. ## Script ve ajanlardan kullanın Terminal komutu çalıştırabilen ajanlar CLI kurabilir ve `TRANSCRIPT1_API_KEY` ayarladıktan sonra `transcript1 ` veya `transcript1 ` kullanabilir. İstemciniz MCP kullanıyorsa [MCP sunucusu kurulumunu](https://transcript1.com/tr/docs/mcp) 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: ```bash 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: ```bash transcript1 --no-wait interview.mp3 transcript1 get ``` `` 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 ```bash 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 | Kod | Açıklama | |---|---| | 0 | Tüm kayıtlar işlendi veya mevcut transkript dosyası nedeniyle atlandı. Mevcut dosya kontrolü YouTube bağlantıları ve yerel dosyalar için geçerlidir. | | 1 | En az bir kayıt işlenemedi veya dakika yetmediği için atlandı. | | 2 | Komutun kullanımında veya oturum açmada sorun var. | | 130 | İşlem kesildi. | 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.