Ganymede
Self-hosted Twitch VOD and live stream archiver with real-time chat playback, full WebUI management, and Docker deployment.
Smart Download
Visit Project Homepage
No installer available yet — head to the source repository
Self-host Twitch VOD & live archiver with real-time chat replay and WebUI.
Core Features
- Real-time chat playback: sync chat with VOD or live stream, rendered as separate video file
- Automatic channel watching: set watched channels to archive future broadcasts and livestreams with filters
- Complete management: manage channels, users, archives, playlists, and playback progress via WebUI
- Friendly file structure: video + JSON chat stored in standard format, viewable without Ganymede
- Custom processing: FFmpeg post-processing parameters, chat render styles, webhook notifications
What It Can't Do
- •Large storage required: at least 50GB free; active archiving consumes more. 2. Must have Twitch developer application: register on dev.twitch.tv for Client ID and Secret. 3. Default password security: change admin password immediately after first login. 4. Limited Chinese UI: translation files need manual addition. 5. Docker-only: requires Linux or WSL2; not supported on Windows natively.
Use Cases
- Twitch streamers or viewers to permanently archive streams with chat interaction
- Content creators downloading Twitch footage for editing while preserving chat overlay
- Archiving enthusiasts building a private video library for multiple channels
Detailed Introduction
Ganymede is a self-hosted platform for archiving Twitch VODs (past broadcasts) and live streams, featuring synchronized real-time chat playback. It provides a full WebUI for managing archives, channels, and users, with automatic watching of channels for new content. All files are saved in a standard format (video + JSON chat) so they can be viewed without Ganymede. It includes advanced features like SSO/OAuth authentication, custom FFmpeg parameters for post-processing, webhook notifications, and a recoverable queue system. Built with two Docker containers (server + Postgres), it requires a Linux environment and a Twitch application for API access. The project is actively maintained with regular releases and comprehensive wiki documentation.
Troubleshooting & FAQ (1)
TroubleshootingHow to fix 'unsupported protocol scheme ""' error when running Fetch JWKS task?
The error occurs because the OAUTH_PROVIDER_URL environment variable is empty or missing the protocol scheme. Set OAUTH_PROVIDER_URL to a valid URL starting with http:// or https:// (e.g., https://sso.example.com). Restart the container after updating the variable.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Step 1: Install Docker and Docker Compose on a Linux server.
Step 2: Download docker-compose.yml from GitHub, edit environment variables (DB config, Twitch client ID/secret).
Step 3: Run 'docker compose up -d' to start services.
- Step 1: Install Docker and Docker Compose on a Linux server.
- Step 2: Download docker-compose.yml from GitHub, edit environment variables (DB config, Twitch client ID/secret).
- Step 3: Run 'docker compose up -d' to start services.
Checksum not available
This project has not published a SHA-256 checksum on its GitHub Release page
SHA256 Checksum
No checksum available
Download directly from GitHub Releases and verify file integrity yourself
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Stop containers: docker compose down. Remove data directory (default /data). Optionally delete Docker images and volumes.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
1 FAQ
Similar Projects
yt-dlp
A feature-rich command-line audio/video downloader supporting thousands of sites. Fast, reliable, and actively maintained fork of youtube-dl.
MoneyPrinterTurbo
An open-source tool that uses AI LLMs to automatically generate high-quality short videos from a topic or keyword.
obs-studio
Free and open-source software for video recording and live streaming. High performance, real-time capture, compositing, encoding, and broadcasting.