ffmpeg-generator/README.md

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.

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.

<h1 align="center">🎬 ffmpeg-generator</h1>
<p align="center">CLI tool to generate high-quality FFmpeg HLS commands — fast, smart, and stream-ready ⚡</p>

<p align="center">
  <a href="https://www.npmjs.com/package/ffmpeg-generator">
    <img src="https://img.shields.io/npm/v/ffmpeg-generator?color=blue" alt=""/>
  </a>
  <img src="https://img.shields.io/npm/dw/ffmpeg-generator?color=green" alt=""/>
  <img src="https://img.shields.io/badge/ffmpeg-powered-ff0000?logo=ffmpeg&logoColor=white" alt=""/>
</p>

## ⚡ 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](https://ffmpeg.org/) installed and available in your PATH.

```bash
npm install -g ffmpeg-generator
```

### 🚀 Usage

![usage](https://files.catbox.moe/t1m336.gif)

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

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

MIT © 2025
Feel free to remix, extend, or publish your own variant.

### Contact
Linked In: [sirojbekmaqsudov](https://www.linkedin.com/in/sirojbek/)  

---
Made with ☕, bugs, and ffmpeg rage by [Sirojbek](https://github.com/sirojbek), Smash that ⭐ on [GitHub](https://github.com/SirojbekMaqsudov/ffmpeg-generator)

> Devs who know, know.