🗂️ Table of Contents

• 🗂️ Table of Contents
• 📋 About
• 🛠️ Tech Stack
  • Core Components
• 📁 Project Structure
• 🚀 Getting Started
  • Prerequisites
  • Installation
  • Usage
• 👥 Contributors
• 📜 License

📋 About

Video Splitter is a Python utility that allows you to split a video into multiple segments based on timecodes defined in a CSV file. Perfect for extracting specific scenes, creating compilations, or preparing video sets for editing.

🛠️ Tech Stack

Python

Pandas

MoviePy

Core Components

• 🎬 MoviePy for video processing
• 📊 Pandas for CSV handling
• ⏱️ Built-in time conversion utilities
• 🎯 Command-line interface

📁 Project Structure

VideoSplitter/
├── main.py            # Main application script
├── requirements.txt   # Python dependencies
├── public/            # Public assets
└── sets_output/       # Output directory (auto-created)

🚀 Getting Started

Prerequisites

• Python 3.8 or higher

Installation

1. Clone the Repository

   git clone https://github.com/yourusername/video-splitter
   cd video-splitter

2. Create and Activate Virtual Environment

   # Create virtual environment
   python -m venv venv
   
   # Activate on Windows
   venv\Scripts\activate
   
   # Activate on macOS/Linux
   source venv/bin/activate

3. Install Dependencies

   pip install -r requirements.txt

Usage

1. Prepare a CSV file with the following columns:

   • set_name: Name for the output file
   • start1, end1, start2, end2, etc.: Timecodes in HH:MM:SS format

2. Run the script:

   python main.py path/to/video.mp4 path/to/timecodes.csv

3. Find your split videos in the sets_output directory

👥 Contributors

tomStory9

📜 License

This project is licensed under the MIT License.

---

_{Built with ❤️ For TheBattleGround}