Video Splitter

A VS Code extension that helps you split large video files into smaller chunks for GitHub commits and reassemble them when needed.

Features

• Split Video Files: Break large video files into smaller chunks (default 95MB to stay under GitHub's 100MB limit)
• Reassemble Videos: Combine video chunks back into the original video file
• Context Menu Integration: Right-click on video files in the explorer to split them
• Progress Indicators: Real-time progress feedback during operations
• Metadata Tracking: Automatic metadata generation for proper reassembly
• Configurable Settings: Customize chunk size and output directory

Supported Video Formats

• MP4
• AVI
• MOV
• MKV
• WMV
• FLV
• WebM

Usage

Splitting a Video File

1. From Explorer: Right-click on a video file in the VS Code explorer and select "Split Video File"
2. From Command Palette:
   • Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
   • Type "Video Splitter: Select and Split Video File"
   • Choose your video file

The extension will split your video into chunks and create a metadata file (.vmeta) for reassembly.

Reassembling a Video File

1. From Command Palette:
   • Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
   • Type "Video Splitter: Reassemble Video File"
   • Select the video to reassemble from the list
   • Choose where to save the reassembled file

Configuration

You can customize the extension behavior in VS Code settings:

• videoSplitter.chunkSizeMB: Size of each chunk in MB (default: 95)
• videoSplitter.outputDirectory: Directory to save chunks (default: same as source file)

File Structure

When you split a video, the extension creates:

• Chunk files: filename.part000.vchunk, filename.part001.vchunk, etc.
• Metadata file: filename.vmeta (contains information needed for reassembly)
• Info files: filename.part000.vchunk.info (individual chunk information)

Example Workflow

1. You have a large video file my-video.mp4 (200MB)
2. Split it using the extension
3. Commit the chunks and metadata to Git:

   git add my-video.part*.vchunk my-video.vmeta
   git commit -m "Add video in chunks"
   git push

4. Later, when you need the original video:
   • Use "Reassemble Video File" command
   • Select my-video.vmeta
   • Get back your original my-video.mp4

Requirements

• VS Code 1.102.0 or higher
• Node.js file system access

Known Issues

• Very large files (>2GB) may require additional memory
• Progress reporting is approximate for very large files

Release Notes

0.0.1

Initial release with basic video splitting and reassembly functionality.

Contributing

Found a bug or have a feature request? Please open an issue on the GitHub repository.

---

Enjoy splitting your videos! 🎬✂️

Following extension guidelines

Ensure that you've read through the extensions guidelines and follow the best practices for creating your extension.

• Extension Guidelines

Working with Markdown

You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:

• Split the editor (Cmd+\ on macOS or Ctrl+\ on Windows and Linux).
• Toggle preview (Shift+Cmd+V on macOS or Shift+Ctrl+V on Windows and Linux).
• Press Ctrl+Space (Windows, Linux, macOS) to see a list of Markdown snippets.

For more information

• Visual Studio Code's Markdown Support
• Markdown Syntax Reference

Enjoy!