Transcriberen met de CLI

Met transcript1 transcribeer je rechtstreeks vanuit je terminal. Geef een link van YouTube, X, TikTok, Instagram, Facebook of Bluesky mee, of het pad naar een audio- of videobestand. De CLI werkt zelfstandig; je hoeft Node.js niet te installeren. Voor de extra platforms heb je een recente versie nodig. Hieronder lees je welke. Alle linkvormen en beperkingen staan in Bronnen en instellingen.

Voor de oorspronkelijke zes platforms heb je CLI 1.2.0 of nieuwer nodig. Versie 1.1.0 en ouder herkennen alleen YouTube-links en weigeren de andere links al op je computer. Werk de CLI bij met transcript1 update.

Voor Twitch, Dailymotion, Pinterest, LinkedIn en Snapchat is die basisversie niet genoeg: je hebt een release nodig waarin die platforms zijn toegevoegd. Oudere versies kunnen deze links lokaal weigeren.

Gebruik openbare posts. Bevat een post meerdere video’s, dan transcriberen we alleen de eerste. In Bronnen en instellingen vind je ook welke korte links werken en welke limieten gelden.

Installeer de CLI

Voer dit uit op macOS of Linux, met x64 of ARM64:

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

De CLI komt in ~/.local/bin te staan. Moet je je PATH nog aanpassen, dan laat het installatieprogramma zien hoe. Met TRANSCRIPT1_INSTALL_DIR kies je een andere installatiemap.

Je kunt ook de korte alias t1 gebruiken in plaats van transcript1. Voor zsh voegt het installatieprogramma alias transcript1='noglob transcript1' toe aan ~/.zshrc. Daardoor werken links met ? ook zonder aanhalingstekens. Wil je niet dat het je shellinstellingen aanpast, stel dan TRANSCRIPT1_NO_MODIFY_SHELL=1 in.

Gebruik je Windows x64, voer dan dit uit in PowerShell:

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

Op Windows komt de CLI in %LOCALAPPDATA%\Programs\transcript1. Het installatieprogramma maakt ook de korte alias t1.cmd en voegt de map toe aan je gebruikers-PATH. Open daarna een nieuwe terminal.

Log in op je account

Start met:

transcript1 login

De CLI opent transcript1.com in je browser. Via SSH of zonder scherm toont hij de link in je terminal. Controleer of de code op de pagina gelijk is aan die in je terminal en klik op “Approve”. De CLI wacht op je toestemming en slaat daarna een sleutel op als transcript1 CLI (<computer name>). Je vindt die terug op “API keys”.

Wil je alleen de link zien, zonder een browser te openen? Gebruik transcript1 login --no-browser.

Een bestaande sleutel plak je met transcript1 login --with-key. Je kunt de sleutel ook via stdin doorgeven: transcript1 login < key.txt.

Gebruik in CI en voor agents de omgevingsvariabele TRANSCRIPT1_API_KEY. Die gaat vóór de opgeslagen sleutel. Heeft een agent geen terminal of sleutel, dan kan die transcript1 login < /dev/null uitvoeren en je de link sturen om toegang goed te keuren.

Met transcript1 logout trek je de CLI-sleutel in en verwijder je die van je computer. Lukt het intrekken niet, dan verwijdert de CLI wel de lokale sleutel en vraagt hij je die zelf in te trekken op “API keys”. Een sleutel die je zelf hebt geplakt moet je altijd op die pagina intrekken.

Transcribeer een videolink

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

De CLI wacht totdat het transcript klaar is en schrijft de tekst naar stdout. Voortgangsmeldingen gaan naar stderr. Voor YouTube, X, TikTok, Bluesky, Dailymotion en LinkedIn gebruiken we eerst bruikbare ondertitels in de oorspronkelijke taal. Zijn die er niet, dan maken we een AI-transcriptie.

Zet links in zsh liefst tussen aanhalingstekens. Zonder die tekens splitst & je opdracht. Ook ziet zsh ? als een glob, behalve wanneer je de alias van het installatieprogramma gebruikt.

Transcribeer een eigen bestand

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

Je hoeft alleen het bestandspad mee te geven. De CLI uploadt het bestand en wacht op de tekst. Je kunt mp3, wav, m4a, flac, ogg, opus, mp4, mov, webm en mkv gebruiken, tot maximaal 2 GB (2.000.000.000 bytes).

Verwerk meerdere bestanden en links

Geef meerdere bestanden of links mee, of kies een hele map:

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

Je kunt patronen zoals recordings/*.mp3 gebruiken, ook op Windows. Geef je een map op, dan pakt de CLI de mediabestanden die direct in die map staan, op naam gesorteerd. Bij meerdere bestanden of links slaat hij standaard per bron een transcript op in ./transcripts. Met --jobs kies je hoeveel er tegelijk lopen: 1–20, standaard 2.

Wil je een lijst via stdin inlezen? Gebruik - en zet op elke regel één link of bestandspad. Op macOS of Linux kan dat zo:

transcript1 -o transcripts/ - < inputs.txt

De CLI slaat lege regels en regels met # aan het begin over. Staat exact dezelfde link of hetzelfde pad vaker in de lijst, dan verwerkt hij die maar één keer.

Bij één bestand of link kies je met -o de bestandsnaam voor het transcript. Bestaat de opgegeven map al of eindigt het pad op /, dan behandelt de CLI het als een map. Bij meerdere bestanden of links is -o altijd een map. De CLI maakt ontbrekende mappen zelf aan.

Bestaat het transcriptbestand al, dan slaat de CLI YouTube-links en lokale bestanden over. Wil je ze toch opnieuw verwerken, voeg dan --overwrite toe:

transcript1 --overwrite -o transcripts/ ./recordings

Kies een formaat en instellingen

Zo krijg je sprekerherkenning én tijdstempels:

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

Gebruik --speakers niet samen met --source captions. Bij auto kiest sprekerherkenning direct voor audio. De bestaande ondertitelverwerking van YouTube en X blijft gelijk; ook voor TikTok, Bluesky, Dailymotion en LinkedIn kun je de beschikbare ondertitels ophalen. Buiten YouTube hebben ondertitels alleen tijdstempels per segment (words: null), ook als ze automatisch zijn gegenereerd. Alle mogelijkheden en taalinstellingen vind je in Bronnen en instellingen.

Gebruik de CLI in scripts en agents

Heeft je agent een shell, dan kan die de CLI installeren en na het instellen van TRANSCRIPT1_API_KEY meteen transcript1 <link> of transcript1 <file> uitvoeren. Gebruikt je client MCP, volg dan de stappen bij MCP-server koppelen.

Met --json krijg je per verwerkt bestand of verwerkte link één JSON-regel op stdout, zodra de verwerking klaar is. Voortgang, samenvattingen en updatemeldingen laat de CLI dan weg:

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

Bij een afgeronde job bevat de JSON-regel het API-transcriptieobject met daarnaast input en reused. Slaat de CLI de tekst op in een bestand, dan staat file in de regel in plaats van transcript. Ontstaat een fout voordat er een id is, dan krijg je input en een error-object met code en message. Bij overgeslagen bestanden of links krijg je input, skipped (exists of out_of_minutes) en zo nodig file. De waarde exists komt alleen voor bij YouTube-links en lokale bestanden.

Geef je één bestand of link mee zonder -o, dan zet --json het transcript in het object en heeft -f geen effect. Bij meerdere bestanden of links zonder -o komen de transcripts in ./transcripts; elke JSON-regel bevat dan file in plaats van transcript. Wanneer de CLI een bestand schrijft, bepaalt -f het bestandsformaat. Wil je alleen voortgang en samenvattingen verbergen, maar de tekst en foutmeldingen houden? Gebruik -q of --quiet.

Je kunt de transcriptie ook starten en de tekst later ophalen:

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

Neem voor <id> de id die je na de eerste opdracht ziet. Met --no-wait toont de CLI alleen de id en status, of het object als je ook --json gebruikt. get wacht tot de job is afgerond. Je kunt daarbij -f, -o, --timestamps, --no-wait, --json en -q gebruiken.

Werk de CLI bij

transcript1 update

Als stderr naar een terminal gaat, kijkt de CLI maximaal één keer per 24 uur of er een nieuwe release is. Zo ja, dan krijg je een melding. Zet de controle uit met TRANSCRIPT1_NO_UPDATE_CHECK=1. Ook met --json en -q blijft de updatemelding weg.

Exitcodes

Alle opdrachten en flags bekijk je met transcript1 --help, of door alleen transcript1 uit te voeren.