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.
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.
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).
- Latest VC Redist x64 and x86 (Windows)
- youtube-dl (Linux / OSX)
- ffmpeg (Linux / OSX)
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.
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
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
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
.
Downloads all episodes in the episodes list. The command will download all parts and merge them accordingly, deleting unecessary files.
Merges unmerged video parts. Use this command if the software encounters a problem during the download process.
Reloads the index by reading the local index file.
Replaces the local index with an up-to-date version from this repository and reloads it.
Patrick |
Patrick |
TheWhiteSheep |
NicoVIII |
TH42 |