gramps/video-pipeline
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updated Home (markdown)

Gramps
2025-08-07 10:30:52 -07:00
parent 243119fb5b
commit 81b9571736
1 changed files with 51 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

88
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** * ✅ Daily folder scan for new stream sessions *(2025-07-10)* \[`v0.1.0`]
* 🎬 **Auto-rendered highlight reels** (vertical & widescreen) * 🎮 Clip classification (`hits/`, `misses/`, `montages/`, `outtakes/`, `timelapses/`) *(2025-08-07)* \[`v0.1.2`]
* 🧠 **AI-generated video titles + descriptions** * 🧠 AI-generated titles and descriptions via OpenAI *(2025-07-10)* \[`v0.1.0`]
* 🪄 **Intro/outro stitching + title cards** * 🪄 Auto-stitched intro + title card + outro *(2025-07-23)* \[`v0.1.0`]
* 🖼️ **Branded YouTube thumbnails** * 🖼️ Dynamic thumbnail creation with Fortnite styling *(2025-07-25)* \[`v0.1.0`]
* ☁️ **Uploads to YouTube + PeerTube** * ⬆️ Uploads to YouTube *(2025-07-29)* and PeerTube *(2025-08-07)* \[`v0.1.1` & `v0.1.2`]
* 📣 **Social posts to Mastodon and Bluesky** (coming soon) * 🗾 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 ```bash
git clone https://github.com/LCS-Gramps/video-pipeline.git git clone https://github.com/LCS-Gramps/video-pipeline.git
cd video-pipeline cd video-pipeline
pip install -r requirements.txt 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 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:\ video-pipeline/
└── YYYY.MM.DD\ ├── main.py
├── hits\ ├── config.py
├── misses\ ├── .env.example
├── montages\ ├── modules/
├── outtakes\ │ ├── render_engine.py
└── rendered\ │ ├── 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) * `DEBUG=True` in `.env` disables destructive operations
* [`Rendering Engine`](./Rendering-Engine) * All modules can be run/tested independently
* [`YouTube Uploading`](./Uploading) * Wiki editing is supported via local Markdown and `wiki_publish.log`
* [`Metadata Handling`](./Metadata)
* [`Social Automation`](./Social-Automation)
* [`Troubleshooting`](./Troubleshooting)
--- ---
### 🧪 Project Status ## 🧙 About
| Version | Status | Notes | Created by **Gramps** for Llama Chile Shop — a custom content pipeline for old-school gaming chaos.
| ------- | ---------- | -------------------------------------------- |
| 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. > Maintainer: `gramps@llamachile.shop`
> Contributions welcome in the form of bug reports, pull requests, or Fortnite gifts. 🏱