CLI — trascrivere dal terminale

Passa a transcript1 il link di un video o il percorso di un file audio o video: il comando lo trascrive dal terminale. Puoi usare YouTube, X, TikTok, Instagram, Facebook e Bluesky, oltre alle piattaforme indicate qui sotto. La CLI è un eseguibile autonomo e non richiede Node.js. Per i link accettati e le restrizioni, consulta Link e opzioni di trascrizione.

Per i link dei social serve almeno la versione 1.2.0. Con la 1.1.0 o una precedente puoi usare solo YouTube: la CLI rifiuta gli altri link prima di contattare l'API. Aggiornala con transcript1 update.

La 1.2.0 copre le sei piattaforme iniziali. Per Twitch, Dailymotion, Pinterest, LinkedIn e Snapchat, usa una release che includa esplicitamente queste piattaforme. Una CLI meno recente potrebbe rifiutare quei link senza inviarli all'API.

Scegli post pubblici: se contengono più video, trascriviamo soltanto il primo. Controlla i link brevi ammessi e gli altri limiti in Link e opzioni di trascrizione.

Installare la CLI

Su macOS e Linux, per x64 o ARM64, esegui:

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

Il programma di installazione salva l'eseguibile in ~/.local/bin. Se devi aggiornare il PATH, ti mostra come farlo. Per scegliere un'altra cartella, imposta TRANSCRIPT1_INSTALL_DIR.

Puoi usare anche l'alias breve t1 al posto di transcript1. Con zsh, l'installazione aggiunge alias transcript1='noglob transcript1' a ~/.zshrc per accettare i link con ? anche senza virgolette. Se non vuoi modificare la configurazione della shell, imposta TRANSCRIPT1_NO_MODIFY_SHELL=1.

Per Windows x64, lancia questo comando in PowerShell:

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

L'eseguibile finisce in %LOCALAPPDATA%\Programs\transcript1, insieme all'alias t1.cmd. L'installazione aggiunge la cartella al PATH del tuo utente. Poi apri un nuovo terminale.

Collegare il tuo account

Avvia il login:

transcript1 login

La CLI apre transcript1.com nel browser; se lavori via SSH o senza schermo, mostra il link nel terminale. Verifica che il codice nel terminale coincida con quello della pagina e clicca “Approve”. Dopo la conferma, la CLI salva una chiave con nome transcript1 CLI (<computer name>). La ritrovi in “API keys”.

Se preferisci aprire tu il link, usa transcript1 login --no-browser.

Hai già una chiave? Incollala con transcript1 login --with-key, oppure passala tramite stdin: transcript1 login < key.txt.

In CI o con un agente, imposta TRANSCRIPT1_API_KEY: la CLI userà questa chiave anziché quella salvata. Un agente che non ha un terminale o una chiave può lanciare transcript1 login < /dev/null e mandarti il link per autorizzarlo.

Con transcript1 logout, la CLI revoca la propria chiave e la elimina dal computer. Se non riesce a revocarla, la elimina comunque in locale e ti chiede di revocarla in “API keys”. Per le chiavi incollate, la revoca va sempre fatta da quella pagina.

Trascrivere un video da link

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

Il comando aspetta che il testo sia pronto, poi lo scrive su stdout. Gli aggiornamenti sull'avanzamento vanno su stderr. Su YouTube, X, TikTok, Bluesky, Dailymotion e LinkedIn cerca prima sottotitoli adatti nella lingua originale; se non può usarli, trascrive l'audio con IA.

In zsh è meglio racchiudere i link tra virgolette. Senza virgolette, & separa il comando. Anche ? viene interpretato come carattere glob, a meno di usare l'alias aggiunto durante l'installazione.

Trascrivere un file sul computer

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

La CLI accetta file fino a 2 GB (2.000.000.000 byte) con estensione mp3, wav, m4a, flac, ogg, opus, mp4, mov, webm o mkv. Si occupa sia del caricamento sia dell'attesa della trascrizione.

Elaborare più file o link insieme

Nello stesso comando puoi indicare più file, più link o una cartella:

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

Puoi selezionare file con espressioni come recordings/*.mp3, anche su Windows. Se indichi una cartella, la CLI prende i file audio e video direttamente al suo interno e li ordina per nome. Con più input salva, di default, un file per ciascuno in ./transcripts. Imposta --jobs per scegliere quante trascrizioni eseguire insieme: da 1 a 20, con 2 come valore predefinito.

Per leggere gli input da stdin, usa - e fornisci un link o un percorso per riga. Per esempio, su macOS o Linux:

transcript1 -o transcripts/ - < inputs.txt

La CLI ignora le righe vuote e quelle che cominciano con #. Se due input sono identici, li elabora una sola volta.

Con un input, -o sceglie il file da salvare. Se il percorso è una cartella esistente o finisce con /, lo tratta come cartella. Con più input, -o indica sempre una cartella. La CLI crea quelle che mancano.

Per i link YouTube e i file locali, se il file da salvare esiste già la CLI salta quell'input. Usa --overwrite per elaborarlo di nuovo:

transcript1 --overwrite -o transcripts/ ./recordings

Scegliere formato e opzioni

Per aggiungere sia il riconoscimento dei parlanti sia i timestamp:

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

Non puoi abbinare --speakers a --source captions. Con auto, il riconoscimento dei parlanti usa direttamente l'audio. Il comportamento dei sottotitoli su YouTube e X resta invariato; puoi recuperare le tracce disponibili anche su TikTok, Bluesky, Dailymotion e LinkedIn. Fuori da YouTube, queste tracce hanno i timestamp dei segmenti, non delle parole (words: null), anche se generate automaticamente. Trovi il confronto tra piattaforme e le regole sulla lingua in Link e opzioni di trascrizione.

Usare la CLI negli script e con gli agenti

Se il tuo agente ha una shell, può installare la CLI e lanciare transcript1 <link> o transcript1 <file> dopo aver impostato TRANSCRIPT1_API_KEY. Se invece usa MCP, segui la guida per collegare il server MCP.

Per leggere le risposte da uno script, usa --json. Scrive su stdout una riga JSON per ogni input appena termina, senza messaggi di avanzamento, riepiloghi o avvisi di aggiornamento:

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

Per ogni job terminato, la riga contiene l'oggetto trascrizione dell'API con in più input e reused. Se il testo è stato salvato su disco, trovi file al posto di transcript.

Un errore avvenuto prima della creazione dell'ID contiene input e un oggetto error con code e message. Per gli input saltati ricevi input, skipped (exists o out_of_minutes) e, dove applicabile, file. Il valore exists riguarda solo link YouTube e file locali.

Con un solo input senza -o, --json include il testo nell'oggetto e ignora -f. Con più input senza -o, salva le trascrizioni in ./transcripts: ogni riga JSON riporta quindi file, non transcript. Quando salva un file, usa il formato scelto con -f. Per nascondere avanzamento e riepiloghi senza togliere testo ed errori, usa -q o --quiet.

Se vuoi avviare la trascrizione e leggerla più tardi:

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

Il primo comando stampa ID e stato, oppure l'oggetto se aggiungi --json. Usa quell'ID al posto di <id> nel secondo comando. get aspetta se la trascrizione è ancora in corso e accetta -f, -o, --timestamps, --no-wait, --json e -q.

Aggiornare la CLI

transcript1 update

Quando stderr è un terminale, la CLI cerca aggiornamenti al massimo una volta ogni 24 ore. Se trova una release più recente, ti avvisa. Disattiva il controllo con TRANSCRIPT1_NO_UPDATE_CHECK=1; anche --json e -q lo disattivano.

Leggere il codice di uscita

Per l'elenco completo dei comandi e delle opzioni, esegui transcript1 --help oppure transcript1 senza argomenti.