mirror of
https://github.com/wrolpi/wrolpi-help.git
synced 2026-11-19 22:46:23 -05:00
Adding cookies docs.
This commit is contained in:
parent
4d1166dbb5
commit
e062d6b9a3
5 changed files with 65 additions and 2 deletions
|
|
@ -37,10 +37,61 @@ video from the WROLPi channel, then your video will be stored in `videos/WROLPi`
|
|||
* The file format the video will be encapsulated in.
|
||||
* `mp4` is the most universally compatible (but proprietary).
|
||||
* `mkv` is an open-standard media format.
|
||||
* **Use Browser Profile**
|
||||
* A browser profile is a set of cookies and settings that are used to download videos. This is useful for
|
||||
downloading videos from sites that require authentication or have other restrictions.
|
||||
See [Browser Profiles](#browser-profiles)
|
||||
* **Channel Tag**
|
||||
* The selected Tag will be applied to any new Channel created in the process of downloading these videos. The
|
||||
Channel will be placed in the respective tag directory in the `videos` directory.
|
||||
|
||||
## Videos Settings
|
||||
|
||||
Behavior when downloading videos can be configured in the `Videos > Settings` page.
|
||||
|
||||

|
||||
|
||||
* **Video Resolutions**
|
||||
* Used to configure the default video resolutions to download. This will be suggested to you when downloading
|
||||
videos.
|
||||
* **Video File Format**
|
||||
* Configure the name of the video file format (and related files). The default is
|
||||
`%(uploader)s_%(upload_date)s_%(id)s_%(title)s.%(ext)s`, this is used so the video files sort themselves by
|
||||
channel, then by date.
|
||||
* **Do not overwrite existing files**
|
||||
* yt-dlp will not overwrite existing files. This is useful if you are downloading a video that has been partially
|
||||
downloaded.
|
||||
* **Download Automatic Subtitles** and **Download subtitles**
|
||||
* Download captions for the video, if available.
|
||||
* **Download Thumbnail**
|
||||
* Download the thumbnail for the video, if available.
|
||||
* **Extra yt-dlp Arguments**
|
||||
* The text here will be split by spaces and passed as extra arguments to yt-dlp.
|
||||
* **Browser Profile**
|
||||
* Shows the browser profiles available to the `wrolpi` user. This is passed as the `--cookies-from-browser` argument
|
||||
to yt-dlp.
|
||||
* **Always Use Browser Profile**
|
||||
* Will download videos using `--cookies-from-browser` always. This is not recommended!
|
||||
|
||||
## How to Use Browser Profiles
|
||||
|
||||
Downloading videos that require authentication or have other restrictions can be done using a browser profile. This is
|
||||
done by logging in as the `wrolpi` user, and authenticating in the browser to the site you want to download from.
|
||||
|
||||
### Steps to use a browser profile:
|
||||
|
||||
1. Boot your Raspberry Pi.
|
||||
2. Log in as your user (possibly `pi`)
|
||||
3. Open the terminal, change the password of the wrolpi user:
|
||||
* `sudo passwd wrolpi`
|
||||
4. Log out of your user using **Menu** > **Logout** > **Logout**
|
||||
5. Select the `wrolpi` user in the dropdown.
|
||||
6. Launch a browser (Chromium or Firefox) and log in to the site you want to download from.
|
||||
7. Navigate to your WROLPi app, you should see the browser profile you just created in `Videos > Settings`
|
||||
8. Select the browser profile you just created in `Videos > Settings` and click **Save**.
|
||||
|
||||
You can now enable **Use Browser Profile** in the download modal.
|
||||
|
||||
## Download Channels/Playlists
|
||||
|
||||
WROLPi can download all videos from a channel, or playlist. This is done using the `Download > Channel/Playlist`
|
||||
|
|
@ -148,4 +199,4 @@ VLC can be launched by navigating: `Applications Menu > Sound & Video > VLC Medi
|
|||

|
||||
|
||||
Any video file can be opened by navigating `Media > Open File`. VLC will automatically display captions files that
|
||||
WROLPi has downloaded.
|
||||
WROLPi has downloaded.
|
||||
|
|
|
|||
Binary file not shown.
|
Before Width: | Height: | Size: 37 KiB After Width: | Height: | Size: 33 KiB |
BIN
docs/modules/videos/videos-settings.png
Normal file
BIN
docs/modules/videos/videos-settings.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 42 KiB |
Loading…
Add table
Add a link
Reference in a new issue