VodRecovery is a Python script designed to access Twitch videos and clips that are either restricted to subscribers or have been deleted.
Effective November 19th, 2023, the VodRecovery repository will be archived and no longer actively maintained. Due to this, I have disabled issues and discussions. This decision comes in light of the numerous issues and questions that are not directly related to the repository's code, but rather to changes in third-party websites (Twitch, TwitchTracker, Streamscharts, Sullygnome) it depends upon. These external factors are outside my control and make it impractical to provide consistent support or responses. The repository will remain accessible in a read-only format for archival and reference purposes. I appreciate everyone who has supported the repository and shown interest in improving it! Thanks for understanding.
- Author: Shishkebaboo
- Initial Release: May 3rd, 2022
- Influenced By: TwitchRecover by Daylam Tayari
- Video Recovery: Choose between manual or web-based VOD recovery options.
- Clip Recovery: Recover clips manually or via mentioned websites.
- Bulk Clip Recovery: Easily recover multiple clips using CSV files from Sullygnome.
- Random Clip Recovery: Retrieve a selection of random clips (3 clips per iteration).
- Multiple Formats: Recovered M3U8 links are available in various formats, including - chunked (Source Quality), 1080p60, 1080p30, 720p60, 720p30, 480p60, 480p30
- Platform Compatibility: VodRecovery is compatible with popular platforms such as TwitchTracker, Sullygnome, and Streamscharts.
- Default Timezone: The script uses UTC as the default timezone for recovering VODs.
- Video Expiry Duration: Receive a notification if a VOD is older than 60 days, helping you stay informed about content availability.
- Download and install Python.
- Clone this repository.
- Navigate to the project directory.
- Install the required packages:
pip install -r requirements.txt.
Run the script and follow the interactive menu:
1) VOD Recovery
2) Clip Recovery
3) Unmute M3U8 File
4) Verify Segment Availability
5) Create M3U8 File (Valid Segments Only)
6) Download M3U8 File (.MP4 Extension)
7) Help
8) Exit
The script uses multiple configuration files to minimize user input and tailor behavior. Descriptions of the settings in each file are provided below.
DEFAULT_DIRECTORY: The default directory where files are stored.DOWNLOAD_DIRECTORY: The directory where downloads are stored.
DOWNLOAD_M3U8_VIDEO_URL: Command for downloading M3U8 video URLs.DOWNLOAD_M3U8_VIDEO_URL_SLICE: Command for downloading a sliced portion of M3U8 video URLs.DOWNLOAD_M3U8_VIDEO_FILE: Command for downloading M3U8 video files.DOWNLOAD_M3U8_VIDEO_FILE_SLICE: Command for downloading a sliced portion of M3U8 video files.UNMUTE_VIDEO: A boolean value indicating if the video should be unmuted.CHECK_SEGMENTS: A boolean value enabling or disabling the segment checking feature.DOWNLOAD_CLIPS: A boolean value specifying whether clips should be automatically downloaded.REMOVE_LOG_FILE: A boolean value controlling the automatic removal of log files post-operation.
The help.json file provides descriptions of all main and sub-menu options. You can refer to this file to understand each option's functionality.
The domains.txt file contains a list of domains that the script uses to retrieve videos. Each line in this file represents a domain.
The user_agents.txt file contains a list of user agents that the script uses to scrape website data. Each line in this file represents a user agent string.
To use FFmpeg with the script, you'll need to install FFmpeg on your system. You can download FFmpeg from the official website here and follow the installation instructions for your operating system.
- Please note this repository does not accept any pull requests
- Provide examples when submitting issues.
- Ensure your Video requests comply with Twitch's Video Retention Policy.
