# LCS Video Pipeline Wiki

Welcome to the **LCS Video Pipeline** documentation!  
This wiki is the living source of truth for the project — workflows, automation scripts, branding guidelines, and everything else that keeps the pipeline running smoothly.  

---

## 📑 Table of Contents
- [Overview](#overview)
- [Project Goals](#project-goals)
- [Core Components](#core-components)
- [Workflow Summary](#workflow-summary)
- [Branding Guidelines](#branding-guidelines)
- [Automation Scripts](#automation-scripts)
- [Contributing](#contributing)
- [License](#license)
- [Site Index](#site-index)

---

## Overview
The **LCS Video Pipeline** automates the transformation of raw livestream recordings into fully branded, published videos on YouTube and PeerTube — with minimal manual effort.  
It’s built to be fast, flexible, and scalable.

---

## Project Goals
- **Full Automation** – Minimize manual intervention in video processing and uploads.
- **Brand Consistency** – Apply intros, outros, titles, and descriptions according to predefined rules.
- **Platform Flexibility** – Publish to multiple platforms without extra steps.
- **Metadata Tracking** – Maintain a detailed archive of uploads, formats, and performance data.

---

## Core Components
1. **Video Processing** – Handles clip trimming, intro/outro insertion, title card generation, and format adjustments.
2. **Metadata Generation** – Pulls session data and user notes into dynamic titles and descriptions.
3. **Publishing** – Uploads to YouTube, PeerTube, and optionally Mastodon/Bluesky.
4. **Branding Assets** – Logos, fonts, and color palettes for consistent look-and-feel.
5. **Automation Scripts** – Python modules that orchestrate the entire pipeline.

---

## Workflow Summary
1. **Clip Intake** – Source files are added to the `hits/`, `misses/`, `montages/`, or `outtakes/` folders.
2. **Brand Application** – The system injects title cards, branding assets, and date stamps.
3. **Rendering** – Produces both widescreen (16:9) and vertical (9:16) versions where applicable.
4. **Upload & Publish** – Posts videos to target platforms with optimized descriptions and hashtags.
5. **Archive** – Updates the metadata repository for auditing and analytics.

---

## Branding Guidelines
- **Main Font**: Fortnite-style font (Burbank Big Condensed Black)
- **Main Colors**:
  - Pink: `#f7338f`
  - Aqua: `#10abba`
  - Dark Shadow: `#1c0c38`
- **Logo**: Brand llama (`LlamaLlama.png`) used on all thumbnails.

---

## Automation Scripts
Key helper scripts include:
- `render_engine.py` – Builds final videos with intros, titles, and outros.
- `title_utils.py` – Generates title cards dynamically.
- `yt_poster.py` – Handles YouTube uploads.
- `pt_poster.py` – Handles PeerTube uploads.
- `sync_wiki.py` – Pushes updated wiki pages to the repository.
- `discovery.py` – Detects new session folders for processing.

---

## Contributing
Pull requests are welcome on the [llgit repository](https://llgit.llamachile.tube/code/gramps/video-pipeline).  
Please follow the established coding style and commit message conventions.

---

## License
This project is licensed under the MIT License.

---

## 📚 Site Index
Here’s a quick jump list to all wiki pages:

- [Home](https://llgit.llamachile.tube/code/gramps/video-pipeline/wiki)
- [Installation](https://llgit.llamachile.tube/code/gramps/video-pipeline/wiki/Installation)
- [Configuration](https://llgit.llamachile.tube/code/gramps/video-pipeline/wiki/Configuration)
- [Usage](https://llgit.llamachile.tube/code/gramps/video-pipeline/wiki/Usage)
- [Branding](https://llgit.llamachile.tube/code/gramps/video-pipeline/wiki/Branding)
- [Automation](https://llgit.llamachile.tube/code/gramps/video-pipeline/wiki/Automation)
- [Troubleshooting](https://llgit.llamachile.tube/code/gramps/video-pipeline/wiki/Troubleshooting)
- [Changelog](https://llgit.llamachile.tube/code/gramps/video-pipeline/wiki/Changelog)

---