From 1937aac1a4d5f54a4de28acb1def6075f45c4421 Mon Sep 17 00:00:00 2001 From: noembryo Date: Wed, 29 Jan 2025 14:10:54 +0200 Subject: [PATCH] User Guide --- docs/images/DropZone.png | Bin 0 -> 5050 bytes docs/images/MenuDropZone.png | Bin 0 -> 5220 bytes docs/index.md | 29 ++++++++++++++++++++++++++++- 3 files changed, 28 insertions(+), 1 deletion(-) create mode 100644 docs/images/DropZone.png create mode 100644 docs/images/MenuDropZone.png diff --git a/docs/images/DropZone.png b/docs/images/DropZone.png new file mode 100644 index 0000000000000000000000000000000000000000..d66d482479694fdf507b7d1f5238963305e1a266 GIT binary patch literal 5050 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 Q>i_@%07*qoM6N<$g2FzitpET3 literal 0 HcmV?d00001 diff --git a/docs/images/MenuDropZone.png b/docs/images/MenuDropZone.png new file mode 100644 index 0000000000000000000000000000000000000000..362bd1246b033ba7c979f344fbdd8526986716c3 GIT binary patch literal 5220 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 PB+yjVeO9CVGWvf2TZCPT literal 0 HcmV?d00001 diff --git a/docs/index.md b/docs/index.md index 0d1cbb3..a3e7f36 100644 --- a/docs/index.md +++ b/docs/index.md @@ -30,6 +30,7 @@ * [Truncate](#truncate) * [Split](#split) * [Rename](#rename) + * [DropZone](#dropzone) * [Context Menus](#context-menus) * [Playlist Track](#playlist-track) * [Library Track](#library-track) @@ -37,6 +38,7 @@ * [Playlist menu](#playlist-menu) * [Cover menu](#cover-menu) * [Compact View menu](#compact-view-menu) + * [DropZone menu](#dropzone-menu) * [Shortcuts](#shortcuts) @@ -548,7 +550,7 @@ Change the font and the row height of the Library entries. Change the font size of the track Title that is displayed of the **Compact View** layout. **DropZone** -Enable the use of the DropZone and customize its appearance. +Enable the use of the [DropZone](#dropzone) and customize its appearance. **Toolbar buttons** and **Show text labels** @@ -720,6 +722,17 @@ Example: {7} {2}\\{0} - {1} Produces: ..\\1998 NYC Live\\Portishead - Sour Times.mp3 +### DropZone + +![DropZone.png](images/DropZone.png) + +The DropZone is this square image that is always on top of all the other windows. +You can drop YouTube urls from your browser to open them in KataLib, without the need to leave your browser and switch to KataLib. + +We can change its size and transparency level from the **View** tab in **Preferences**, to make it less intrusive. +There are also some useful actions, that are available from a [menu](#dropzone-menu) that you get if you right-click on it. + + ___ ## Context Menus @@ -881,6 +894,20 @@ Right-clicking on the [Compact View](#compact-view)'s Cover Art will produce thi - **About** opens the [About](#about) dialog - **Exit from KataLib** exits the application + +### DropZone menu + +![MenuDropZone.png](images/MenuDropZone.png) + +This is the menu that you get if you right-click on DropZone. + +- **Paste from clipboard** searches the system's clipboard for any YouTube url and adds it to KataLib. +- **Show/Hide KataLib window** lets you totally hide all the app's other windows (even from the taskbar), without closing it. +- **DroZone** is a sub-menu that can change the DropZone's size or even totally hide it. +- **Compact View** toggles between the Normal and Compact views of the app. +- **Preferences** is a shortcut to the Preferences of the app. +- **Exit from KataLib** exits the application . + ___ # Shortcuts