ff

Stop Googling ffmpeg commands.

``bash
ff convert video.mp4 to gif
`

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

Install

`bash
npm install -g ezff
`

> Requires ffmpeg to be installed on your system.

Interactive Mode

Don't remember the syntax? Just type ff:

`bash
$ 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:

`bash


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:

`bash
$ 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

`bash


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