ClipmanAndroid/README.md

Rama main · réplica de lectura del repositorio original.

# Clipman Android

Clipman Android is a foreground-only clipboard-history client. It can keep history privately on the Android device, synchronize through a folder chosen with Android's system picker, or use the same Clipman Server history as the other clients. While the app is open, users can browse, search, copy, add, edit, pin, delete, and open links.

Quick Clip lets users type a new entry directly, including an optional Name and Group, without first replacing the Android clipboard. It is available beside Paste and from the launcher icon's long-press menu. An unfinished draft survives leaving or suspending the app until it is saved or explicitly cancelled. The compact history toolbar keeps Paste, Quick Clip, and More together; More contains section switching and Settings, while Filter and Android's dedicated Top command remain directly available. Named links provide one context-aware alternative action: name plus link when ordinary copy uses the bare link, or bare link when the off-by-default name setting is enabled. If startup clipboard import and automatic remote copying are both enabled, Clipman preserves supported device clipboard content across the initial server refresh and adds it only when it is not already in history, without reassigning an existing entry's metadata to Android.

For user setup and testing instructions, read `Manual.html`.

Server setup can import the private `.clpconf` connection file generated by Clipman Server, avoiding manual entry of a long address and token. Open the file from Android's file browser to send it to Clipman, or use **Import server connection file** in Clipman Settings. Settings can export the current connection through Save to Files or Android's native share chooser; that credential file must be stored and shared securely. Server mode requires a nonblank, preferably unique history password and does not connect merely because the file was imported.

Settings can optionally require biometric or device authentication whenever Clipman returns to the foreground. This is off by default. Local and Server are exposed as one labelled TalkBack radio control each, without a second swipe stop for the adjacent text. For private-CA HTTPS servers, install the server's public authority as an Android CA certificate; Clipman opts into user-installed authorities for its server connection.

Clipman can check official GitHub client releases for updates automatically while it is open, at most once per day, or on demand from Settings. Server and command-line releases are ignored. Clipman verifies the downloaded package before Android asks the user to approve installation.

Settings can optionally preserve copied HTML formatting and add a separate Rich Text history section. Android copies HTML and the plain-text fallback together, preserves synchronized RTF fields, and uses plain text for RTF-only entries because Android's standard text clipboard does not publish RTF.

Settings can optionally synchronize encrypted history through a folder selected with Android's system picker. The folder may be on-device or supplied by an installed storage provider that grants persistent read and write access. Clipman keeps a private cache, rereads the shared revision before writing, merges concurrent changes and recognised provider conflict copies, and retries failures while open. It never receives the provider account. An existing backup-folder selection is reused as the initial shared-folder choice.

The separate encrypted history backup remains available through the same picker. A nonblank history password is required. The backup contains history only, and restoring merges it with current history instead of replacing newer entries or deletions; it is not live synchronization.

Server mode displays the encrypted local cache before contacting the server. Foreground refresh then uses a fixed five-second revision check, downloads history only when it changed, pauses while Settings is open or the app is in the background, and backs off connection failures. Settings also includes an optional Tip Jar link; tips do not unlock features.