From ee436ea2d561cc169fdea14fffa9d946c39872fb Mon Sep 17 00:00:00 2001 From: simon Date: Thu, 25 Nov 2021 23:38:00 +0700 Subject: [PATCH] update docs with playlist info --- docs/Channels.md | 10 ++++++---- docs/Downloads.md | 12 +++++++++--- docs/Home.md | 4 +++- docs/Playlists.md | 21 +++++++++++++++++++++ docs/Video.md | 11 +++++++++++ 5 files changed, 50 insertions(+), 8 deletions(-) create mode 100644 docs/Playlists.md create mode 100644 docs/Video.md diff --git a/docs/Channels.md b/docs/Channels.md index 4d1e835e..3de8bb8f 100644 --- a/docs/Channels.md +++ b/docs/Channels.md @@ -1,11 +1,11 @@ # Channels Overview and Channel Detail Page -The channels are organized on two different levels: +The channels are organized on two different levels, similar as the playlists: ## Channels Overview Accessible at `/channel/` of your Tube Archivist, the **Overview Page** shows a list of all channels you have indexed. -- You can filter that list to show or hide subscribed channels from the drop down menu. Clicking on the channel banner or the channel name will direct you to the *Channel Detail Page*. -- If you are subscribed to a channel a *Unsubscribe* button will show. +- You can filter that list to show or hide subscribed channels with the toggle. Clicking on the channel banner or the channel name will direct you to the *Channel Detail Page*. +- If you are subscribed to a channel a *Unsubscribe* button will show, if you aren't subscribed, a *Subscribe* button will show instead. The **Subscribe to Channels** button add icon opens a text field to subscribe to a channel. You have a few options: - Enter the YouTube channel ID, a 25 character alphanumeric string. For example *UCBa659QWEk1AI4Tg--mrJ2A* @@ -18,7 +18,9 @@ The search icon search icon/` of your Tube Archivist. This page shows all the videos you have downloaded from this channel plus additional metadata. -- If you are subscribed to the channel, an *Unsubscribe* button will show. +- If you are subscribed to the channel, an *Unsubscribe* button will show, else the *Subscribe* button will show. - You can *Show* the channel description, that matches with the *About* tab on YouTube. - The **Mark as Watched** button will mark all videos of this channel as watched. - The button **Delete Channel** will delete the channel plus all videos of this channel, both media files and metadata. +- The button **Find Playlists** will go out to youtube and look for playlists belonging to this channel and index all with at least one video downloaded. Only do this for channels where you care about playlists as this will slow down indexing new videos for having to check which playlist this belongs to. +- The button **Show Playlists** will go to the [playlists](Playlists) page and filter the list to only show playlists from this channel. diff --git a/docs/Downloads.md b/docs/Downloads.md index 482497d7..62e62e16 100644 --- a/docs/Downloads.md +++ b/docs/Downloads.md @@ -3,7 +3,7 @@ Accessible at `/downloads/` of your Tube Archivist, this page handles all the do ## Rescan Subscriptions -The **Rescan Subscriptions** icon rescan icon will start a background task to look for new videos from the channels you are subscribed to. You can define the channel page size on the [settings page](Settings#subscriptions). With the default channel page size, expect this process to take around 2-3 seconds for each channel you are subscribed to. A status message will show the progress. +The **Rescan Subscriptions** icon rescan icon will start a background task to look for new videos from the channels and playlists you are subscribed to. You can define the channel and playlist page size on the [settings page](Settings#subscriptions). With the default page size, expect this process to take around 2-3 seconds for each channel or playlist you are subscribed to. A status message will show the progress. Then for every video found, **Tube Archivist** will skip the video if it has already been downloaded or if you added it to the *ignored* list before. All the other videos will get added to the download queue. Expect this to take around 1 second for each video as **Tube Archivist** needs to grab some additional metadata. New videos will get added at the bottom of the download queue. @@ -12,6 +12,8 @@ The **Start Download** icon do
 - The stop icon <img src= will gracefully stop the download process, once the current video has been finished successfully. - The cancel icon close icon is equivalent to killing the process and will stop the download immediately. Any leftover files will get deleted, the canceled video will still be available in the download queue. +After downloading, Tube Archivist tries to add new videos to already indexed playlists. + ## Add to Download Queue The **Add to Download Queue** icon add icon opens a text field to manually add videos to the download queue. You have a few options: - Add a link to a YouTube video. For example *https://www.youtube.com/watch?v=2tdiKTSdE9Y*. @@ -27,9 +29,13 @@ Below the three buttons you find the download queue. New items will get added at Every video in the download queue has two buttons: - **Ignore**: This will remove that video from the download queue and this video will not get added again, even when you **Rescan Subscriptions**. -- **Download now**: This will give priority to this video. If the download process is already running, the prioritized video will get downloaded as soon as the current video is finished. If there is no download process running, this will start downloading this single video and stop after that. +- **Download now**: This will give priority to this video. If the download process is already running, the prioritized video will get downloaded as soon as the current video is finished. If there is no download process running, this will start downloading this single video and stop after that. + +The button **Delete all queued** will delete all pending videos from the download queue. You can flip the view by activating **Show Only Ignored Videos**. This will show all videos you have previously *ignored*. Every video in the ignored list has two buttons: - **Forget**: This will delete the item form the ignored list. -- **Add to Queue**: This will add the ignored video back to the download queue. +- **Add to Queue**: This will add the ignored video back to the download queue. + +The button **Delete all ignored** will delete all videos you have previously ignored. diff --git a/docs/Home.md b/docs/Home.md index c0602fe9..e1f5a2f5 100644 --- a/docs/Home.md +++ b/docs/Home.md @@ -3,9 +3,11 @@ Welcome to the official Tube Archivist Wiki. This is an up-to-date documentation Table of contents: * [Main](Main): Tube Archivist landing page -* [Channels](Channels): Browse your channels, handle subscriptions +* [Channels](Channels): Browse your channels, handle channel subscriptions +* [Playlists](Playlists): Browse your indexed playlists, handle playlist subscriptions * [Downloads](Downloads): Scanning subscriptions, handle download queue * [Settings](Settings): All the configuration options +* [Video](Video): All details of a single video and playlist navigation. * [Users](Users): User management admin interface ## Getting Started diff --git a/docs/Playlists.md b/docs/Playlists.md new file mode 100644 index 00000000..29867c31 --- /dev/null +++ b/docs/Playlists.md @@ -0,0 +1,21 @@ +# Playlist Overview and Playlist Detail Page +The playlists are organized in two different levels, similar as the channels: + +## Playlist Overview +Accessible at `/playlist/` of your Tube Archivist, this **Overview Page** shows a list of all playlists you have indexed over all your channels. +- You can filter that list to show only subscribed to playlists with the toggle. + +The **Subscribe to Channels** button add icon opens a text field to subscribe to playlists. You have a few options: +- Enter the YouTube playlist id, for example: *PL96C35uN7xGLLeET0dOWaKHkAlPsrkcha* +- Enter the Youtube dedicated playlist url, for example: *https://www.youtube.com/playlist?list=PL96C35uN7xGLLeET0dOWaKHkAlPsrkcha* +- Add one per line. +- NOTE: It doesn't make sense to subscribe to a playlist if you are already subscribed the corresponding channel as this will slow down the **Rescan Subscriptions** [task](Downloads#rescan-subscriptions). + +The search icon search icon opens a text box to search for indexed playlists. + +## Playlist Detail +Each playlist will get a dedicated playlist detail page accessible at `/playlist//` of your Tube Archivist. This page shows all the videos you have downloaded from this playlist. + +- If you are subscribed to the playlist, an Unsubscribe button will show, else the Subscribe button will show. +- The Mark as Watched button will mark all videos of this playlist as watched. +- The **Delete Playlist** button will give you the option to delete just the *metadata* which won't delete any media files or *delete all* which will delete metadata plus all videos belonging to this playlist. \ No newline at end of file diff --git a/docs/Video.md b/docs/Video.md new file mode 100644 index 00000000..d9b36fd3 --- /dev/null +++ b/docs/Video.md @@ -0,0 +1,11 @@ +# Video Page + +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. + +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