README

nano-ffmpeg
  
  Every ffmpeg feature. Zero flags to remember.
  
  Website •
  Quick Start •
  Install •
  Features •
  Usage •
  CLI Options •
  Operations •
  Keybindings •
  Releasing •
  Contributing •
  License



  
  
  
  


---

nano-ffmpeg wraps the full power of ffmpeg in a beautiful, keyboard-driven terminal dashboard. No more googling flags. Browse your files, pick what you want to do, tweak settings with presets, and watch a live progress bar while it encodes.

Built for people who know they need ffmpeg but can't remember how to use it.


╭─────────────────────────────────────────────────────────────────────╮
│  nano-ffmpeg  Home                                                 │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ╭──────────────────────────────────────────────────────────────╮   │
│  │  ffmpeg 8.1                                                  │   │
│  │  497 codecs  |  231 encoders  |  234 formats  |  489 filters │   │
│  │  HW Accel: videotoolbox                                      │   │
│  ╰──────────────────────────────────────────────────────────────╯   │
│                                                                     │
│  RECENT FILES                                                       │
│     interview.mp4    ~/Videos                                       │
│     concert.mkv      ~/Downloads                                    │
│                                                                     │
│  OPERATIONS                                                         │
│    Convert Format     Change container or codec                    │
│     Extract Audio      Strip video, keep audio                      │
│     Resize / Scale     Change resolution                            │
│     Trim / Cut         Cut segments by time                         │
│     Compress           Reduce file size                             │
│     ...                                                             │
│                                                                     │
├─────────────────────────────────────────────────────────────────────┤
│  ↑↓ Navigate   Enter Select   q Quit   ? Help                      │
╰─────────────────────────────────────────────────────────────────────╯


 Quick Start

If you already have ffmpeg and ffprobe on your PATH:

bash
 macOS (Homebrew tap -- also pulls ffmpeg-full):
brew install dgr8akki/tap/nano-ffmpeg
nano-ffmpeg


powershell
 Windows (Scoop -- pulls ffmpeg from the extras bucket):
scoop bucket add extras
scoop bucket add nano-ffmpeg https://github.com/dgr8akki/scoop-bucket
scoop install nano-ffmpeg
nano-ffmpeg


bash
 Any Go toolchain:
go install github.com/dgr8akki/nano-ffmpeg@latest
nano-ffmpeg


Jump straight into a specific file without clicking through the file picker:

bash
nano-ffmpeg -d ~/Videos/interview.mp4


The 

Top issues

Latest release

Changelog
 bff423a41f81554d7fd785973258374eb4ff0220 Fix TUI navigation, quit cleanup and the failed-job screen
 1212ec6a730a8bd11e68ce95cc95585edeb06bc8 Fix broken operations, validate settings, add e2e suite
 e0b9f5b12dd8159d4e2aa5d2c4a0fdadd2f86d66 Fix ffmpeg 8+ output parsing, input-side seeking and Windows cancel
 8c7f7d3785f231414bee72db40b0f461b480b44a Update README and docs page to match current behaviour