diff --git a/Home.md b/Home.md index dee43d1..fefcb30 100644 --- a/Home.md +++ b/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 ๐Ÿฉ* \ No newline at end of file +### ๐ŸŽฎ 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.