ClipmanLinux/Manual.html
Rama main · réplica de lectura del repositorio original.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Clipman for Linux Manual</title>
<style>
body{font:1rem/1.55 system-ui,sans-serif;max-width:68rem;margin:auto;padding:1rem;color:#171717;background:#fff}h1,h2{line-height:1.2}table{border-collapse:collapse;width:100%}th,td{border:1px solid #777;padding:.45rem;text-align:left;vertical-align:top}code,kbd{font-family:ui-monospace,monospace}nav ul{columns:2}a{color:#0645ad}@media(max-width:42rem){nav ul{columns:1}}@media(prefers-color-scheme:dark){body{color:#eee;background:#171717}a{color:#8ab4f8}}
</style>
</head>
<body>
<h1>Clipman for Linux</h1>
<p>Clipman is an accessible clipboard history manager for Linux, Windows, macOS, Android and iOS. The Linux edition connects to Clipman Server and uses the same encrypted history as your other devices. Add, edit, group, pin, reorder or delete an entry on one device and the change appears on every other connected device.</p>
<p>The Linux interface provides separate Text, Links, optional Rich Text and File History sections, Groups, multi-selection, templates, Quick Paste, machine-local Secrets, privacy exclusions, import and export, text transformations, global shortcuts, automatic updates and an encrypted offline read cache.</p>
<nav aria-label="Contents"><h2>Contents</h2><ul>
<li><a href="#changelog">Changelog</a></li><li><a href="#install">Install</a></li><li><a href="#setup">Set up</a></li><li><a href="#history">History sections</a></li><li><a href="#groups">Groups</a></li><li><a href="#entries">Entries and templates</a></li><li><a href="#quick-paste">Quick Paste</a></li><li><a href="#clipmerge">ClipMerge</a></li><li><a href="#file-history">File History</a></li><li><a href="#secrets">Secrets</a></li><li><a href="#privacy">Privacy controls</a></li><li><a href="#actions">Text actions</a></li><li><a href="#transfer">Import and export</a></li><li><a href="#preferences">Preferences</a></li><li><a href="#shortcuts">Keyboard shortcuts</a></li><li><a href="#accessibility">Accessibility</a></li><li><a href="#updates">Updates</a></li><li><a href="#offline">Offline use</a></li><li><a href="#files">Installed files</a></li><li><a href="#security">Security</a></li><li><a href="#project">Project and license</a></li>
</ul></nav>
<h2 id="changelog">Changelog</h2>
<h3>3.1.9</h3>
<p>F1 explains the focused control in a readable help dialog. Preferences explanations are available on demand instead of repeating automatically through Orca. Plain F1 opens help without changing a hotkey; closing help returns to the previous control. The complete manual remains available from Help, Manual and Open Manual.</p>
<p>Alt+Enter opens embedded images in the default image app or reveals a File History item's location. Successful opens close History. Global Quick Clip restores History's previous visibility when the editor closes. New generic clipboard images include the source application's name when available; original filenames and existing entries are unchanged.</p>
<h3>3.1.6</h3>
<ul><li>Web links copied as URL-only clipboard items now appear in Links history even when the source application supplies no plain-text representation. Local file links continue to use File History.</li></ul>
<h3>3.1.4</h3>
<ul><li>Protected stored images when editing their properties. Image content is now clearly read-only while Name, Group, pinning, and Quick Paste settings remain editable, preventing an accidental text edit from discarding the embedded image.</li><li>Image files pasted from Rich Text history into a file manager now retain the date when the image was originally added to Clipman instead of being dated when it was pasted.</li></ul>
<h3>3.1.0</h3>
<ul><li>When a deliberate <strong>Use Website Title as Name</strong> request cannot retrieve a usable page title, Clipman now saves the generic offline URL label into the ordinary Name field. This works for direct downloads and ordinary pages without relying on particular file extensions, and leaves the complete URL unchanged.</li><li>A deliberate request is no longer refused solely because a public URL contains tracking data or a token-like path or query. Automatic naming remains conservative, while embedded credentials, local or private destinations, non-standard ports, unsafe redirects and overlong addresses remain blocked.</li></ul>
<h3>3.0.0</h3>
<ul><li>Added <kbd>Ctrl+Enter</kbd> to save F2 Entry Properties or Quick Clip while ordinary Enter continues to insert a new line.</li><li>Protected channel data when a device reconnects with an older local cache. Stale channel-move markers can no longer remove a newer restored entry, and duplicate historical identities now converge consistently across clients.</li></ul>
<h3>2.9.0</h3>
<ul><li>Added <strong>Quick Clip</strong>. Press <kbd>Ctrl+N</kbd>, use the File menu or assign an optional global hotkey to type a new entry directly without changing the system clipboard.</li><li>Added <kbd>Alt+Enter</kbd> to open one selected standalone HTTP or HTTPS link in the default browser. Links remain available when Links history is disabled, while ordinary prose and private <code>clipman://</code> configuration links are not launched.</li><li>Startup clipboard capture now leaves an existing entry's device, group and timestamp unchanged instead of treating a retained clipboard item as a fresh copy.</li></ul>
<h3>2.8.5</h3>
<ul><li>Multiple selected Text, Links or Rich Text entries can now be joined with no separator, one new line, one blank line, a space, comma and space, or a custom separator. The choice also applies to transformed text, pushes and <strong>Copy Name and Content</strong>.</li><li>The history status bar now puts the active section's entry count before its connected or offline server state.</li></ul>
<h3>2.8.4</h3>
<ul><li>The history status bar now reports the active section's entry count with the current server state. Action confirmations and errors remain visible for eight seconds before the connected or offline cached state and count return automatically; changing sections no longer leaves a redundant section message behind.</li></ul>
<h3>2.8.3</h3>
<ul><li>Kept the Linux package aligned with the coordinated desktop release. Linux behavior is unchanged; Windows history lists now announce only the active history section instead of a long keyboard tutorial.</li></ul>
<h3>2.8.2</h3>
<ul><li>Kept the Linux package aligned with the coordinated desktop release. Linux behavior is unchanged; the background server-failure sound correction applies to macOS.</li></ul>
<h3>2.8.1</h3>
<ul><li>Kept the Linux package aligned with the coordinated desktop release. Linux behavior is unchanged because it does not show the Windows and Mac save-time warning for allowed single-modifier global hotkeys.</li></ul>
<h3>2.8.0</h3>
<ul><li>Added <strong>Copy Name and Content</strong>. In Text, Links or Rich Text history, press <kbd>Ctrl+Enter</kbd> to copy each non-empty Name followed by its resolved content and hide Clipman. Multiple selections are separated by one blank line, and optional paste-after-Enter is honoured. In File History, <kbd>Ctrl+Enter</kbd> remains <strong>Go to file</strong>.</li></ul>
<h3>2.7.2</h3>
<ul><li>Kept the Linux package version aligned with the coordinated desktop release. The Windows fix prevents a separately synchronized data folder from being mistaken for a shared executable installation; the shared database and Clipman Server formats are unchanged.</li></ul>
<h2 id="install">Install</h2>
<p>Extract the Linux archive, open a terminal in the extracted folder and run <code>./install.sh</code>. Installation is per-user and does not require root access. The installer checks required components before copying Clipman.</p>
<p>On Arch Linux, install prerequisites with <code>sudo pacman -S gtk4 python-gobject libkeybinder3 xdotool</code>. Debian or Ubuntu users need <code>gir1.2-gtk-4.0 gir1.2-keybinder-3.0 python3-gi xdotool</code>. Fedora users need <code>gtk4 python3-gobject keybinder3 xdotool</code>.</p>
<h2 id="setup">Set up</h2>
<ol><li>Open Clipman from the application menu.</li><li>Enter the Clipman Server address, server token, history password and a device name.</li><li>Alternatively, choose <strong>Import Clipman Server Connection File</strong> and select a <code>.clpconf</code> file. Enter the history password separately.</li><li>Choose whether to remember the history password on this device, then select <strong>Save and Connect</strong>.</li></ol>
<p>The server token authorizes access to the server. The history password identifies and decrypts one database bucket. A connection file contains the server address and token, never the history password.</p>
<h2 id="history">History sections</h2>
<p>Clipman has Text, Links, optional Rich Text and File History tabs. When the tab list has focus, use <kbd>Left Arrow</kbd>, <kbd>Right Arrow</kbd>, <kbd>Home</kbd> or <kbd>End</kbd> to choose a section. You can also use <kbd>Ctrl+Tab</kbd>, <kbd>Ctrl+Shift+Tab</kbd>, or the View menu. Direct shortcuts are <kbd>Alt+T</kbd>, <kbd>Alt+L</kbd>, <kbd>Alt+R</kbd> and <kbd>Alt+I</kbd>. Move the active tab with <kbd>Alt+Left</kbd> or <kbd>Alt+Right</kbd>; its per-device order is remembered, while the direct shortcuts remain fixed.</p>
<p>Activate an entry or press <kbd>Enter</kbd> to copy it and hide Clipman. <kbd>Ctrl+C</kbd> copies while leaving the window open. Search includes entry text, names, groups and device names; File History search also includes paths, operations and source information. Type the beginning of a displayed entry to move directly to it.</p>
<p>Pinned entries remain in their own ordered section above normal entries and are numbered for <kbd>Ctrl+1</kbd> through <kbd>Ctrl+0</kbd>. They are not affected by normal sorting or cleanup. The <strong>Normal Entries</strong> row separates the two sections. Press <kbd>Backspace</kbd> to move to the first normal entry, then press <kbd>Up Arrow</kbd> once to reach the separator.</p>
<p>The View, Sort menu offers Manual Order, Newest First, Oldest First, Text, Group and Device for Text, Links and Rich Text. File History can be sorted by manual order, capture time, file count, name, operation or source application. Sort choices persist between sessions; pinned order remains manual.</p>
<p>Use Shift with the arrow keys to select a contiguous range, or <kbd>Ctrl+A</kbd> to select every visible row. Copy, cut, group, transform, push, pin, delete, file restore and file-path commands act on the complete selection where applicable. Entry Properties, Details, Go to File, Paste After Selected and manual movement require one selected row.</p>
<p>General preferences can join multiple selected Text, Links or Rich Text entries with no separator, one new line, one blank line, a space, comma and space, or a custom separator. Custom separators accept <code>\n</code>, <code>\r\n</code>, <code>\r</code>, and <code>\t</code>. The choice applies to ordinary copies, transformed text, pushes and <strong>Copy Name and Content</strong>.</p>
<p>Clipman checks the server every two seconds. Unchanged results do not rebuild the list, move focus or produce repeated screen-reader announcements. Local clipboard capture is event-driven where the desktop reports changes and shares that existing two-second tick as a compatibility fallback instead of running a second polling loop.</p>
<p>Rich Text history is optional and off by default. Enable <strong>Preserve copied formatting and show Rich Text history</strong> in General preferences before copying formatted content from browsers, word processors, email clients or rich-text editors. These entries appear in a separate filtered section while retaining a plain-text fallback for every client. Copying one rich entry publishes the available plain and formatted representations together; templates and multi-entry copies remain plain text.</p>
<p><strong>Include images in Rich Text history</strong> is a separate subordinate option and is also off by default. It stores bounded standalone PNG and JPEG clipboard images in the existing history database and restores native image clipboard data when copied. The same copy also supplies a temporary file representation, so pasting normally into a Linux file manager creates an image named from the capture date and source device and preserves that capture date as the file's modified date, while pasting into a document or image editor uses the richest format that application supports. Clipman preserves the stored PNG or JPEG bytes and removes its private temporary file automatically. An image already within the limits keeps its original bytes and metadata; larger accepted images are reduced safely. Retained metadata may contain camera or location information and follows the history's encryption and sync choices. In Entry Properties, embedded image content is read-only; use Name to change how the entry appears without risking its stored image.</p>
<p>Copying a PNG or JPEG file in a Linux file manager normally records it in machine-local File History. To share that image through Rich Text history as well, switch Clipman to Rich Text, select where the entry belongs, and press <kbd>Ctrl+V</kbd>. Clipman accepts exactly one available PNG or JPEG file and applies the same image limits and metadata rules. Other files, folders, and multi-file selections remain File History only.</p>
<p><strong>Also add copied PNG and JPEG files to Rich Text history</strong> is an additional desktop preference and is off by default. When enabled, copying exactly one supported image file records the normal File History event and also adds the image to shared Rich Text history automatically. Rich Text history and its image option must also be enabled.</p>
<p><kbd>F4</kbd> safely presents common HTML formatting without running scripts, loading remote content or opening a browser view. RTF-only entries remain readable through their plain-text fallback and identify the stored format in Details. Editing or transforming an entry's text clears its previous formatting so stale rich content cannot be pasted later.</p>
<h2 id="groups">Groups</h2>
<p>The labelled Filter control filters Text, Links and Rich Text; press <kbd>Alt+G</kbd> to focus it. It can show All, Pinned, Normal, Ungrouped, one named group, or entries attributed to one device. The Groups menu presents the same choices, with device names separated from groups. The first ten group choices use <kbd>Alt+1</kbd> through <kbd>Alt+0</kbd>. Choose <strong>Group Entry</strong> or press <kbd>Ctrl+G</kbd> to assign one or several selected entries to a new or existing group.</p>
<p>Group names are case-insensitive, so spellings such as <strong>GitHub</strong>, <strong>Github</strong>, and <strong>github</strong> remain one group. If existing entries use several capitalizations, Clipman displays the spelling used most often and uses the newest spelling to resolve a tie. Groups are stored in the shared database, so group names and assignments travel with entries. File History is machine-local and does not use groups.</p>
<h2 id="entries">Entries and templates</h2>
<p><strong>Entry Properties</strong> changes the name, group, text, pinned state and template state. The editor includes template samples, individual fields and a resolved preview. Enter inserts a new line; press <kbd>Ctrl+Enter</kbd> to save directly. Insertions occur at the text cursor and automatically mark the entry as a template. Stored template text remains literal; fields resolve only when copied.</p>
<p>Unnamed website links use a useful offline label followed by the scheme-less destination in history, while View and copy retain the complete unchanged URL. For one unnamed public HTTP or HTTPS entry, choose <strong>Use Website Title as Name</strong> from Edit or the context menu. Clipman explains that the site will be contacted and waits for confirmation. The confirmation includes <strong>Do not show this again</strong>; restore it with <strong>Ask before contacting a website for its title</strong> in General preferences. A deliberate request may contact an otherwise safe public link even when its path or query contains tracking data or looks token-like. Automatic title naming remains more conservative, and Clipman always refuses embedded credentials, local or private destinations, non-standard ports, unsafe redirects and overlong addresses. Clipman stores a successful title in the ordinary Name field where Entry Properties can review or change it. If no usable title can be retrieved, it saves the same generic offline URL label instead; direct downloads work without a file-extension allowlist, and the complete URL remains unchanged.</p>
<p><strong>Automatically name copied website links from page headings</strong> is a separate per-device option and is off by default. It considers only newly captured, unnamed, link-only public HTTP or HTTPS entries and processes them one at a time in a small background queue. Existing history, imports, synchronized entries, manually added exceptions and refused addresses are never scanned. Automatic lookups do not delay capture, change the clipboard, play another sound or display a failure dialog.</p>
<p><strong>View Full Text</strong> shows the complete text, a safe formatted preview when HTML is available, and a details list containing name, group, device, character and word counts, stored formatting, pin/template state, added time and last-used time. Multiline entries are condensed into one navigable history row while preserving all text in Properties and Details.</p>
<p><kbd>Ctrl+X</kbd> cuts an unpinned entry. <kbd>Ctrl+V</kbd> adds current clipboard text after the selected normal entry. <kbd>Ctrl+P</kbd> marks the selected entry as newly pushed from this device and also places it on this clipboard, allowing devices with remote clipboard receipt enabled to receive it.</p>
<h2 id="quick-paste">Quick Paste</h2>
<p>Open Entry Properties, or choose <strong>Set as Quick Paste Target</strong> from Edit or the context menu, to assign an existing Text, Links or Rich Text entry its own global Quick Paste hotkey. Each assignment has one of three modes: paste and restore the previous clipboard, paste and leave the target on the clipboard, or copy the target without sending a paste command. Template entries resolve immediately before use.</p>
<p>The Quick Paste menu lists every live target and its hotkey. Choosing a target moves to that history entry so you can review or remove the assignment with <kbd>F2</kbd>. Assigned rows include the hotkey and mode in their visible and accessible details; unassigned rows do not carry extra wording. Deleting an entry also removes its machine-local hotkey, preventing inaccessible stale assignments.</p>
<p>Quick Paste is available in X11 sessions when <code>xdotool</code> is installed. Wayland compositors may prevent synthesized paste commands; Copy to Clipboard Only remains usable.</p>
<h2 id="clipmerge">ClipMerge</h2>
<p>ClipMerge is off by default. Enable it in General preferences, copy the first text or file selection normally, then copy the next selection twice within the configured 200-to-2000 millisecond window. Clipman combines the values, updates history, removes the temporary partial entry and plays <code>merge.wav</code>. Pinned entries are never modified.</p>
<p>Text separators can be a new line, blank line, space, comma and space, or a custom value with common backslash escapes. Merged formatted selections become plain text. File merging deduplicates paths. Cuts merge only while every source path still exists; after a source is pasted or moved, Clipman keeps the newer valid cut instead of combining it with a dead path. Rapid duplicate clipboard notifications from one command are coalesced without another history write or sound. Clipman refuses uncertain merges across applications, clipboard types, operations, ignored or excluded captures, expired intervals, or clipboard changes made by Clipman itself.</p>
<h2 id="file-history">File History</h2>
<p>File History records files copied or cut while Clipman is running. It is stored only on the current device and does not sync file paths to other devices. Each event includes the first filename, operation, file count, source, device and capture time. Repeated copies of the same file set replace the existing event instead of creating duplicates.</p>
<p>Press <kbd>Enter</kbd> to restore available files to the clipboard and hide Clipman. <kbd>Ctrl+C</kbd> copies their paths as text. <kbd>Ctrl+Enter</kbd> opens the location of a single available file or folder. File details list every path and format.</p>
<p>File events can be pinned, moved in Manual Order, sorted, searched and deleted like text entries. <kbd>Ctrl+1</kbd> through <kbd>Ctrl+0</kbd> restore numbered pinned file events; add Shift to copy their paths instead. Clearing or removing unavailable events keeps pinned events and never deletes files from disk. File History keeps up to 200 events.</p>
<h2 id="secrets">Secrets</h2>
<p>Secrets is an optional machine-local area for short private values you type deliberately. Open it from Options or press <kbd>Ctrl+Shift+E</kbd>, then enter the current history password before Clipman reveals secret names or assigned hotkeys. Secret values are never shown in the list, captured into ordinary history, synchronized through Clipman Server, or included in history import and export.</p>
<p>Add or edit a secret by entering its name and value twice. An optional global hotkey pastes the secret and restores the previous text clipboard. Press Enter or choose Paste in the unlocked Secrets manager to do the same. Deletion requires confirmation. Secrets are stored in a separate encrypted <code><device>-secrets.clipdb</code> file using the current history password.</p>
<p>Secrets is a convenience feature, not a replacement for a full password manager. Software running as the same user may still observe keystrokes or clipboard contents during the brief paste operation.</p>
<h2 id="privacy">Privacy controls</h2>
<p>Ignored Applications accepts one X11 process or application name per line. Automatic text capture from a matching foreground application is skipped. Automatically Group by Source Application uses the same source information to place new entries into app-named groups. Desktop environments do not expose this information consistently under Wayland, so both features are best supported under X11.</p>
<p>Sensitive Data exclusions are off by default. When enabled, selected presets can exclude valid credit-card numbers, US Social Security numbers, international phone numbers, long API keys or tokens, software license keys and approximate US driver-license shapes from automatic history. Credit-card detection includes a Luhn checksum, and complete HTTP or HTTPS URLs are not treated as tokens. Exclusions do not alter the system clipboard and do not block <strong>Save Current Clipboard to History</strong>, allowing an intentional override.</p>
<h2 id="actions">Text actions</h2>
<p>The Actions menu changes selected Text, Links or Rich Text entries and puts the result on the clipboard. It provides plain text copy, whitespace trimming, single-line conversion, blank-line removal, URL tracking removal, cleaner sharing links, line-ending conversion, uppercase/lowercase, HTML encode/decode/to-text and URL encode/decode. Changing stored text clears any previous rich formatting; Copy as Plain Text leaves the stored entry unchanged. These commands are omitted from the File History Edit menu because they do not apply to files.</p>
<h2 id="transfer">Import and export</h2>
<p>The File menu imports <code>.clipdb</code> history files by merging or replacing the current text history. Enter the password used by the imported file, or leave it blank for an unencrypted file. Import and Replace removes current text/link entries before adding the imported entries.</p>
<p>Export always requires confirmation of the current history password. The exported file can keep the current password, use a new password, or use no password. An export never changes the password used by the live database.</p>
<p>Clear Text History also requires the current history password and propagates the deletion safely through Clipman Server. File History is cleared separately and retains pinned events.</p>
<h2 id="preferences">Preferences</h2>
<p>Preferences has six tabs. Use <kbd>Ctrl+1</kbd> through <kbd>Ctrl+6</kbd> to switch, and Clipman remembers the last tab.</p>
<table><thead><tr><th>Tab</th><th>Contents</th></tr></thead><tbody>
<tr><td>General</td><td>Clipboard monitoring, sounds, opt-in ClipMerge timing and separators, multiple-entry copy separator, source-application grouping, remote clipboard receipt, optional paste after Enter, dynamic history section, automatic URL cleanup, optional Links and Rich Text history, bounded PNG/JPEG capture within Rich Text, optional automatic image-file addition, saved list position and duplicate handling.</td></tr>
<tr><td>File History</td><td>Automatic removal of unavailable unpinned file events.</td></tr>
<tr><td>Hotkeys</td><td>Global Show History and Toggle Monitoring shortcuts, plus optional Save Current Clipboard and Quick Clip shortcuts that are unset by default.</td></tr>
<tr><td>Storage and Password</td><td>Server connection changes, ignored applications and the Linux display-server compatibility note.</td></tr>
<tr><td>Startup and Updates</td><td>Desktop-session startup, optional capture of the existing clipboard at startup, update frequency and silent automatic installation.</td></tr>
<tr><td>Sensitive Data</td><td>Opt-in automatic-capture exclusions and their individual presets.</td></tr>
</tbody></table>
<p>Automatic remote clipboard receipt, dynamic history and automatic tracking removal are opt-in. Dynamic history makes a newly accepted item select its matching section the next time history opens. That automatic selection is used once, so a section you choose manually remains selected until another new item arrives. Missing custom sounds fall back to factory sounds.</p>
<p>Entry deletion asks for confirmation by default. The confirmation can remember <strong>Do not ask again</strong>; re-enable it from General preferences. Clearing an entire history area keeps its separate confirmation.</p>
<p><strong>Quick Clip</strong> creates a new saved entry without reading or changing the system clipboard. Use <kbd>Ctrl+N</kbd>, the File menu, or assign its optional global hotkey. Enter inserts a new line in the editor and <kbd>Ctrl+Enter</kbd> saves. Global Quick Clip restores History's previous visibility when the editor closes. <strong>Open Image or Link</strong> uses <kbd>Alt+Enter</kbd> to open exactly one selected standalone HTTP or HTTPS entry or embedded image in its default app. In File History it reveals the selected file or folder without running it. History closes on success and remains available on failure; ordinary prose and private <code>clipman://</code> configuration links are not launched.</p>
<h2 id="shortcuts">Keyboard shortcuts</h2>
<table><thead><tr><th>Action</th><th>Shortcut</th></tr></thead><tbody>
<tr><td>Copy/restore selected item and hide Clipman</td><td><kbd>Enter</kbd></td></tr>
<tr><td>Copy selected text, or file paths, and stay open</td><td><kbd>Ctrl+C</kbd></td></tr>
<tr><td>Copy selected Names and resolved content, then hide Clipman; Go to file in File History</td><td><kbd>Ctrl+Enter</kbd></td></tr>
<tr><td>Cut selected unpinned text entry</td><td><kbd>Ctrl+X</kbd></td></tr>
<tr><td>Paste clipboard text after selected entry</td><td><kbd>Ctrl+V</kbd></td></tr>
<tr><td>Open Quick Clip</td><td><kbd>Ctrl+N</kbd></td></tr>
<tr><td>Save Entry Properties or Quick Clip</td><td><kbd>Ctrl+Enter</kbd></td></tr>
<tr><td>Open selected image or website link; reveal File History location; close History on success</td><td><kbd>Alt+Enter</kbd></td></tr>
<tr><td>Select all visible entries</td><td><kbd>Ctrl+A</kbd></td></tr>
<tr><td>Import or export</td><td><kbd>Ctrl+I</kbd> or <kbd>Ctrl+E</kbd></td></tr>
<tr><td>Group selected entry</td><td><kbd>Ctrl+G</kbd></td></tr>
<tr><td>Push selected entry to other devices</td><td><kbd>Ctrl+P</kbd></td></tr>
<tr><td>Entry Properties</td><td><kbd>F2</kbd></td></tr>
<tr><td>Entry or file-event details</td><td><kbd>F4</kbd></td></tr>
<tr><td>Delete unpinned item</td><td><kbd>Delete</kbd></td></tr>
<tr><td>Pin or unpin</td><td><kbd>Shift+Enter</kbd></td></tr>
<tr><td>Move in Manual Order</td><td><kbd>Alt+Up</kbd> or <kbd>Alt+Down</kbd></td></tr>
<tr><td>Copy/restore pinned item 1 through 10</td><td><kbd>Ctrl+1</kbd> through <kbd>Ctrl+0</kbd></td></tr>
<tr><td>Copy pinned file paths 1 through 10</td><td><kbd>Ctrl+Shift+1</kbd> through <kbd>Ctrl+Shift+0</kbd></td></tr>
<tr><td>Choose group 1 through 10</td><td><kbd>Alt+1</kbd> through <kbd>Alt+0</kbd></td></tr>
<tr><td>Search; next; previous</td><td><kbd>Ctrl+F</kbd>, <kbd>F3</kbd>, <kbd>Shift+F3</kbd></td></tr>
<tr><td>Text, Links, Rich Text or File History</td><td><kbd>Alt+T</kbd>, <kbd>Alt+L</kbd>, <kbd>Alt+R</kbd>, <kbd>Alt+I</kbd></td></tr>
<tr><td>Choose a focused history tab</td><td><kbd>Left Arrow</kbd>, <kbd>Right Arrow</kbd>, <kbd>Home</kbd> or <kbd>End</kbd></td></tr>
<tr><td>Move the active history tab</td><td><kbd>Alt+Left</kbd> or <kbd>Alt+Right</kbd></td></tr>
<tr><td>Next or previous history section</td><td><kbd>Ctrl+Tab</kbd> or <kbd>Ctrl+Shift+Tab</kbd></td></tr>
<tr><td>Top, bottom or first normal item</td><td><kbd>Home</kbd>, <kbd>End</kbd>, <kbd>Backspace</kbd></td></tr>
<tr><td>Move ten entries</td><td><kbd>Page Up</kbd> or <kbd>Page Down</kbd></td></tr>
<tr><td>Open context menu</td><td>Application key or <kbd>Shift+F10</kbd></td></tr>
<tr><td>Hide Clipman</td><td><kbd>Escape</kbd></td></tr>
<tr><td>Show or hide globally</td><td><kbd>Ctrl+Alt+Backslash</kbd> by default</td></tr>
<tr><td>Turn monitoring on/off globally</td><td><kbd>Ctrl+Alt+Grave</kbd> by default</td></tr>
<tr><td>Save current clipboard to history globally</td><td>User-assigned in Preferences; unset by default</td></tr>
<tr><td>Open Quick Clip globally</td><td>User-assigned in Preferences; unset by default</td></tr>
<tr><td>Preferences</td><td><kbd>Ctrl+,</kbd></td></tr>
<tr><td>Secrets</td><td><kbd>Ctrl+Shift+E</kbd></td></tr>
<tr><td>Assigned Quick Paste or secret</td><td>User-assigned global hotkey</td></tr>
<tr><td>Help for the focused control</td><td><kbd>F1</kbd></td></tr>
<tr><td>Update check or project page</td><td><kbd>Shift+F1</kbd>, <kbd>Ctrl+F1</kbd></td></tr>
<tr><td>Diagnostics</td><td><kbd>Alt+F1</kbd></td></tr>
</tbody></table>
<h2 id="accessibility">Accessibility</h2>
<p>Press <kbd>F1</kbd> on a control for a short explanation tailored to that control. Tab and Shift+Tab move through the read-only help text, Open Manual and Close; Escape returns to the previous control. Preference explanations are available on demand rather than repeated automatically by Orca. Plain F1 opens help even in a hotkey field, without replacing its shortcut. The complete manual remains available from Help, Manual and Open Manual.</p>
<p>The interface uses native GTK 4 controls exposed through AT-SPI. A conventional menu bar exposes commands and shortcuts. Tab and Shift+Tab move between controls; Up and Down move one history entry. Every history row is one focus stop. Its accessible text includes relevant state, group, device and list position without duplicating visible content.</p>
<p>History polling does not reconstruct unchanged rows, so Orca focus and braille position remain stable. Status changes are announced without taking keyboard focus. Tab and Shift+Tab leave multiline editors instead of inserting tab characters.</p>
<p>Global shortcuts and background clipboard monitoring work normally under X11. Wayland compositors control those capabilities and support varies. Use <strong>Save Current Clipboard to History</strong> when a compositor prevents automatic capture.</p>
<h2 id="updates">Updates</h2>
<p>Choose <strong>Help, Check for Updates</strong> or press <kbd>Shift+F1</kbd>. Preferences can check at startup, hourly or daily. Automatic checks and silent installation are both opt-in.</p>
<p>Clipman accepts only a Linux GUI archive for the current processor architecture. It verifies the GitHub SHA-256 digest, archive size, HTTPS origin, safe paths, packaged version and required files before installation. Settings, server credentials, custom sounds, file history and encrypted cache are retained.</p>
<h2 id="offline">Offline use</h2>
<p>After a successful connection, Clipman keeps an encrypted owner-only read cache. Existing text, links and rich text remain readable and copyable if the server becomes unavailable. Server-backed edits are disabled until the connection recovers, preventing an unverified offline edit from overwriting newer shared data. Machine-local File History remains available.</p>
<h2 id="files">Installed files</h2>
<table><thead><tr><th>Location</th><th>Purpose</th></tr></thead><tbody>
<tr><td><code>~/.local/share/clipman-linux</code></td><td>Application, backend, manual and factory sounds.</td></tr>
<tr><td><code>~/.local/bin/clipman-linux</code></td><td>Launcher.</td></tr>
<tr><td><code>~/.clipman/config.toml</code></td><td>Owner-only server profile used by Clipman for Linux.</td></tr>
<tr><td><code>~/.clipman/gui-cache.clipdb</code></td><td>Encrypted offline read cache.</td></tr>
<tr><td><code>~/.clipman/<device>-file-history.clipdb</code></td><td>Encrypted machine-local File History.</td></tr>
<tr><td><code>~/.clipman/<device>-secrets.clipdb</code></td><td>Encrypted machine-local Secrets.</td></tr>
<tr><td><code>~/.config/clipman-linux/settings.json</code></td><td>Linux interface preferences.</td></tr>
<tr><td><code>~/.config/clipman-linux/sounds</code></td><td>Optional sound replacements. Missing sounds fall back to factory versions.</td></tr>
</tbody></table>
<p>Run <code>./uninstall.sh</code> from the extracted archive to remove the application. Private configuration, encrypted cache and file history are retained unless you remove them separately.</p>
<h2 id="security">Security</h2>
<p>Clipman Server stores encrypted database blobs and does not know the history password. Public servers must use HTTPS. Plain HTTP is accepted only for loopback, private-network and VPN addresses. Remembered credentials and local databases are restricted to their Linux user account.</p>
<p>A current private-CA server can include its public authority in the <code>.clpconf</code> file. Clipman validates it and uses it as the exclusive authority only for that saved HTTPS host. It does not install the certificate in the Linux system trust store. Public HTTPS profiles without an embedded authority continue to use normal operating-system trust.</p>
<p>Treat a <code>.clpconf</code> file as a credential because it contains a server token. Exporting with no history password creates an unencrypted clipboard history file; use that option only when the destination is appropriate.</p>
<h2 id="project">Project and license</h2>
<p>Clipman is released under the MIT License. See <code>LICENSE.txt</code>. Visit the <a href="https://github.com/OnjLouis/Clipman">Clipman project on GitHub</a> for downloads, source and issue reporting, or visit <a href="https://onj.me">Andre Louis's website</a>.</p>
</body>
</html>