From 81b9571736254c89a4fc03d74d85576b4d4971ff Mon Sep 17 00:00:00 2001 From: Gramps Date: Thu, 7 Aug 2025 10:30:52 -0700 Subject: [PATCH] Updated Home (markdown) --- Home.md | 88 +++++++++++++++++++++++++++++++++------------------------ 1 file changed, 51 insertions(+), 37 deletions(-) diff --git a/Home.md b/Home.md index 60cdbe8..59a71de 100644 --- a/Home.md +++ b/Home.md @@ -1,70 +1,84 @@ -## ๐Ÿฆ™ LCS Pipeline: Automated Video Highlights with Gramps +# ๐ŸŽฎ LCS Pipeline -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. +**Automated livestream highlight rendering and publishing for Fortnite content featuring Gramps.** -Everything's tuned for Gramps-style: ๐Ÿ’ฅ fast, ๐Ÿคฃ funny, and ๐ŸŒŸ hands-off. +This project powers the backend of [[Llama Chile Shop](https://www.youtube.com/@llamachileshop)](https://www.youtube.com/@llamachileshop), transforming raw livestream clips into polished, uploaded videos โ€” complete with titles, thumbnails, intros/outros, and social metadata. --- -### ๐ŸŽฎ Key Features +## โš™๏ธ 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) +* โœ… Daily folder scan for new stream sessions *(2025-07-10)* \[`v0.1.0`] +* ๐ŸŽฎ Clip classification (`hits/`, `misses/`, `montages/`, `outtakes/`, `timelapses/`) *(2025-08-07)* \[`v0.1.2`] +* ๐Ÿง  AI-generated titles and descriptions via OpenAI *(2025-07-10)* \[`v0.1.0`] +* ๐Ÿช„ Auto-stitched intro + title card + outro *(2025-07-23)* \[`v0.1.0`] +* ๐Ÿ–ผ๏ธ Dynamic thumbnail creation with Fortnite styling *(2025-07-25)* \[`v0.1.0`] +* โฌ†๏ธ Uploads to YouTube *(2025-07-29)* and PeerTube *(2025-08-07)* \[`v0.1.1` & `v0.1.2`] +* ๐Ÿ—พ Metadata archive and session history *(2025-07-26)* \[`v0.1.0`] +* ๐Ÿ˜ (Planned) Social posts to Mastodon and Bluesky *(2025-07-20)* \[`v0.2.0`] --- -### ๐Ÿš€ Quick Start +## ๐Ÿš€ 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 +cp .env.example .env # Fill in your API keys and config python main.py ``` -Requires Python 3.13+ and a mapped NAS directory (e.g., `Z:\2025.07.01\montages`). +> Requires Python 3.13+ and access to mapped NAS directory (e.g. `Z:\2025.08.05\hits\`). --- -### ๐Ÿ“ Folder Structure +## ๐Ÿ—‚๏ธ Folder Structure ``` -Z:\ -โ””โ”€โ”€ YYYY.MM.DD\ - โ”œโ”€โ”€ hits\ - โ”œโ”€โ”€ misses\ - โ”œโ”€โ”€ montages\ - โ”œโ”€โ”€ outtakes\ - โ””โ”€โ”€ rendered\ +video-pipeline/ +โ”œโ”€โ”€ main.py +โ”œโ”€โ”€ config.py +โ”œโ”€โ”€ .env.example +โ”œโ”€โ”€ modules/ +โ”‚ โ”œโ”€โ”€ render_engine.py +โ”‚ โ”œโ”€โ”€ title_utils.py +โ”‚ โ”œโ”€โ”€ thumbnail_utils.py +โ”‚ โ”œโ”€โ”€ yt_poster.py +โ”‚ โ””โ”€โ”€ ... +โ”œโ”€โ”€ assets/ # Branding assets (intros, fonts, logos) +โ”œโ”€โ”€ logs/ # Sync logs, wiki publish logs, etc. +โ””โ”€โ”€ metadata/ + โ””โ”€โ”€ history/ # Per-clip metadata archive ``` -Each clip gets processed into a full video with overlays, metadata, and upload instructions. Vertical clips are suffixed with `-vert`. +--- + +## ๐Ÿ“š Documentation + +Full documentation is hosted in the GitHub Wiki: +๐Ÿ‘‰ [[๐Ÿ“– LCS Pipeline Wiki](https://github.com/LCS-Gramps/video-pipeline/wiki)](https://github.com/LCS-Gramps/video-pipeline/wiki) + +Recommended pages: + +* [`[Home](https://github.com/LCS-Gramps/video-pipeline/wiki)`](https://github.com/LCS-Gramps/video-pipeline/wiki) +* [`[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) +* [`[Metadata Extraction](https://github.com/LCS-Gramps/video-pipeline/wiki/Metadata-Extraction)`](https://github.com/LCS-Gramps/video-pipeline/wiki/Metadata-Extraction) +* [`[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) --- -### ๐Ÿ“š Wiki Map +## ๐Ÿงช Development Mode -* [`Setup Guide`](./Setup-Guide) -* [`Rendering Engine`](./Rendering-Engine) -* [`YouTube Uploading`](./Uploading) -* [`Metadata Handling`](./Metadata) -* [`Social Automation`](./Social-Automation) -* [`Troubleshooting`](./Troubleshooting) +* `DEBUG=True` in `.env` disables destructive operations +* All modules can be run/tested independently +* Wiki editing is supported via local Markdown and `wiki_publish.log` --- -### ๐Ÿงช Project Status +## ๐Ÿง™ About -| 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 | +Created by **Gramps** for Llama Chile Shop โ€” a custom content pipeline for old-school gaming chaos. -> Maintained by **[gramps@llamachile.shop](mailto:gramps@llamachile.shop)**. Built with โค๏ธ and Python. +> Maintainer: `gramps@llamachile.shop` +> Contributions welcome in the form of bug reports, pull requests, or Fortnite gifts. ๐Ÿฑ \ No newline at end of file