Files
video-pipeline/README.md
2025-08-12 00:48:01 +00:00

3.9 KiB
Raw Blame History

LCS Video Pipeline Wiki

Welcome to the LCS Video Pipeline documentation!
This wiki is the living source of truth for the project — workflows, automation scripts, branding guidelines, and everything else that keeps the pipeline running smoothly.


📑 Table of Contents


Overview

The LCS Video Pipeline automates the transformation of raw livestream recordings into fully branded, published videos on YouTube and PeerTube — with minimal manual effort.
Its built to be fast, flexible, and scalable.


Project Goals

  • Full Automation Minimize manual intervention in video processing and uploads.
  • Brand Consistency Apply intros, outros, titles, and descriptions according to predefined rules.
  • Platform Flexibility Publish to multiple platforms without extra steps.
  • Metadata Tracking Maintain a detailed archive of uploads, formats, and performance data.

Core Components

  1. Video Processing Handles clip trimming, intro/outro insertion, title card generation, and format adjustments.
  2. Metadata Generation Pulls session data and user notes into dynamic titles and descriptions.
  3. Publishing Uploads to YouTube, PeerTube, and optionally Mastodon/Bluesky.
  4. Branding Assets Logos, fonts, and color palettes for consistent look-and-feel.
  5. Automation Scripts Python modules that orchestrate the entire pipeline.

Workflow Summary

  1. Clip Intake Source files are added to the hits/, misses/, montages/, or outtakes/ folders.
  2. Brand Application The system injects title cards, branding assets, and date stamps.
  3. Rendering Produces both widescreen (16:9) and vertical (9:16) versions where applicable.
  4. Upload & Publish Posts videos to target platforms with optimized descriptions and hashtags.
  5. Archive Updates the metadata repository for auditing and analytics.

Branding Guidelines

  • Main Font: Fortnite-style font (Burbank Big Condensed Black)
  • Main Colors:
    • Pink: #f7338f
    • Aqua: #10abba
    • Dark Shadow: #1c0c38
  • Logo: Brand llama (LlamaLlama.png) used on all thumbnails.

Automation Scripts

Key helper scripts include:

  • render_engine.py Builds final videos with intros, titles, and outros.
  • title_utils.py Generates title cards dynamically.
  • yt_poster.py Handles YouTube uploads.
  • pt_poster.py Handles PeerTube uploads.
  • sync_wiki.py Pushes updated wiki pages to the repository.
  • discovery.py Detects new session folders for processing.

Contributing

Pull requests are welcome on the llgit repository.
Please follow the established coding style and commit message conventions.


License

This project is licensed under the MIT License.


📚 Site Index

Heres a quick jump list to all wiki pages: