98 lines
3.9 KiB
Markdown
98 lines
3.9 KiB
Markdown
# 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)
|
||
|
||
---
|