Generate multi-resolution FFmpeg HLS commands from any .mp4 file via a smart CLI. Auto-detects streams, builds playlists, and speeds up your video pipeline.

🎬 ffmpeg-generator

CLI tool to generate high-quality FFmpeg HLS commands — fast, smart, and stream-ready ⚡

⚡ What is `ffmpeg-generator`?

ffmpeg-generator is a fast, developer-friendly CLI tool to generate and run complex FFmpeg commands for HLS transcoding. It auto-scales videos to multiple resolutions, handles audio streams, and outputs a fully functional master.m3u8 playlist — ready for streaming 🚀

✨ Features

📦 Converts .mp4 to multi-quality .m3u8 (HLS)
🔍 Auto-detects video resolution & audio index
📂 Smart directory structure with confirmation prompts
🧠 Built-in presets for:
- 2160p, 1440p, 1080p, 720p, 480p, 360p
🧪 Built-in ffprobe checks before processing
💬 Interactive CLI with inquirer
☁️ Perfect for streaming servers, encoding queues, media tools
🖼️ Optional logo watermark overlay on all resolutions (--logo)
🚀 Customizable FFmpeg encoding preset speed (--speed) Supports: placebo, slow, medium, fast, faster, veryfast (default), superfast, ultrafast
⏱️ Adjustable segment duration with --hls-time option (default: 6 seconds)

🧑‍💻 Installation

❗ Warning: Make sure you have ffmpeg installed and available in your PATH.

npm install -g ffmpeg-generator

🚀 Usage

ffgen <input-file> <output-dir> [optional-subfolder]

ffgen input.mp4 output-folder-path

❓ FAQ

Q: Do I need FFmpeg installed? A: Yes, both ffmpeg and ffprobe must be in your PATH.

Q: Is it open-source? A: MIT license. Steal it. Fork it. Build on it.

🧠 Author

Built with ❤️ by @sirojbek

“If you manually write FFmpeg commands in 2025… you need this CLI and a vacation 😭”

📜 License

Contact

Linked In: sirojbekmaqsudov

Made with ☕, bugs, and ffmpeg rage by Sirojbek, Smash that ⭐ on GitHub

Devs who know, know.