readme: Added basic use info
This commit is contained in:
parent
2a70e1dfa4
commit
d1e434b610
57
readme.md
57
readme.md
|
@ -0,0 +1,57 @@
|
||||||
|
# dropout-dl
|
||||||
|
a tool to download [dropout.tv](dropout.tv) episodes.
|
||||||
|
|
||||||
|
|
||||||
|
## how to build
|
||||||
|
```
|
||||||
|
cmake -S <source-dir> -B <build-dir>
|
||||||
|
cd <build-dir>
|
||||||
|
make
|
||||||
|
```
|
||||||
|
|
||||||
|
## setup
|
||||||
|
the sqlite and curl libraries are required \
|
||||||
|
additionally [cookies](#cookies) are needed
|
||||||
|
|
||||||
|
### dependency installation
|
||||||
|
#### void linux
|
||||||
|
```
|
||||||
|
sudo xbps-install -S libcurl
|
||||||
|
```
|
||||||
|
|
||||||
|
#### debian
|
||||||
|
```
|
||||||
|
sudo apt install libcurl
|
||||||
|
```
|
||||||
|
|
||||||
|
## 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 (~1-2 hours)
|
||||||
|
#### 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 (~1-2 hours)
|
||||||
|
### chrome
|
||||||
|
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 (~1-2 hours)
|
||||||
|
|
||||||
|
## how to use
|
||||||
|
run the command
|
||||||
|
```
|
||||||
|
./dropout-dl <episode-url>
|
||||||
|
```
|
||||||
|
dropout-dl will download the episode into a folder with the name of the series in the format
|
||||||
|
`S<season-num>E<episode-num><name>.mp4`
|
Loading…
Reference in New Issue