ff

Stop Googling ffmpeg commands.

ff convert video.mp4 to gif

That's it. No flags. No manuals. Just plain English.

Install

npm install -g ezff

Requires ffmpeg to be installed on your system.

Interactive Mode

Don't remember the syntax? Just type ff:

$ ff

  ff — Plain English ffmpeg

? File path: video.mp4
? What do you want to do? › Convert format
? Convert to: › GIF

  ffmpeg -i video.mp4 -vf fps=15,scale=480:-1:flags=lanczos -loop 0 -y video_output.gif

? Run it? › Yes

  Done!

Step-by-step. No memorization needed.

Direct Commands

Already know what you want? Skip the prompts:

# Convert formats
ff convert video.mp4 to gif
ff convert video.mp4 to mp3

# Compress
ff compress video.mp4 to 10mb

# Trim
ff trim video.mp4 from 0:30 to 1:00

# Extract audio
ff extract audio from video.mp4

# Resize
ff resize video.mp4 to 1280x720
ff resize video.mp4 to 720p

# Speed
ff speed up video.mp4 by 2x
ff slow down video.mp4 by 2x

# Other operations
ff reverse video.mp4
ff mute video.mp4
ff rotate video.mp4 by 90
ff flip video.mp4 horizontal
ff thumbnail video.mp4 at 0:05
ff merge video1.mp4 and video2.mp4
ff video.mp4 grayscale

Dry Run

Preview the ffmpeg command without executing:

$ ff convert video.mp4 to gif --dry-run
ffmpeg -i video.mp4 -vf fps=15,scale=480:-1:flags=lanczos -loop 0 -y video_output.gif

All Commands

| Command | Example | |---------|---------| | Convert | ff convert video.mp4 to gif | | Compress | ff compress video.mp4 to 10mb | | Trim | ff trim video.mp4 from 0:30 to 1:00 | | Extract audio | ff extract audio from video.mp4 | | Resize | ff resize video.mp4 to 1280x720 | | Scale | ff resize video.mp4 to 720p | | Speed up | ff speed up video.mp4 by 2x | | Slow down | ff slow down video.mp4 by 2x | | Reverse | ff reverse video.mp4 | | Mute | ff mute video.mp4 | | Rotate | ff rotate video.mp4 by 90 | | Flip | ff flip video.mp4 horizontal | | Thumbnail | ff thumbnail video.mp4 at 0:05 | | Crop | ff crop video.mp4 to 640x480 | | FPS | ff fps video.mp4 to 30 | | Loop | ff loop video.mp4 3 times | | Merge | ff merge a.mp4 and b.mp4 | | Add audio | ff add audio.mp3 to video.mp4 | | Grayscale | ff video.mp4 grayscale | | Stabilize | ff stabilize video.mp4 | | Denoise | ff denoise video.mp4 |

How It Works

"ff compress video.mp4 to 10mb"
          ↓
    ┌─────────────┐
    │   Parser    │  Extracts: action=compress, file=video.mp4, size=10mb
    └─────────────┘
          ↓
    ┌─────────────┐
    │   Builder   │  Maps to: ffmpeg -i video.mp4 -crf 28 -preset medium ...
    └─────────────┘
          ↓
    ┌─────────────┐
    │   ffmpeg    │  Executes the command
    └─────────────┘

No AI. No API calls. Just pattern matching. Fast and offline.

Output

Files are saved in the same directory with _output suffix:

video.mp4 → video_output.gif

Requirements

• Node.js >= 16
• ffmpeg installed and in PATH

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Windows
choco install ffmpeg

License

MIT

Contributing

PRs welcome. Keep it simple.

GitHub · Made by @josharsh