docs: fix README
This commit is contained in:
parent
9c512c3c4d
commit
11442dfd36
2 changed files with 13 additions and 10 deletions
21
README.md
21
README.md
|
|
@ -215,13 +215,14 @@ RustyPipe reports come in 3 severity levels:
|
||||||
|
|
||||||
## Authentication
|
## Authentication
|
||||||
|
|
||||||
RustyPipe supports authentication in with your YouTube account. There are 2 supported
|
RustyPipe supports authenticating with your YouTube account to access
|
||||||
authentication methods: OAuth and cookies.
|
age-restricted/private videos and user information. There are 2 supported authentication
|
||||||
|
methods: OAuth and cookies.
|
||||||
|
|
||||||
To execute a query with authentication, use the `.authenticated()` query option. This
|
To execute a query with authentication, use the `.authenticated()` query option. This
|
||||||
option is enabled by default for methods that require authentication like the user data
|
option is enabled by default for queries that always require authentication like
|
||||||
methods. RustyPipe may automatically use authentication if available in case a video is
|
fetching user data. RustyPipe may automatically use authentication in case a video is
|
||||||
age-restricted or the user is IP-banned by YouTube. If you absolutely dont want to use
|
age-restricted or your IP address is banned by YouTube. If you never want to use
|
||||||
authentication, set the `.unauthenticated()` query option.
|
authentication, set the `.unauthenticated()` query option.
|
||||||
|
|
||||||
### OAuth
|
### OAuth
|
||||||
|
|
@ -232,7 +233,7 @@ means that you can only fetch videos and not access any user data.
|
||||||
|
|
||||||
To login using OAuth, you first have to get a new device code using the
|
To login using OAuth, you first have to get a new device code using the
|
||||||
`rp.user_auth_get_code()` function. You can then enter the code on
|
`rp.user_auth_get_code()` function. You can then enter the code on
|
||||||
https://google.com/device and log in with your Google account. After generating the
|
<https://google.com/device> and log in with your Google account. After generating the
|
||||||
code, you can call the `rp.user_auth_wait_for_login()` function which waits until the
|
code, you can call the `rp.user_auth_wait_for_login()` function which waits until the
|
||||||
user has logged in and stores the authentication token in the cache.
|
user has logged in and stores the authentication token in the cache.
|
||||||
|
|
||||||
|
|
@ -248,7 +249,9 @@ To authenticate with cookies you have to log into YouTube in a fresh browser ses
|
||||||
using browser plugins like "Get cookies.txt LOCALLY"
|
using browser plugins like "Get cookies.txt LOCALLY"
|
||||||
([Firefox](https://addons.mozilla.org/de/firefox/addon/get-cookies-txt-locally/))
|
([Firefox](https://addons.mozilla.org/de/firefox/addon/get-cookies-txt-locally/))
|
||||||
([Chromium](https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)).
|
([Chromium](https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)).
|
||||||
|
Close the browser window after extracting the cookies to prevent YouTube from rotating
|
||||||
|
the cookies.
|
||||||
|
|
||||||
You can then add the cookies to your RustyPipe client using the
|
You can then add the cookies to your RustyPipe client using the `user_auth_set_cookie`
|
||||||
`rp.()user_auth_set_cookie` or `user_auth_set_cookie_txt` function. The cookies are
|
or `user_auth_set_cookie_txt` function. The cookies are stored in the cache file. To log
|
||||||
stored in the cache. To log out, use the function `user_auth_remove_cookie`.
|
out, use the function `user_auth_remove_cookie`.
|
||||||
|
|
|
||||||
|
|
@ -117,7 +117,7 @@ subscription feed instead.
|
||||||
|
|
||||||
## `playlists`, `albums`, `tracks`: Get your YouTube library
|
## `playlists`, `albums`, `tracks`: Get your YouTube library
|
||||||
|
|
||||||
Fetch a list of all the items you stored in your YouTube/YouTube Music profile.
|
Fetch a list of all the items saved in your YouTube/YouTube Music profile.
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
|
|
|
||||||
Reference in a new issue