FFHub CLI-Tool

ffhub CLI installieren und FFmpeg-Tasks direkt im Terminal ausführen.

Mit der FFHub CLI führst du FFmpeg-Tasks direkt im Terminal aus. Lokale Dateien werden automatisch in die Cloud hochgeladen.

Voraussetzungen

Du brauchst Node.js 18 oder neuer. Prüfe mit:

node --version

Falls Node nicht installiert ist, hol's von nodejs.org (LTS-Version reicht).

Installation

Installiere global, damit du ffhub von überall im Terminal aufrufen kannst:

npm install -g ffhub

Das -g-Flag bedeutet "global" — installiert den Befehl in deinen System-PATH statt in einen lokalen node_modules-Ordner. Prüf, ob's geklappt hat:

ffhub help

Du solltest eine Befehlsliste sehen. Wenn die Shell command not found: ffhub sagt, siehe Fehlersuche unten.

Aktualisieren

npm install -g ffhub@latest

Ohne Installation (`npx`)

Wenn du lieber nicht global installierst, funktioniert jeder Befehl in dieser Doku auch mit npx ffhub statt ffhub — npm lädt die neueste Version on-demand:

npx ffhub "ffmpeg -i input.mp4 -c:v libx264 output.mp4"

Beim ersten Lauf etwas langsamer (Paket wird heruntergeladen), aber ohne globale Installation.

Konfiguration

Setze den API Key über die CLI:

ffhub config YOUR_API_KEY

Oder per Umgebungsvariable:

export FFHUB_API_KEY=YOUR_API_KEY

Beispiele

Video transcodieren

ffhub "ffmpeg -i input.mov -c:v libx264 -preset fast output.mp4"

Video komprimieren

ffhub "ffmpeg -i input.mp4 -c:v libx264 -crf 28 output.mp4"

Audio extrahieren

ffhub "ffmpeg -i video.mp4 -vn -c:a libmp3lame audio.mp3"

Wenn die Eingabedatei ein lokaler Pfad ist, lädt die CLI sie automatisch hoch, bevor der Befehl läuft. Nach Abschluss wird die Ausgabedatei in dein aktuelles Verzeichnis heruntergeladen.

Befehlsübersicht

Command	Beschreibung
`ffhub [args]`	FFmpeg-Task erstellen und ausführen
`ffhub whoami`	Aktuellen Benutzer anzeigen
`ffhub list`	Letzte Tasks auflisten
`ffhub status <task_id>`	Task-Status prüfen
`ffhub config <api_key>`	API Key in der Config speichern
`ffhub help`	Hilfe anzeigen

Fehlersuche

`command not found: ffhub`

Nach npm install -g liegt die ffhub-Binary im globalen npm-bin-Ordner, aber der muss in $PATH sein, damit du direkt darauf zugreifen kannst. Prüfe:

npm prefix -g       # z. B. /usr/local
echo $PATH | tr ':' '\n' | grep -i bin

Der erste Befehl zeigt, wo npm globale Pakete ablegt. Bestätige, dass <dieser Pfad>/bin in der Ausgabe des zweiten Befehls erscheint. Falls nicht, füge diese Zeile zu deiner Shell-Config hinzu (~/.zshrc, ~/.bashrc etc.):

export PATH="$(npm prefix -g)/bin:$PATH"

Terminal neu starten, dann sollte ffhub help funktionieren.

Berechtigungsfehler bei `npm install -g`

Wenn du EACCES-Fehler siehst, braucht dein globaler npm-Ordner sudo. Entweder sudo npm install -g ffhub ausführen, oder (besser) npm so konfigurieren, dass es einen vom User beschreibbaren Ordner verwendet — siehe npm-Doku zu Berechtigungen.