veestream

VeeStream: The Ultimate Video Conversion CLI Tool

Welcome to VeeStream, the command-line companion you never knew you needed! With its power, you can convert videos effortlessly into various resolutions and generate HLS playlists for seamless streaming on the web. Whether you're a developer optimizing video streams or someone who just wants a quick way to prepare videos for multi-quality playback, VeeStream has your back.

🚀 What Does VeeStream Do?

VeeStream is a CLI tool designed to:

• Convert videos into multiple resolutions (144p, 240p, 360p, 480p, 720p, and 1080p).
• Maintain aspect ratios (e.g., 16:9 or 9:16) for both landscape and portrait orientations.
• Generate HLS (HTTP Live Streaming) playlists, including resolution-specific .m3u8 files and a master playlist for adaptive streaming.

In short, it takes your video file and prepares it for modern streaming needs, allowing users to choose their desired quality while streaming online.

🎯 Why Should You Use It?

• Saves Time: No more manual FFmpeg commands or figuring out aspect ratios.
• Web-Ready Outputs: Perfect for video platforms where users can select quality (just like YouTube or Netflix).
• Simple Yet Powerful: A straightforward CLI interface combined with the power of FFmpeg.
• Supports Both Beginners and Experts: Even if you’re new to video conversion, VeeStream guides you through the process interactively.

📦 Installation

First, ensure you have Node.js and FFmpeg installed.

Then install VeeStream globally via npm:

npm install -g veestream

Boom! You're all set.

💻 Usage

Using VeeStream is as simple as having a video file and a goal in mind. Here’s how you can start:

Basic Command

veestream -i <input-video-file> -o <output-directory>

Options

Option	Description
-i, --input <file>	Input video file (e.g., video.mp4).
-o, --output <dir>	Output directory for converted files.
-a, --aspect-ratio	Aspect ratio: 16:9 (landscape) or 9:16 (portrait).

Example

Convert movie.mp4 to multiple resolutions and store the output in the streaming-files folder:

veestream -i movie.mp4 -o streaming-files -a 16:9

If you don’t provide certain options, VeeStream will interactively guide you through the process. For instance, it will:

• Let you pick a video file from the current directory or manually enter a path.
• Prompt you to specify an output folder name.
• Ask for the desired aspect ratio if not provided.

🎥 How It Works

Here’s what happens under the hood:

• Input File: You provide a video file or select one from the current directory.
• Resolution Scaling: The video is scaled into multiple resolutions based on the aspect ratio:
  • Landscape (16:9): 144p, 240p, 360p, 480p, 720p, 1080p.
  • Portrait (9:16): 144p, 240p, 360p, 480p, 720p, 1080p.
• HLS Playlist Generation: Each resolution gets its own .m3u8 playlist, and a master playlist (playlist.m3u8) ties it all together for adaptive streaming.
• Output: All files are neatly organized in the specified output folder.

Example Output Structure:

streaming-files/
├── 144p.m3u8
├── 240p.m3u8
├── 360p.m3u8
├── 480p.m3u8
├── 720p.m3u8
├── 1080p.m3u8
├── 144p_001.ts
├── 240p_001.ts
├── ...
└── playlist.m3u8

🛠 Behind the Scenes

VeeStream uses the magic of FFmpeg to handle video conversion. Each resolution is encoded with:

• H.264 video codec: High compatibility with most devices.
• AAC audio codec: Crisp sound quality.
• HLS segmentation: Breaks videos into small chunks (.ts files) for efficient streaming.

The master playlist (playlist.m3u8) ensures adaptive streaming. Users can switch between resolutions based on their internet speed.

😄 Why Should Developers Care?

If you’ve ever struggled with setting up video streams or faced complaints like "Why isn’t there a quality option on my video player?", VeeStream is here to save your day. It bridges the gap between technical complexities and simple implementation.

Also, let’s be honest, as do you really want to write FFmpeg commands manually? (Hint: The answer is "No.")

💡 Fun Fact

Did you know that if you watch videos at 144p, you’re saving your internet for future generations? Okay, maybe not. But now you can tell your users they have the option!

🌟 Features to Come

We’re just getting started! Here are some planned features:

• Custom bitrates: Define your own bitrate for each resolution.
• Audio-only streams: For those podcast vibes.
• Watermark support: Add custom watermarks to your videos.
• Cloud integration: Direct upload to S3 or other storage solutions.

Stay tuned for updates, or better yet, contribute to the project!

📝 License

VeeStream is open-source and free to use under the MIT License.

👏 Contribute

We’d love your help to make VeeStream even better! Check out our GitHub repo to get started:

GitHub Repository

💬 Questions or Feedback?

Reach out or file an issue on GitHub. Let’s make video streaming a breeze for everyone.

Happy streaming! 🎥✨