Table of Contents

🚀 Getting Started with the LCS Video Pipeline

📦 Project Structure
🛠️ Prerequisites
▶️ Running the Pipeline
🔧 Configuration Notes
✍️ Contributing
🧩 FAQ

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

🚀 Getting Started with the LCS Video Pipeline

Welcome to the Llama Chile Shop (LCS) Video Pipeline — a fully automated content processing tool designed to streamline video highlight extraction, rendering, and upload for livestream content. This system powers Gramps’ Fortnite highlight reels and Shorts across YouTube, PeerTube, and social platforms.

📦 Project Structure

.
├── assets/               # Brand assets like intros, outros, fonts, logos
├── modules/              # Core processing logic (rendering, titling, uploads)
├── tests/                # Unit and integration tests
├── docs/                 # Documentation and references
├── .env                  # Secrets (excluded from Git)
├── main.py               # Entry point for the pipeline
├── video-pipeline.wiki/  # This wiki repo
└── 2025.06.20/           # Example session data

🛠️ Prerequisites

Python 3.13+

Virtual environment

python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt

.env file setup See .env.example for all required tokens and credentials. You’ll need:
- OpenAI key
- YouTube credentials
- Mastodon and Bluesky tokens
- Playlist IDs
- Path to client_secrets.json

▶️ Running the Pipeline

Place your Eklipse-extracted clips in a new session folder:
```
C:\Users\alpha\code\Python\lcs_agent_clean\2025.08.04\
```
Organize them under one of:
- hits/
- misses/
- montages/
- outtakes/
Run the main script:
```
python main.py
```
Finalized videos are exported to:
```
rendered/
```

🔧 Configuration Notes

All NAS paths have been transitioned to a local path:
```
C:\Users\alpha\code\Python\lcs_agent_clean\
```
GitHub, OpenAI, and Google API keys are now loaded from .env
The wiki system is managed via Git submodules

✍️ Contributing

This repo is actively maintained by the LCS Dev Team (Gramps + GPT).

If you're looking to contribute:

Keep PRs tight and focused
Adhere to Fortnite-style branding (color, font)
All commits must use this format:
```
🔧 Component: Short Summary
```

🧩 FAQ

Q: Can I add more formats (e.g. TikTok, Instagram)? A: Planned for v0.3.x

Q: Can this be used with non-Fortnite games? A: Absolutely. The pipeline is content-agnostic.

Q: Where is the full documentation? A: You’re looking at it — more pages coming soon.