Readme: Updated Readme With Updated Cookie Information
Additionally, added contribution information.
This commit is contained in:
parent
e7eda7ca43
commit
5fea1190da
43
readme.md
43
readme.md
|
@ -1,8 +1,8 @@
|
|||
# dropout-dl
|
||||
a tool to download [dropout.tv](dropout.tv) episodes.
|
||||
A tool to download [dropout.tv](dropout.tv) episodes.
|
||||
|
||||
|
||||
## how to build
|
||||
## How to bBild
|
||||
```
|
||||
cmake -S <source-dir> -B <build-dir>
|
||||
cd <build-dir>
|
||||
|
@ -24,35 +24,17 @@ sudo apt install libcurl4-gnutls-dev sqlite-devel
|
|||
|
||||
## Cookies
|
||||
### Firefox
|
||||
#### Option 1 (requires sqlite-devel)
|
||||
Create a file named `firefox_profile` in the build directory and paste in your [firefox profile folder path](https://support.mozilla.org/en-US/kb/profiles-where-firefox-stores-user-data)
|
||||
#### Option 2 (requires sqlite)
|
||||
Close firefox and go to your [firefox profile folder](https://support.mozilla.org/en-US/kb/profiles-where-firefox-stores-user-data)
|
||||
```
|
||||
sqlite3 cookies.sqlite "SELECT value FROM moz_cookies WHERE host LIKE '%dropout.tv%' AND name='__cf_bm';" > <build-dir>/auth_cookie
|
||||
sqlite3 cookies.sqlite "SELECT value FROM moz_cookies WHERE host LIKE '%dropout.tv%' AND name='_session';" > <build-dir>/session_cookie
|
||||
```
|
||||
This needs to be redone every time the cookies expire (~30 minutes)
|
||||
#### Option 3
|
||||
Open firefox and go to any dropout.tv episode \
|
||||
Open the dev tools and go to network then refresh \
|
||||
Search for `?api` and select the top request \
|
||||
Copy the `__cf_bm` cookie from the cookies section \
|
||||
Create a file called `auth_cookie` and paste the cookie in the file \
|
||||
Go back to firefox and copy the `_session` cookie into a file named `session_cookie` \
|
||||
This needs to be redone everytime the cookie expires (~30 minutes)
|
||||
### chrome
|
||||
#### Option 1 (requires sqlite-devel and libgcrypt)
|
||||
### Chrome
|
||||
Create a file named `chrome_profile` in the build directory and paste in your chrome profile folder path (found on [chrome://version](chrome://version))
|
||||
#### Option 2
|
||||
Go to settings > privacy and security > cookies > see all cookies > vhx.tv > __cf_bm \
|
||||
Copy the `content` and paste it into the `cookie` file \
|
||||
This needs to be redone every time the cookies expire (~30 minutes)
|
||||
### Other/No Sqlite
|
||||
Use the `--force-cookies` program option to manually input cookies.
|
||||
|
||||
## How to Use
|
||||
```
|
||||
./dropout-dl <url> [OPTIONS]
|
||||
```
|
||||
By default, dropout-dl will download the episode in the format `<series>/S<season-num>E<episode-num><name>.mp4`
|
||||
|
||||
### Options
|
||||
```
|
||||
|
@ -66,4 +48,15 @@ This needs to be redone every time the cookies expire (~30 minutes)
|
|||
--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 from all seasons
|
||||
```
|
||||
By default, dropout-dl will download the episode in the format `<series>/S<season-num>E<episode-num><name>.mp4`
|
||||
|
||||
## Contributing
|
||||
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://makeapullrequest.com)
|
||||
### 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](https://kcd.im/pull-request)
|
||||
|
||||
## Contributors
|
||||
- Moss - [mossx-dev](https://github.com/mossx-dev)
|
||||
|
||||
|
|
Loading…
Reference in New Issue