IELTS2GO Video chunker

A powerful CLI tool for splitting video files into smaller chunks and generating HLS streams for educational content.

Features

• Video Chunking: Split large videos into smaller, manageable chunks
• Multiple Processing Modes:
  • Fast Mode (Stream Copy): Quick chunking without re-encoding
  • Re-encode Mode: Full re-encoding for consistent quality
  • HLS Streaming: Generate HTTP Live Streaming files for web playback
• Customizable Options: Control chunk length, output format, quality, and more
• Interactive Setup: Guided prompts for easy configuration
• Detailed Progress: Real-time progress tracking and statistics

Prerequisites

Before installing IELTS2GO Video chunkify, ensure you have the following:

• Node.js (v14 or higher)
• FFmpeg installed and accessible in your system PATH

Installation

Global Installation

To install IELTS2GO Video chunkify globally on your PC, run:

npm install -g ielts2go-chunker

After installation, you can use the chunkify command from anywhere in your terminal:

chunkify video.mp4

Local Installation

If you prefer not to install globally:

1. Clone the repository:

   git clone https://github.com/ielts2go/chunkify.git
   cd chunkify

2. Install dependencies:

   npm install

3. Run using Node.js:

   node chunkify.js video.mp4

Usage

Basic Usage

chunkify <input-file> [options]

Interactive Mode

Running the command with just an input file will start the interactive setup:

chunkify video.mp4

This will guide you through selecting:

• Processing mode (Fast/Re-encode/HLS)
• Output directory
• Chunk length
• File prefix
• Quality settings

Command Line Options

| Option | Description | |--------|-------------| | -h, --help | Display help information | | -V, --version | Display version number | | -d, --output <dir> | Output directory (default: "ielts2go_chunks") | | -l, --length <seconds> | Chunk length in seconds (default: 60) | | -p, --prefix <name> | Output filename prefix (default: "ielts2go_chunk") | | -q, --quality <preset> | FFmpeg quality preset (ultrafast, superfast, veryfast, faster, fast, medium, slow, slower, veryslow) | | -f, --fast | Use fast mode (stream copy without re-encoding) | | -e, --encode | Use re-encode mode | | --hls | Generate HLS streaming files (.m3u8 and .ts) | | --hls-segment <seconds> | HLS segment length in seconds (default: 4) | | --hls-type <type> | HLS playlist type (vod or live) | | --silent | Disable progress output |

Examples

Basic Chunking with Default Settings

chunkify video.mp4

Specify Output Directory and Chunk Length

chunkify video.mp4 -d my_chunks -l 120

Fast Mode with Custom Prefix

chunkify video.mp4 -f -p lesson_part

Re-encode with High Quality

chunkify video.mp4 -e -q veryslow

Generate HLS Streaming Files

chunkify video.mp4 --hls

Advanced HLS Configuration

chunkify video.mp4 --hls --hls-segment 10 --hls-type vod -d streaming

HLS Streaming

The HLS mode generates files for HTTP Live Streaming:

• .m3u8 playlist files
• .ts segment files
• A simple HTML player for easy playback

HLS Output Structure

output_directory/
├── ielts2go_chunk_master.m3u8    # Master playlist
├── player.html                   # HTML player
├── ielts2go_metadata.json        # Metadata
└── hls/
    ├── ielts2go_chunk.m3u8       # Variant playlist
    ├── ielts2go_chunk_000.ts     # Video segments
    ├── ielts2go_chunk_001.ts
    └── ...

HLS Options

| Option | Description | |--------|-------------| | --hls | Enable HLS mode | | --hls-segment <seconds> | Segment length (2, 4, 6, or 10 seconds) | | --hls-type <type> | Playlist type (vod or live) |

Troubleshooting

FFmpeg Not Found

Ensure FFmpeg is installed and in your system PATH. Installation guides:

• Windows: https://www.wikihow.com/Install-FFmpeg-on-Windows
• macOS: brew install ffmpeg
• Linux: sudo apt install ffmpeg or equivalent

HLS Conversion Issues

If you encounter issues with HLS conversion:

1. Try using a longer segment length: --hls-segment 10
2. Ensure your FFmpeg installation includes libx264 and HLS support
3. Check if your input video format is compatible

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support, contact:

• Email: [email protected]
• Website: https://ielts2go.com