Skip to content

Latest commit

 

History

16 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

TwitchRipper

TwitchRipper is a Python script that automatically downloads Twitch streams, archives VODs, and posts live notifications to Discord.


Features

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

Dependencies

All Dependencies must be installed and the path linked in the corresponding variable in the script.


How to use

  1. Download TwitchRipper.py from the repository.
  2. Install Python 3.13+ and the required tools:
  3. Edit the script variables to configure the channel, Twitch token, output folder, etc.
  4. To run the script type "python TwitchRipper.py" in a terminal window.

Why TwitchRipper?

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

About

A CLI tool that rips the broadcast and VOD from a Twitch stream and turns it into one file.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages