update docs for re-download, additional ui elements

mkdocs/docs/downloads.md

@@ -25,7 +25,14 @@ After downloading, **Tube Archivist** tries to add new videos to already indexed
 The **Add to Download Queue** icon <img src="/assets/icon-add.png?raw=true" alt="add icon" width="20px" style="margin:0 5px;"> opens a text field to manually add videos to the download queue. Add one item per line. This will _not_ add videos already in the queue, previously ignored or already indexed.
 
 ### Fast add
-This will add videos in bulk to the queue, at the expense of having less metadata and no thumbnail available in the download queue. The full metadata will get index as usual after downloading. Particularly usefull to add whole channels and playlists in bulk, has no effect when just adding a single video.
+This will add videos in bulk to the queue, at the expense of having less metadata and no thumbnail available in the download queue. The full metadata will get index as usual after downloading. Particularly usefull when adding whole channels and playlists, has no effect when adding single videos.
+
+### Re-Download
+In some cases you might want to re-download videos. For example if you unexpectedly got a lower resolution or if you want to upgrade the archive with better quality media files.
+
+- This will add, download and index videos again, even if they are already in your archive.
+- This will _not_ add videos already in the queue or previously ignored.
+- Also see [multiselect](index.md#multiselect).
 
 ### Auto download
 If you add them with *Download Now*, this will start the download automatically with priority. 

mkdocs/docs/index.md

@@ -20,19 +20,63 @@ Welcome to the official Tube Archivist Docs. This is an up-to-date documentation
 * Clicking on the search icon <img src="assets/icon-search.png?raw=true" alt="gridview icon" width="20px" style="margin:0 5px;"> will open a dedicated search page to search over your complete index.
 * The pagination - if available - builds links for up to 10'000 results, use the search, sort or filter functionality to find what you are looking for.
 
-
+### Watched State
 An empty checkbox icon <img src="assets/icon-unseen.png?raw=true" alt="unseen icon" width="20px" style="margin:0 5px;"> will show for videos you haven't marked as watched. Click on it and the icon will change to a filled checkbox <img src="assets/icon-seen.png?raw=true" alt="seen icon" width="20px" style="margin:0 5px;"> indicating it as watched - click again to revert.
 
-When available, the <img src="assets/icon-gridview.png?raw=true" alt="gridview icon" width="20px" style="margin:0 5px;"> gridview icon will display the list in a grid. A grid row holds 3 items by default, use the <img src="assets/icon-add.png?raw=true" alt="listview icon" width="20px" style="margin:0 5px;"> icon to add more or the <img src="assets/icon-substract.png?raw=true" alt="listview icon" width="20px" style="margin:0 5px;"> icon to remove items per row, depending on your screen size. The <img src="assets/icon-listview.png?raw=true" alt="listview icon" width="20px" style="margin:0 5px;"> listview icon will arrange the items in a list. The sort icon <img src="assets/icon-sort.png?raw=true" alt="listview icon" width="20px" style="margin:0 5px;"> will open additional sort options. In places where videos are listed the <img src="assets/icon-tableview.png?raw=true" alt="gridview icon" width="20px" style="margin:0 5px;"> tableview will allow you to get technical information like video codec, audio codec, filesize and image resolution of the listed videos.
+### Display layout
+- <img src="assets/icon-gridview.png?raw=true" alt="gridview icon" width="20px" style="margin:0 5px;">: Gridview icon will display the list in a grid. A grid row holds 3 items by default.
+    - <img src="assets/icon-add.png?raw=true" alt="listview icon" width="20px" style="margin:0 5px;">: On larger screens, the plus icon adds more items to the grid row.
+    - <img src="assets/icon-substract.png?raw=true" alt="listview icon" width="20px" style="margin:0 5px;">: The minus icon reduces items per row.  
+- <img src="assets/icon-listview.png?raw=true" alt="listview icon" width="20px" style="margin:0 5px;">: The list view arranges the items in a list.
+- <img src="assets/icon-tableview.png?raw=true" alt="gridview icon" width="20px" style="margin:0 5px;">: The tableview will allow you to get technical information like video codec, audio codec, filesize and image resolution of the listed videos.
 
+### Sort
+Toggle sort options by clicking on the <img src="assets/icon-sort.png?raw=true" alt="listview icon" width="20px" style="margin:0 5px;"> sort icon. This gives sort by options for: 
+
+- Published: Date published
+- Downloaded: Date downloaded
+- Views: View count
+- Likes: Like count
+- Duration: Duration of the video
+- Media Size: Mediasize on disk
+- Width: In pixels
+- Height: In pixels
+
+Additionally you can change the sort order to:
+
+- Desc: Descending
+- Asc: Ascending
+
+### Filter
+The filter icon <img src="assets/icon-filter.png?raw=true" alt="gridview icon" width="20px" style="margin:0 5px;"> Shows options for filtering:
+
+- Watched state: Show watched only, unwatched only or all.
+- Types: By video types, that's regular videos, shorts or streams.
+- Height: Media file height in pixels. That is useful for upgrading video resolutions or to verify if you downloaded the expected resolution. Works best in table view: <img src="assets/icon-tableview.png?raw=true" alt="gridview icon" width="20px" style="margin:0 5px;">.
+
+### Multiselect
+The multi select icon <img src="assets/icon-multi-select.png?raw=true" alt="gridview icon" width="20px" style="margin:0 5px;"> allows you to select multiple videos to then apply actions in bulk.
+
+- Select/unselect videos individually by clicking on the checkbox overlay on the top left of the video thumbnail. In table view <img src="assets/icon-tableview.png?raw=true" alt="gridview icon" width="20px" style="margin:0 5px;">, the select checkbox is in the first column.
+- An info box will indicate how many videos you have selected. The selection persists over page navigation and between different views.
+- In tableview <img src="assets/icon-tableview.png?raw=true" alt="gridview icon" width="20px" style="margin:0 5px;"> an additional "select all" checkbox is show, to select all videos visible. That is dependent on your [Archive View Page Size](settings/user.md#archive-view-page-size). 
+- The "clear" button will empty your selection.
+- To avoid confusion when multiselect is active, the watched checkbox is hidden.
+- Toggle the multiselect icon again to exit multiselect mode.
+
+Then the actions currently supported:
+
+- **Redownload**: This downloads and indexes the selected videos again. Also see [Downloads#re-download](downloads.md#re-download).
+
+## Keyboard Shortcuts
 You can control the video player with the following keyboard shortcuts:
 
 - `?`: Show help
 - `p`: Toggle play/pause
-- `m`: toggle mute
-- `f`: toggle fullscreen
-- `c`: toggle subtitles if available
-- `>`: increase playback speed
-- `<`: decrease playback speed
-- `←` (left arrow): jump back 5 seconds
-- `→` (right arrow): jump forward 5 seconds
+- `m`: Toggle mute
+- `f`: Toggle fullscreen
+- `c`: Toggle subtitles if available
+- `>`: Increase playback speed
+- `<`: Decrease playback speed
+- `←` (left arrow): Jump back 5 seconds
+- `→` (right arrow): Jump forward 5 seconds