Document v0.6.8: background OCR, optional Tesseract setup and pencil default
-53
@@ -1,53 +0,0 @@
|
||||
# Clipboard history
|
||||
|
||||
**English** | [Українська](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Clipboard-uk)
|
||||
|
||||
**[⬇ Download latest release (Windows x64, ZIP)](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/latest/KSwitcher-win-x64.zip)**
|
||||
|
||||
KSwitcher records copied **text, images and file lists**. Use history to retrieve an earlier item, paste without formatting, pin useful entries or extract text from a screenshot.
|
||||
|
||||
## Enable and open history
|
||||
|
||||
Enable **Record clipboard history** in **Settings**. Open history from the tray menu or with the **Clipboard history** shortcut. From **v0.6.1**, the default for new settings is **Win+V**. Previously saved shortcuts are preserved; you can change them in Settings. While KSwitcher is running, an assigned Win+V opens its history instead of Windows clipboard history.
|
||||
|
||||
## Search and paste
|
||||
|
||||
|
||||
|
||||
Type part of the text into **Search clipboard history**. Results show a preview, item number and source application. Images have thumbnails. Text may display HTML/RTF formatting; rendering depends on the original content.
|
||||
|
||||
1. Before opening history, place the cursor in the target application's input field.
|
||||
2. Open history, find and select an entry.
|
||||
3. Use **Paste / Enter** to paste it or **Plain text / Shift+Enter** to paste unformatted text.
|
||||
|
||||
From **v0.6.0**, the list and search field resize with the window, while the action buttons stay at the bottom. When the window is very small, controls remain accessible by scrolling.
|
||||
|
||||
## Commands
|
||||
|
||||
| Shortcut | Action |
|
||||
| --- | --- |
|
||||
| Enter | Paste the selected entry into the previous window |
|
||||
| Shift+Enter | Paste plain text without formatting |
|
||||
| Ctrl+1 … Ctrl+9 | Quickly paste an entry from the list |
|
||||
| Ctrl+P | Pin / unpin |
|
||||
| Delete | Delete the selected entry |
|
||||
| Ctrl+O | Open the full preview |
|
||||
| Esc | Close history |
|
||||
|
||||
The **Pin / unpin**, **Delete** and **Open item** buttons provide the same main actions. Right-click an entry for additional commands.
|
||||
|
||||
|
||||
|
||||
## Images, OCR and screenshots
|
||||
|
||||
KSwitcher screenshots are copied immediately and recorded in history when recording is enabled. After editing a screenshot, press **Ctrl+C** to copy the annotated result. Identical repeated images are deduplicated.
|
||||
|
||||
To extract text, select an image and choose **Copy text from image (Windows OCR)** from its context menu. The corresponding Windows OCR language components must be installed. See [Screenshot capture and annotation editor](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Screenshots) for capture and editing instructions.
|
||||
|
||||
## Limits and privacy
|
||||
|
||||
**Settings → History limits** controls the maximum number of entries, total storage in MiB and individual entry size. **Clear history…** clears history. **Exclude applications** excludes applications by process name; the tray menu also provides a temporary recording pause.
|
||||
|
||||
History and its index are encrypted with Windows DPAPI for the current user. Full images load on demand and the thumbnail cache is bounded. Use **Open data folder** to locate the data. Moving this encrypted history to a different Windows account is not supported.
|
||||
|
||||
The screenshots show demonstration entries created for this documentation.
|
||||
+76
@@ -0,0 +1,76 @@
|
||||
# Clipboard history
|
||||
|
||||
**English** | [Українська](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Clipboard-uk)
|
||||
|
||||
**[⬇ Download latest release (Windows x64, ZIP)](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/latest/KSwitcher-win-x64.zip)**
|
||||
|
||||
KSwitcher records copied **text, images and file lists**. Use history to retrieve an earlier item, paste without formatting, pin useful entries or extract text from a screenshot.
|
||||
|
||||
## Enable and open history
|
||||
|
||||
Enable **Record clipboard history** in **Settings**. Open history from the tray menu or with the **Clipboard history** shortcut. From **v0.6.1**, the default for new settings is **Win+V**. Previously saved shortcuts are preserved; you can change them in Settings. While KSwitcher is running, an assigned Win+V opens its history instead of Windows clipboard history.
|
||||
|
||||
## Search and paste
|
||||
|
||||
|
||||
|
||||
Type part of the text into **Search clipboard history**. Results show a preview, item number and source application. Images have thumbnails. Text may display HTML/RTF formatting; rendering depends on the original content.
|
||||
|
||||
1. Before opening history, place the cursor in the target application's input field.
|
||||
2. Open history, find and select an entry.
|
||||
3. Use **Paste / Enter** to paste it or **Plain text / Shift+Enter** to paste unformatted text.
|
||||
|
||||
From **v0.6.0**, the list and search field resize with the window, while the action buttons stay at the bottom. When the window is very small, controls remain accessible by scrolling.
|
||||
|
||||
## Commands
|
||||
|
||||
| Shortcut | Action |
|
||||
| --- | --- |
|
||||
| Enter | Paste the selected entry into the previous window |
|
||||
| Shift+Enter | Paste plain text without formatting |
|
||||
| Ctrl+1 … Ctrl+9 | Quickly paste an entry from the list |
|
||||
| Ctrl+P | Pin / unpin |
|
||||
| Delete | Delete the selected entry |
|
||||
| Ctrl+O | Open the full preview |
|
||||
| Esc | Close history |
|
||||
|
||||
The **Pin / unpin**, **Delete** and **Open item** buttons provide the same main actions. Right-click an entry for additional commands.
|
||||
|
||||
|
||||
|
||||
## Images, OCR and screenshots
|
||||
|
||||
From **v0.6.8**, new images are recognized automatically in the background. Older images without OCR are processed once, newest first. After recognition, type a word from the image into **Search clipboard history** to find the original image. The list refreshes automatically when recognition finishes.
|
||||
|
||||
Search is case-insensitive and matches a literal substring. It filters entries while preserving their order. Enter and switching windows are not required: a typing pause of about 180 ms starts the search. Search runs separately from clipboard capture, previews and OCR, and avoids loading image payloads when the existing preview is enough to rule out a match.
|
||||
|
||||
Recognized text is saved with the image in a DPAPI-encrypted sidecar, reused after restart and removed with the image. Searching never reruns OCR. Automatic recognition does not change the clipboard or the original image. Empty results are remembered; pending work resumes after restart. Failures are logged without popup dialogs.
|
||||
|
||||
Choose **Copy text from image (OCR)** in the context menu to copy the cached text or explicitly retry failed recognition. Screenshot capture and copying edited results work as before; see [Screenshots](Screenshots).
|
||||
|
||||
### Windows OCR (default)
|
||||
|
||||
Windows OCR is native and offline. It chooses an available recognizer from your Windows profile languages. Keyboard layouts do not guarantee installed OCR models, and it does not run all languages automatically. Quality depends on the language, text size and image clarity.
|
||||
|
||||
### Optional Tesseract: Ukrainian and mixed-language text
|
||||
|
||||
Tesseract is **optional and disabled by default**. It is not bundled or downloaded automatically. Both engines process images locally.
|
||||
|
||||
1. Open **Settings → OCR options…**. Click **Download Tesseract…** to open the [UB Mannheim Windows installer page](https://github.com/UB-Mannheim/tesseract/wiki#tesseract-installer-for-windows) in your browser. Install the **64-bit Tesseract 5** package and your desired language models. Upstream **Source code** archives are not Windows installers.
|
||||
2. Enable **Use optional Tesseract 5 instead of Windows OCR**.
|
||||
3. Leave the executable field blank to detect a standard installation, or select `tesseract.exe` with **Browse…**. The neighboring `libtesseract-5.dll`, its dependencies and `tessdata` directory are required.
|
||||
4. Enter `ukr+eng+rus` to recognize Ukrainian, English and Russian together, or another installed combination such as `ukr+eng`. Missing models produce an error.
|
||||
5. Click **Check installation**. **Ready: ukr+eng+rus** confirms availability only. It does **not** enable Tesseract or save settings.
|
||||
6. Click **OK**, then **Save** in the main Settings window.
|
||||
|
||||
Changing the engine, executable path or languages refreshes saved images' OCR in the background. Wait for that work before testing previously misrecognized words. Uncheck the option and save to return to Windows OCR. Only the selected engine is used, not both together. Tesseract has a 30-second recognition deadline per image.
|
||||
|
||||
If a word is missing, confirm the option is enabled and saved, allow OCR to finish, and inspect **Copy text from image (OCR)**. Small, blurred or crossed-out text may be misrecognized. Search does not perform fuzzy spelling correction.
|
||||
|
||||
## Limits and privacy
|
||||
|
||||
**Settings → History limits** controls the maximum number of entries, total storage in MiB and individual entry size. **Clear history…** clears history. **Exclude applications** excludes applications by process name; the tray menu also provides a temporary recording pause.
|
||||
|
||||
History and its index are encrypted with Windows DPAPI for the current user. Full images load on demand and the thumbnail cache is bounded. Use **Open data folder** to locate the data. Moving this encrypted history to a different Windows account is not supported.
|
||||
|
||||
The screenshots show demonstration entries created for this documentation.
|
||||
Reference in New Issue
Block a user