TwitchRipper is a Python script that automatically downloads Twitch streams, archives VODs, and posts live notifications to Discord.
- Automatically detects when a Twitch channel goes live
- Downloads streams live using Streamlink
⚠️ Note: Only download the broadcast if the streamer you are archiving uses two different audio tracks for broadcasts and VODs.
- Downloads VODs and chat using TwitchDownloaderCLI
- Merges broadcast and VOD audio with FFmpeg
- Sends notifications and updates to a Discord webhook
- Downloads VODs before they can be muted or deleted.
- Python 3.13+
- Streamlink
- FFmpeg
- TwitchDownloaderCLI
All Dependencies must be installed and the path linked in the corresponding variable in the script.
- Download
TwitchRipper.pyfrom the repository. - Install Python 3.13+ and the required tools:
- Edit the script variables to configure the channel, Twitch token, output folder, etc.
- To run the script type "python TwitchRipper.py" in a terminal window.
TwitchRipper combines the best features of similar tools like StreamRecorder, TwitchDownloader, and TwitchLink.
⚠️ Note: This script uses a lot of storage and works best on a computer running 24/7.
1 hour of a 1080p60fps stream ≈ 2.5GB.
Example of archived streams (~35 streams ≈ 385GB):
| Comparison of Different Twitch Stream Downloading Tools | ||
|---|---|---|
| Tool | Pros | Cons |
| TwitchRipper |
- Downloads broadcast and VOD - Merges the broadcast and VOD into one .mkv - Locally Hosted - Downloads chat as JSON automatically - Discord notifications for streams - No ads (needs sub or proxy) |
- You're gonna need alot of storage (You probably already do if you're archiving Twitch streamers) - Needs a computer running 24/7 - Needs good internet speed |
| StreamRecorder |
- Gets other services than Twitch - Records broadcasts - Broadcasts become unavalible after 7 days |
- Doesn't get VOD - $10 a month - 720p60fps |
| TwitchDownloader and Twitch Link |
- Downloads VODs - Downloads chat - Able to render chat |
- Doesn't download broadcasts - Not automatic |


