Skip to content

bumbummen99/southparkdownloader

Repository files navigation

Important Notice

Several years ago, I created this software as a personal project to learn C# and provide a downloader for south-park.de. While there were existing solutions, they lacked necessary features such as handling dependencies and merging episode parts. While this project was a great learning experience for me, I am no longer actively using the language and do not have the time to maintain it. Additionally, the code was written from scratch with limited experience in C#, resulting in suboptimal code that increased complexity and maintenance requirements.

While South Park was widely available on streaming platforms such as Amazon Prime and Netflix, it has now become a Paramount+ exclusive, sparking the so called "streaming wars." As a long-time fan of the show, I cannot support Paramount+ due to the following reasons:

  • It is/was unavailable in my location
  • It is limited to 720p low bitrate on anything else than a native player with DRM

These limitations are not acceptable to me in regards to a service that i do have to pay for monthly. Therefore, I have decided to re-activate this project with a complete re-write in TypeScript and using Docker for simple dependency management and cross-platform compatibility. The new version of South Park Downloader can be found in its new repository.

Please note that this repository will no longer be actively developed or maintained. However, I will still try to assist with issues and encourage users to try the new version. Thank you for your understanding.

SouthPark Downloader

Build Seasons NetCore Homepage

A small C# application to download all episodes from southpark.de using ffmpeg and youtube-dl. Feel free to kep the index up-to-date by creating a pull-request.

Important

This software is just a fancy wrapper around YouTubeDL and FFMPEG specifically created to download episoded from SouthPark.de, correctly sort the part files, stitch them together losslessly and then create a final episode file with the correct media tags and filename. This software does depend on the functionality of YouTubeDL and FFMPEG, YouTubeDL can break anytime due to it's nature in being dependet itself on the site you are trying to download from i.e. if SouthPark.de changes YouTubeDL can be incompatible. For these situations you might want to use the YouTubeDL Community Fork, a fork that incorporates fixes for YouTubeDL much faster. You can add the parameter ytdlc to the startup of SouthParkDL in order to use YouTubeDL Community instead of the official version on Windows. For other platforms, please follow the installation notes (just replace youtube-dl with youtube-dlc).

Requirements

Installation

Windows

The software requires Latest VC Redist x64 and x86 to be installed in order to function properly. Simply unzip the latest release and run the included executable, the software will automatically download and install its dependencies (portable) including youtube-dl and ffmpeg.

You can also use the GUI package which provides an easy to use installer and user interface.

Linux

You need to install ffmpeg and youtube-dl manually as the software depends on it.

sudo apt-get install ffmpeg youtube-dl

Download the latest release for your operating system and unzip it. You can run the software with the following command:

./SouthParkDownloaderNetCore

OSX

You need to install ffmpeg and youtube-dl as the software depends on it.

Download the latest release for your operating system and unzip it. You can run the software with the following command:

./SouthParkDownloaderNetCore

Commands

Most of the time the download command will be enough as it will download the episode parts and merge the resulting video files during process for you.

If you encounter any issues while downloading / merging an episode the programm should continue fine. You can run the command download again to redownload incomplete episodes or process to merge unmerged parts.

If you don't encounter any bugs there is no need to update the software every time you use it, you should definitely if you are going for a full download. In order to update the episode list / database simply use the command index update. If the current index is broken or outdated (which i hope is not) you can fix the index file manually and re-index it with the command index.

download

Downloads all episodes in the episodes list. The command will download all parts and merge them accordingly, deleting unecessary files.

process

Merges unmerged video parts. Use this command if the software encounters a problem during the download process.

index

Reloads the index by reading the local index file.

index update

Replaces the local index with an up-to-date version from this repository and reloads it.

Collaborators

bumbummen99
Patrick

Contributors

bumbummen99
Patrick
PPrzemko
TheWhiteSheep
NicoVIII
NicoVIII
TH42
TH42