ffhub
English · 中文 · 日本語 · Português · Deutsch
Cloud FFmpeg CLI — process video/audio files via FFHub.io API. No local FFmpeg installation required.
Install
npm install -g ffhub
Or run directly:
npx ffhub -i https://example.com/video.mp4 -c:v libx264 output.mp4
Setup
# Save your API key
ffhub config YOUR_API_KEY
# Or use environment variable
export FFHUB_API_KEY=YOUR_API_KEY
Get your API key at ffhub.io. Signing up grants 100 credits, once; after that you top up with one-time credit packs (no subscription).
Usage
Use the same FFmpeg arguments you already know:
# Compress video
ffhub -i https://example.com/video.mp4 -c:v libx264 -crf 28 output.mp4
# Convert format
ffhub -i https://example.com/video.mov -c:v libx264 -c:a aac output.mp4
# Extract audio
ffhub -i https://example.com/video.mp4 -vn -c:a libmp3lame output.mp3
# Trim video
ffhub -i https://example.com/video.mp4 -ss 00:00:10 -to 00:00:30 -c copy clip.mp4
# Resize to 720p
ffhub -i https://example.com/video.mp4 -vf scale=-1:720 output.mp4
# Create GIF
ffhub -i https://example.com/video.mp4 -ss 5 -t 3 -vf "fps=10,scale=480:-1" output.gif
Local Files
Local files are automatically uploaded:
ffhub -i ./my-video.mp4 -c:v libx264 output.mp4
ffhub -i ~/Downloads/recording.mov -vn output.mp3
Output Files
When a task finishes, the result is streamed into the directory you ran the command from,
with a progress bar. Existing files are never overwritten — if output.mp4 is already
there, the new file is saved as output-2.mp4, then output-3.mp4, and so on. Ctrl+C
cancels a download: the partial file is deleted and the CLI prints a curl command you can
use to fetch it later.
Account and Tasks
# Current account and credit balance
ffhub whoami
# 10 most recent tasks
ffhub list
# Filter by status (pending, running, succeeded, failed) and change the count
ffhub list --status=failed --limit=20
# A single task — if it has already finished, its output is downloaded again
ffhub status <task_id>
How It Works
ffhub -i video.mp4 -c:v libx264 output.mp4
│
├─ Detect local file → upload to FFHub cloud
├─ Submit FFmpeg command to API
├─ Poll progress until complete
└─ Download the output into the current directory
Commands
| Command | Description |
|---|
ffhub [ffmpeg args] | Submit an FFmpeg task, then download the output |
ffhub whoami | Show the current account and credit balance |
ffhub list [--status=X] [--limit=N] | List recent tasks (10 by default); ffhub ls is an alias |
ffhub status <id> | Check a task and download its output if it is ready |
ffhub config <key> | Save API key to ~/.ffhub/config.json |
ffhub config | Show current API key (masked) |
ffhub help | Show help (-h / --help work too) |
ffhub --version | Print the CLI version (-v works too) |
Requirements
License
MIT
