diff --git a/docs/commands/auth_token.png b/docs/commands/auth_token.png new file mode 100644 index 0000000..42d549f Binary files /dev/null and b/docs/commands/auth_token.png differ diff --git a/docs/commands/download.md b/docs/commands/download.md index 796064a..8b4b3d0 100644 --- a/docs/commands/download.md +++ b/docs/commands/download.md @@ -150,4 +150,26 @@ A couple of examples: | | | | -- | -- | | Pattern | `{channel} - {game} - {title}.{format}` | -| Expands to | `KatLink - Dark Souls III - Dark Souls 3 First playthrough.mkv` | \ No newline at end of file +| Expands to | `KatLink - Dark Souls III - Dark Souls 3 First playthrough.mkv` | + + +### Downloading subscriber-only VODs + +To download sub-only VODs, you need to find your auth token. It can be found +using your browser, in a cookie named `auth_token`. + +1. Open twitch.tv in your browser and make sure you're logged in. +2. Open developer tools (F12 shortcut in Firefox and Chrome). +3. Open the `Storage` tab on Firefox, or `Application` tab in Chrome. +4. Click on `Cookies` → `https://www.twitch.tv/` in the sidebar. +5. Find the `auth-token` cookie in the list and copy it's value. + +![How to find the auth token in dev tools](./auth_token.png) + +The auth token will be a 30 character long string of random letters and numbers, +something like `iduetx4i107rn4b9wrgctf590aiktv`. Then you can pass this to the +download command: + +``` +twitch-dl download 221837124 --auth-token iduetx4i107rn4b9wrgctf590aiktv +```