🧼 Overwriting Home.md with clean canvas version

2025-08-05 11:45:41 -07:00
parent 899a37cd2b
commit ba3bd2dbf7

98
Home.md

@ -1,38 +1,70 @@
# Welcome to the LCS Video Pipeline Wiki
## 🦩 LCS Pipeline: Automated Video Highlights with Gramps
This wiki documents the entire content pipeline for Llama Chile Shop (LCS), managed by Gramps. From AI-assisted clip selection to dynamic rendering, upload automation, and social publishing — everything is documented here.
Welcome to the **Llama Chile Shop (LCS) Pipeline**, a fully automated content-creation workflow built for **gaming livestreams**. This system transforms raw gameplay and AI-generated clips into polished videos — complete with intros, title cards, dynamic descriptions, thumbnails, and uploads to YouTube and PeerTube.
## Getting Started
* [[Getting Started](https://github.com/LCS-Gramps/video-pipeline/wiki/Getting-Started)](https://github.com/LCS-Gramps/video-pipeline/wiki/Getting-Started)
* [[Configuration](https://github.com/LCS-Gramps/video-pipeline/wiki/config.py)](https://github.com/LCS-Gramps/video-pipeline/wiki/config.py)
## Core Concepts
* [[Architecture Overview](https://github.com/LCS-Gramps/video-pipeline/wiki/Architecture-Overview)](https://github.com/LCS-Gramps/video-pipeline/wiki/Architecture-Overview)
* [[Directory Layout](https://github.com/LCS-Gramps/video-pipeline/wiki/Directory-Layout)](https://github.com/LCS-Gramps/video-pipeline/wiki/Directory-Layout)
* [[File Naming & Directory Conventions](https://github.com/LCS-Gramps/video-pipeline/wiki/File-Naming-&-Directory-Conventions)](https://github.com/LCS-Gramps/video-pipeline/wiki/File-Naming-&-Directory-Conventions)
* [[Metadata Format](https://github.com/LCS-Gramps/video-pipeline/wiki/Metadata-Format)](https://github.com/LCS-Gramps/video-pipeline/wiki/Metadata-Format)
* [[Metadata Extraction](https://github.com/LCS-Gramps/video-pipeline/wiki/Metadata-Extraction)](https://github.com/LCS-Gramps/video-pipeline/wiki/Metadata-Extraction)
* [[Metadata History](https://github.com/LCS-Gramps/video-pipeline/wiki/Metadata-History)](https://github.com/LCS-Gramps/video-pipeline/wiki/Metadata-History)
## Modules
* [[Module Index](https://github.com/LCS-Gramps/video-pipeline/wiki/Module-Index)](https://github.com/LCS-Gramps/video-pipeline/wiki/Module-Index)
* [[Clip Handling Logic](https://github.com/LCS-Gramps/video-pipeline/wiki/Clip-Handling-Logic)](https://github.com/LCS-Gramps/video-pipeline/wiki/Clip-Handling-Logic)
* [[YouTube Upload Logic](https://github.com/LCS-Gramps/video-pipeline/wiki/YouTube-Upload-Logic)](https://github.com/LCS-Gramps/video-pipeline/wiki/YouTube-Upload-Logic)
* [[Thumbnail Generation](https://github.com/LCS-Gramps/video-pipeline/wiki/Thumbnail-Generation)](https://github.com/LCS-Gramps/video-pipeline/wiki/Thumbnail-Generation)
## Development & Testing
* [[Project Overview](https://github.com/LCS-Gramps/video-pipeline/wiki/Project-Overview)](https://github.com/LCS-Gramps/video-pipeline/wiki/Project-Overview)
* [[Test Structure](https://github.com/LCS-Gramps/video-pipeline/wiki/Test-Structure)](https://github.com/LCS-Gramps/video-pipeline/wiki/Test-Structure)
* [[Test Wiki Hook](https://github.com/LCS-Gramps/video-pipeline/wiki/Test-Wiki-Hook)](https://github.com/LCS-Gramps/video-pipeline/wiki/Test-Wiki-Hook)
## Roadmap
* [[Pending Work & Roadmap](https://github.com/LCS-Gramps/video-pipeline/wiki/Pending-Work-&-Roadmap)](https://github.com/LCS-Gramps/video-pipeline/wiki/Pending-Work-&-Roadmap)
Everything's tuned for Gramps-style: 💥 fast, 🤣 funny, and 🌟 hands-off.
---
*Last updated automatically by your friendly wiki manager 🍩*
### 🎮 Key Features
***Daily Scan & Session Detection**
* 🎬 **Auto-rendered highlight reels** (vertical & widescreen)
* 🧠 **AI-generated video titles + descriptions**
* **Intro/outro stitching + title cards**
* 🖼️ **Branded YouTube thumbnails**
* ☁️ **Uploads to YouTube + PeerTube**
* 📣 **Social posts to Mastodon and Bluesky** (coming soon)
---
### 🚀 Quick Start
```bash
git clone https://github.com/LCS-Gramps/video-pipeline.git
cd video-pipeline
pip install -r requirements.txt
cp .env.example .env # and fill in your secrets
python main.py
```
Requires Python 3.13+ and a mapped NAS directory (e.g., `Z:\2025.07.01\montages`).
---
### 📁 Folder Structure
```
Z:\
└── YYYY.MM.DD\
├── hits\
├── misses\
├── montages\
├── outtakes\
└── rendered\
```
Each clip gets processed into a full video with overlays, metadata, and upload instructions. Vertical clips are suffixed with `-vert`.
---
### 📚 Wiki Map
* [`Setup Guide`](./Setup-Guide)
* [`Rendering Engine`](./Rendering-Engine)
* [`YouTube Uploading`](./Uploading)
* [`Metadata Handling`](./Metadata)
* [`Social Automation`](./Social-Automation)
* [`Troubleshooting`](./Troubleshooting)
---
### 🧪 Project Status
| Version | Status | Notes |
| ------- | ---------- | -------------------------------------------- |
| v0.1.1 | ✅ LIVE | YouTube uploads, dynamic titles/descriptions |
| v0.1.2 | ⏳ Building | PeerTube support, clip upload pipeline |
| v0.2.0+ | 🧠 Planned | Social posting, metadata dashboard |
> Maintained by **[gramps@llamachile.shop](mailto:gramps@llamachile.shop)**. Built with ❤️ and Python.