diff --git a/docs/Settings.md b/docs/Settings.md index 0bc920d..392f2f8 100644 --- a/docs/Settings.md +++ b/docs/Settings.md @@ -32,6 +32,15 @@ Additional settings passed to yt-dlp. - **Source Settings**: User created subtitles are provided from the uploader and are usually the video script. Auto generated is from YouTube, quality varies, particularly for auto translated tracks. - **Index Settings**: Enabling subtitle indexing will add the lines to Elasticsearch and will make subtitles searchable. This will increase the index size and is not recommended on low-end hardware. +## Comments +- **Download and index comments**: Set your configuration for downloading and indexing comments. This takes the same values as documented in the `max_comments` section for the youtube extractor of [yt-dlp](https://github.com/yt-dlp/yt-dlp#youtube). Add without space between the four different fields: *max-comments,max-parents,max-replies,max-replies-per-thread*. Example: + - `all,100,all,30`: Get 100 max-parents and 30 max-replies-per-thread. + - `1000,all,all,50`: Get a total of 1000 comments over all, 50 replies per thread. +- **Comment sort method**: Change sort method between *top* or *new*. The default is *top*, as decided by YouTube. +- The [Refresh Metadata](#refresh-metadata) background task will get comments from your already archived videos, spreading the requests out over time. + +Archiving comments is slow as only very few comments get returned per request with yt-dlp. Choose your configuration above wisely. Tube Archivist will download comments after the download queue finishes, your videos will be already available while the comments are getting downloaded. + ## Cookie Importing your YouTube Cookie into Tube Archivist allows yt-dlp to bypass age restrictions, gives access to private videos and your *watch later* or *liked videos*. diff --git a/docs/Video.md b/docs/Video.md index d9b36fd..2392352 100644 --- a/docs/Video.md +++ b/docs/Video.md @@ -1,11 +1,23 @@ # Video Page - -Every video downloaded gets a dedicated page accessible at `/video/` of your Tube Archivist. +Every video downloaded gets a dedicated page accessible at `/video//` of your Tube Archivist. Clicking on the channel name or the channel icon will bring you to the dedicated channel detail [page](Channels#channel-detail). The button **Delete Video** will delete that video including the media file. +If available, a tag cloud will show, representing the tags set by the uploader. + +The video description is truncated to the first few lines, click on *show more* to expand the whole description. + +## Playlist When available, a playlist navigation will show at the bottom. Clicking on the playlist name will bring you to the dedicated [Playlist Detail](Playlists#playlist-detail) page showing all videos downloaded from that playlist. The number in square brackets indicates the position of the current video in that playlist. -Clicking on the next or previous video name or thumbnail will bring you to that dedicated video page. \ No newline at end of file +Clicking on the next or previous video name or thumbnail will bring you to that dedicated video page. + +## Similar Videos +Tube Archivist will show up to six similar videos in a grid. Similarity is detected from the **video title** and the **video tags**. This naturally will show some videos from the same channel, but can also return videos about the same topic from other channels. + +When playing a video from the similar section with the inline player, the current video will get replaced, refresh the page to reset that or click on the video title to avoid that behavoir. + +## Comments +If activated on the settings page, this will show the indexed comments. Reveal the threads by clicking the *+ Replies* button. Comments with a heart symbol are favorited by the uploader, comments by the uploader are highlighted in a different color.