TwitchDownloader/README.md

Twitch Archive

Inspired by https://github.com/EnterGin/Auto-Stream-Recording-Twitch

Python script to check, download live stream, VOD, chat and upload them to any cloud storage supported by rclone.

⚡ FFmpeg 8.0 Enhanced

Now with FFmpeg 8.0+ support featuring hardware acceleration and performance improvements!

• 5-10x faster encoding with NVIDIA, Intel, or AMD GPUs
• Docker-ready with Linux builds
• Configurable options for different scenarios
• 📖 See FFMPEG_SETUP.md for detailed setup instructions

Requirements

• Python 3
• Streamlink
• FFmpeg 8.0+ (see FFMPEG_SETUP.md for platform-specific versions)

Getting started

1. Install Python 3.x
2. Install Streamlink 5.1.x
3. If you want to upload to any cloud storage using rclone, configure rclone.
4. git clone https://github.com/piero0920/Twitch-Archive.git
5. cd Twitch-Archive
6. pip install -r requirements.txt
7. Edit the .env.sample and rename it to .env

CLIENT-ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
CLIENT-SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
OAUTH-PRIVATE-TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # optional to record without ADS or download sub-only VODS

8. Copy config.sample.json to config.json and edit it with your settings (username, quality, paths, etc.)
9. run Python twitch-archive.py or for multiple streamers Python twitch-archive.py -u streamer

...