VodRecovery

• The purpose of this script is to obtain videos or clips that are either marked as "sub-only" or have been deleted on Twitch.

About

• Developed by: Shishkebaboo (formerly ItIckeYd, the original developer who is back to work on the project after a hiatus)
• Initial release: May 3rd, 2022
• The script leverages logic from the TwitchRecover repository developed by Daylam Tayari

Features

• Supports both manual and website vod recovery
• Can recover vods individually or in bulk using a CSV downloaded from Sullygnome
• Can recover clips manually or in bulk using a CSV from Sullygnome
• Supports downloading M3U8 links/files, with the ability to specify start/end timestamps for trimmed vods using FFmpeg
• Compatible with TwitchTracker, Sullygnome, and Streamscharts
• Uses UTC timezone as default for recovering vods
• Notifies if vod is older than 60 days (due to Twitch's deletion process)

Installation

• Download/install - Python
• Clone the repository
• Navigate to the cloned directory
• Install required packages with pip install -r requirements.txt (run in terminal)
• If you make changes to installed packages locally, you can overwrite the requirements.txt file with pipreqs <path_of_project> --force
• Run the script

Expected Script Output

WELCOME TO VOD RECOVERY

1) Recover Vod
2) Recover Clips
3) Unmute an M3U8 file
4) Check M3U8 Segments
5) Generate M3U8 file (ONLY includes valid segments)
6) Download M3U8 (.MP4 extension)
7) Exit

Please choose an option:

Expected FFmpeg Ouput

• Run the ffmpeg command in Command Prompt

Configuration File

• The configuration file can be used to limit the amount of user input when using the script. The following options are among the most popular to change for users:

1. UNMUTE_VOD
2. CHECK_SEGMENTS
3. DOWNLOAD_CLIPS
4. REMOVE_LOG_FILE
5. DEFAULT_DIRECTORY
6. DOWNLOAD_DIRECTORY
7. MAX_REQUEST_SIZE

Default Configuration

Optional IDEs

• PyCharm Community Edition (recommended)
• Visual Studio Code

Additional Notes

• Provide at least one example when creating an issue
• If the script returns no results, try vods from other streamers. If the other vods return results, it is likely that the original vods don't exist.

Support the Project

• Donations are appreciated but not expected - PayPal

Latest Release

• Stable Release - 1.0.0.9
• For the most updated code, clone the main branch of the repository.