video-pipeline

Table of Contents

🧾 File Naming & Directory Conventions

🗂️ Session Directory Format
📁 Required Subdirectories
🎥 File Naming Rules

Clip file:
Metadata file:

🧠 Format Inference

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

🧾 File Naming & Directory Conventions

This page defines the standard folder structure and file naming rules used by the LCS Pipeline to automate detection, classification, and processing.

🗂️ Session Directory Format

All input clips are organized under session folders, named using one of the following formats:

YYYY.MM.DD/
YYYY.MM.DD.N/   ← (N = 2–99 for multiple sessions on the same day)

Examples:

2025.07.21/
2025.07.21.2/ → treated as "Video 2" from the same day

📁 Required Subdirectories

Each session folder must contain the following subdirectories:

Folder Name	Purpose
`hits/`	Great moments / eliminations
`misses/`	Funny fails or embarrassing clips
`outtakes/`	Manually marked highlights during stream
`montages/`	Pre-edited reels (multi-event highlight mixes)
`timelapses/`	3D print time-lapse captures (special case)
`rendered/`	Final videos after intro/outro, overlay, export

These folders are required for consistent processing.

🎥 File Naming Rules

Clip file:

clip-name.mp4
clip-name-vert.mp4  ← treated as vertical

Metadata file:

clip-name.notes.json

All metadata files must:

Use the same basename as their associated .mp4 file
Reside in the same subdirectory

🧠 Format Inference

Vertical clips: filenames ending in -vert or -vertical
Output names retain the original base name (with -vert preserved)
Montages are treated as full reels and auto-titled
All other clips prompt for notes.json input

This page works hand-in-hand with Clip Handling Logic.