SeanOMik
/
dropout-dl
mirror of https://github.com/SeanOMik/dropout-dl.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
67 Commits 1 Branch 0 Tags 235 KiB
C++ 96.3%
CMake 1.8%
C 1.4%
Dockerfile 0.5%
Go to file
Moss 00ab93dfbb
Episode: Fixed Support for HTML Character Codes in Title 		2022-12-23 02:17:50 -05:00
.github/ISSUE_TEMPLATE Issues: Added Templates 2022-09-29 23:16:29 -04:00
src Episode: Fixed Support for HTML Character Codes in Title 2022-12-23 02:17:50 -05:00
tests Tests: Updated Constructor Syntax 2022-09-30 23:47:32 -04:00
.gitignore Inital Commit 2022-09-10 20:19:41 -04:00
CMakeLists.txt CMake: Added 'DROPOUT_DL_BUILD_ALL' Option 2022-10-01 15:07:40 -04:00
LICENSE License: Added GNU General License 2022-09-29 18:10:35 -04:00
readme.md Readme: Updated for New Format and Options 2022-12-22 19:28:50 -08:00

readme.md

dropout-dl

dropout-dl is tool to download dropout.tv episodes. It can download single episodes, seasons, or full series.

Installation

How to Build

cmake -S <source-dir> -B <build-dir>
cd <build-dir>
make

Dependencies

Required

  • cURL - Required for downloading pages and videos.

Recommended

  • SQLite - Required for retrieving cookies from browsers. This can be avoided by using the --force-cookies option.

Optional

  • libgcrypt - Used for decrypting chrome cookies retrieved from the sqlite database.

Void

sudo xbps-install -S libcurl sqlite-devel libgcrypt

Debian

sudo apt install libcurl4-gnutls-dev sqlite-devel

How to Use

./dropout-dl [options] <url>

By default, dropout-dl will download episodes in a season with the format <series>/<season>/<series> - S<season-num>E<episode-num> - <episode-name>.mp4 and single episodes with the format <series>/<season>/<series> - <season> - <episode-name>.mp4.

Options

--help                   Display this message
--quality                Set the quality of the downloaded video. Quality can be set to 'all' which
                             will download all qualities and place them into separate folders
--output                 Set the output filename
--output-directory       Set the directory where files are output
--verbose                Display debug information while running
--force-cookies          Interpret the next to arguments as authentication cookie and session cookie
--series                 Interpret the url as a link to a series and download all episodes from all seasons
--season                 Interpret the url as a link to a season and download all episodes in the season
--episode                Interpret the url as a link to a single episode

If series, season, or episode is not used, the type will be inferred based on the link format.

Cookies

Firefox

Create a file named firefox_profile in the build directory and paste in your firefox profile folder path

Chrome

Install libgcrypt and create a file named chrome_profile in the build directory and paste in your chrome profile folder path (found on chrome://version)

Other/No Sqlite

Use the --force-cookies program option to manually input cookies.

TODO

  • Create tests
  • Handle non-alphanumeric characters
  • Test build process on other setups with other OSs.

Contributing

PRs Welcome

Issues

If you have any issues or would like a feature to be added please don't hesitate to submit an issue after checking to make sure it hasn't already been submitted. Using the templates is a good place to start, but sometimes they're overkill. For example, if the program segfaults for you, you don't need to state that the intended behaviour is to not segfault.

If you'd like to contribute a good place to start is looking at open issues and trying to fix one with a pull request.
Working on your first Pull Request? You can learn how from this free series How to Contribute to an Open Source Project on GitHub

Contributors