docs: fix README

This commit is contained in:
ThetaDev 2025-01-16 13:39:35 +01:00
parent 9c512c3c4d
commit 11442dfd36
No known key found for this signature in database
GPG key ID: E319D3C5148D65B6
2 changed files with 13 additions and 10 deletions

View file

@ -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`.

View file

@ -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