How beyondtahir/beyondgtaclips works
Beyond GTA Clips is a local stream-to-short-video tool, operated through a command-line workflow that can also be guided by an AI assistant. The user finds and selects streams, then the pipeline analyzes each stream, identifies clip moments, and produces vertical reels with captions and posting notes. The README documents five editing styles and self-check images; the sampled source shows the rendering modules but not every style implementation. External-service links are limited to documented or excerpt-supported behavior.
Main entry points: produce.py Clip production · pipeline.py Stream pipeline · cli.py CLI commands · discover.py Stream discovery
Components 21
Find streams
- Stream discovery
scripts/bgt/discover.py
Analyze and select
- Stream pipeline
scripts/bgt/pipeline.py - Stream media
scripts/bgt/media.py - Audio and chat
scripts/bgt/listen.py - Moment selection
scripts/bgt/highlights.py - AI assistants
scripts/bgt/brains.py
Create reels
- Clip production
scripts/bgt/produce.py - Frame analysis
scripts/bgt/frame.py - Reel styles
scripts/bgt/templates.py - Graphics and captions
scripts/bgt/art.py - Title cards
scripts/bgt/titlecard.py
Command and runtime
- CLI commands
scripts/bgt/cli.py - Script entry
scripts/beyondgtaclips.py - Clip settings
scripts/bgt/settings.py - Shared helpers
scripts/bgt/common.py
Other components
- Clip creator
- YouTube
- Installed assistant
- FFmpeg tools
- Finished reels
- Posting notes
Connections 21
- Clip creator → Script entry: runs
README.md - Script entry → CLI commands: starts
scripts/beyondgtaclips.py - CLI commands → Clip settings: loads settings
scripts/bgt/cli.py - CLI commands → Stream discovery: finds streams
scripts/bgt/cli.py - Stream discovery → YouTube: searches
scripts/bgt/discover.py - CLI commands → Stream pipeline: processes selection
scripts/bgt/cli.py - Stream pipeline → Stream media: fetches media
scripts/bgt/pipeline.py - Stream pipeline → Audio and chat: analyzes audio
scripts/bgt/pipeline.py - Stream pipeline → Moment selection: selects moments
scripts/bgt/pipeline.py - Stream pipeline → Clip production: builds clips
scripts/bgt/pipeline.py - Moment selection → AI assistants: requests picks
scripts/bgt/highlights.py - AI assistants → Installed assistant: invokes optionally
scripts/bgt/brains.py - Clip production → Frame analysis: analyzes frames
scripts/bgt/produce.py - Clip production → Reel styles: renders styles
scripts/bgt/produce.py - Reel styles → Graphics and captions: draws graphics
scripts/bgt/templates.py - Clip production → Audio and chat: uses transcript
scripts/bgt/produce.py - Clip production → Stream media: fetches clip parts
scripts/bgt/produce.py - Clip production → FFmpeg tools: encodes video
README.md - Clip production → Finished reels: writes reels
README.md - Stream pipeline → Posting notes: writes notes
scripts/bgt/pipeline.py - Title cards → Shared helpers: uses helpers
scripts/bgt/titlecard.py