Note
Rooster was created for the sole purpose of archiving roosterteeth.com, now, a dead website onced loved by millions. Rooster served its purpose to archive everything rooterteeth.com had and now getting itself archived. Who knows if it might come back from dead if anythink I like is in danger, lets hope not, shall we?
❯ pip3 install git+https://github.com/i3p9/rooster.git
- ffmpeg
Input: Accepts 3 kinds of inputs
link.txt
-> A collection of Roosterteeth Episode links, seperated by new line.- Series Link -> Processes an entire series
- Season Link -> Processes an entire season of a series
- Episode Link -> Processes an episode
--email
and--password
| while RT supports downloading without Login but a logged in session is less likely to be throttled or rejected.- Usage Type:
--show
: used for downloading. Uses a opinionated folder and file structure. (recommended)--archivist
: downloads in a basic ossafe filename structure. (not recommended)
--fast-check
: Checks for duplicate downloads in a much faster way, runs locally. Note: You need to run the script in the same location every time to--fast-check
work.
--random
: When passing a list of urls in text file, it randomizes the list order--skip-corrupt-fragments
: Default: True- Abort and skip to the next download if any of the fragments are corrupted during download
- It's advisable not to use this, you can use it if you want to salvage a incomplete video file.
--fragment-retries
Default: 10- How many times to retry if a individual fragment download fails. Default is set to 10. It's good enough but if you are downloading from a network/host with spotty network it wouldn't hurt to increase it.
--concurrent-fragments
: Default: 10- How many concurrent fragments to download a file with. If you are facing slower download speeds you could increase the default value and see if anything changes.
Downloads form a list of links and uploads to IA. Deletes the files after successful uploads.
# downloading complete series
rooster --email "[email protected]" --password "pass" --show --fast-check https://roosterteeth.com/series/gameplay
# downloading a specific season
rooster --email "[email protected]" --password "pass" --show --fast-check https://roosterteeth.com/series/funhaus-live?season=2
# downloading from a list of urls
rooster --email "[email protected]" --password "pass" --show --fast-check links.txt
The intention of this document is to make it very easy for those with little or no experience using scripts or PowerShell to understand and use Rooster for downloading videos from roosterteeth.com in a standardized fashion as decided by folks of the Archive of Pimps Discord server.
NOTE: It is a good idea (and sometimes necessary) to close and reopen PowerShell after installing items.
Any text in code blocks like this
are meant to be input into the PowerShell terminal.
-
Run PowerShell as Administrator, by pressing Windows + X, and choosing "Powershell (Adminstrator)". It might also be labeled "Terminal (Administrator)".
-
Install Chocolatey: (adapted from https://chocolatey.org/install) 1. First, ensure that you are using Powershell (Administrator) as discussed in the previous step. 2.
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
Paste the copied text into your shell and press Enter. Wait a few seconds for the command to complete. If you don't see any errors, you are ready to use Chocolatey! Type choco or choco -? now, or see Getting Started for usage instructions. -
Restart Powershell and reopen as Admin
-
Install Python by typing this line into PowerShell:
choco install python
For more help, check here: https://docs.python-guide.org/starting/install3/win/#install3-windows
-
Make sure pip is installed:
py -m pip install -U pip
-
Then install setuptools
pip install setuptools
-
Restart Powershell and reopen as Admin
-
Install Git via Chocolatey (source: https://community.chocolatey.org/packages/git.install#install)
choco install git.install
-
Restart Powershell and reopen as Admin
This is not in PowerShell, open your browser and open the link below. Then click the appropriate button for Windows, Linux or Mac.
If you don't know which one you want, you probably want Windows x64
Download an archive with ffmpeg, ffplay and ffprobe from here: https://github.com/yt-dlp/FFmpeg-Builds#ffmpeg-static-auto-builds
- Unzip the folder and copy all three .exe from bin folder
- Paste the three .exe files in C:\Python312\Scripts
How to install Rooster (edited from this Discord post)
-
Restart PowerShell and reopen as Admin
-
Within Powershell type either
pip3 install git+https://github.com/i3p9/rooster.git
-OR-pip install git+https://github.com/i3p9/rooster.git
-
If you already have it installed you may use either of the following commands to upgrade the current installation:
pip3 install git+https://github.com/i3p9/rooster.git -U
-OR-pip install git+https://github.com/i3p9/rooster.git -U
- Open a folder
- Hold shift and right click, in the context menu, and select "open PowerShell here"
alternatively. open PowerShell and
use the "cd" command to change directory:
`cd
C:Users\Username\Videos\RoosterTeeth`
- Optional - create a textfile "filelist.txt" (the name does not matter) to dump links into for the script to reference. When you see "filelist.txt" in the command this is the file its referencing.
The Discord has lists of links to work on.
-
Once in PowerShell, run the script using this line, changing your email and password as necessary (keep the quotation marks)
rooster --email "[email protected]" --password "your-password" --show url or filelist.txt
-
It will download the files in a new folder, from where you ran it from along with all necessary data.
-
You can either put a url: https://roosterteeth.com/watch/xxx (must be episode url, not season url) Or a list of links, e.g. funhaus_first.txt which contains a list of all funhaus first episodes. For this project, we are assigning groups of videos by text file, so use those.
Examples:
❗❗❗ This should be the command you use if you're helping with the archive project: ❗❗❗
rooster --email "[email protected]" --password "sargesucks2" --show rwby_links.txt
This example is only for archiving individual videos or shows. You can use it, but for archiving with us please use the above line.
rooster --email "[email protected]" --password "sargesucks2" --show https://roosterteeth.com/watch/so-alright-2024-sa29
If using a list of files, (e.g. filelist.txt
) it must be in your current working directory. (type pwd
if you're not sure where you are)
--show
: Assumes show mode, which will download the episode to their respective show folder.
❗❗❗
--show
is required if you want to contribute your downloads to the Archive of Pimps project. ❗❗❗
--concurrent-fragments XX
: Where XX
is a number, this determines how many concurrent fragments you will download at a time from Rooster Teeth's website. Default is 10.
--fast-check
: Checks if the program has already downloaded and uploaded a video to archive.org, and if so, skips it.
--ia
: triggers uploading to archive.org. By default, this also deletes the download on the local system after uploading.
--concurrent-fragments XX
: Where XX
is a number, this determines how many concurrent fragments you will download at a time from Rooster Teeth's website. Default is 10.
--fast-check
: Unknown
--keep-uploads
: retains a local copy of uploaded content.
NOTE:
--keep-uploads
uses a different file structure than the local downloader (--show
), so it is not suitable for local backup. Its ideal usecase is if your archive.org uploads fail often.
--i
: Ignore existing uploaded items. Works in the same way as tubeup's --ignore-existing-item
— if a file is missing on a upload, you can re-run the problem link with -i
to fill in the gaps. Only works with uploads on YOUR account.
NOTE: only use this if your archive.org uploads have failed, or are missing files. Never use when running the script for the first time.
Other parameters:
--update-meta
: Optional: If you notice problems with your METADATA on archive.org only, then run this. DO NOT bulk update your archives, only use this flag for problem links.
--use-aria
: uses aria2 to download using an alternate fragmenting utility. From our testing, this does not result in faster speeds than default - in fact, it is usually slower.
--fragment-retries XX
: Where XX
is a number, this determines how many times each video fragment will retry downloading after failing. If your connection is spotty or your downloads keep failing, adding this argument might help.
--skip-corrupt-fragments
: Setting that allows the program to continue if rooster fails to download all fragments of a video. By default, rooster will stop if it cannot download a fragment correctly.
README.md
written by @schmintendo and @c3someran, based on @snakepeeker's initial tutorial
♡RT♡