OpenSource-Hub
G

Ganymede

951 stars·Video & Audio Download·SHA-256 checksum verified

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)

Troubleshooting
How 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.

GitHub Issue #1148

Tags

TwitchVOD直播存档聊天回放Docker

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Install Docker and Docker Compose on a Linux server.

4

Step 2: Download docker-compose.yml from GitHub, edit environment variables (DB config, Twitch client ID/secret).

5

Step 3: Run 'docker compose up -d' to start services.

Install Guide
  1. Step 1: Install Docker and Docker Compose on a Linux server.
  2. Step 2: Download docker-compose.yml from GitHub, edit environment variables (DB config, Twitch client ID/secret).
  3. Step 3: Run 'docker compose up -d' to start services.
File Integrity

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 Source
Environment Guide

Uninstall 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.

Project Info
LicenseAGPL-3.0
Last Updated2026-06-27 10:55:16
GitHub Repository

Having issues? Check the FAQ below

1 FAQ

Similar Projects