Clipman Android Test Build Manual

Clipman Android is a foreground clipboard-history client for Android phones and tablets. It can keep history privately on the phone or merge it with Clipman Server while the app is open. You can browse, search, copy, add, edit, pin, delete, and open links.

This Android package is currently a test build. It is intended for Clipman Server users who want to help test the Android client before a wider Android release.

iPhone and iPad users can download Clipman from the App Store.

Contents

Requirements

Clipman Android does not monitor the Android clipboard in the background. Android restricts background clipboard access, and Clipman follows that platform rule. The app syncs while it is open.

Install

  1. Copy the APK to the Android device.
  2. Open it from Files, Downloads, or your preferred file manager.
  3. If Android asks whether to allow installing unknown apps from that source, allow it for this install.
  4. Install Clipman.
  5. Open Clipman.

The Android package ID is me.onj.clipman.

First Run

Clipman can optionally ask Android to unlock with biometrics or your device credential before showing history after you return to the app. This is off by default and can be enabled in Settings.

The first time you configure it:

  1. Open Settings if it is not already shown.
  2. Choose Local to keep history on this phone, Shared Folder to synchronize through Android's system folder picker, or Server to use Clipman Server.
  3. For Shared Folder mode, choose a folder offered by Android and enter the same nonblank history password on every participating device. If encrypted backup already has a folder, Clipman reuses it as the initial choice.
  4. For Server mode, open the private .clpconf file from Android's file browser, or choose Import server connection file in Clipman Settings. You can also enter the server address and token manually.
  5. Enter a nonblank, preferably unique history password. Clipman Server does not allow passwordless history.
  6. Choose Save at the top of Settings.

Local mode stores clipman-history.clipdb in Android's private app storage. Shared Folder and Server modes keep that local copy as an offline cache and merge it with the selected storage. If storage is unavailable, changes remain local and retry while Clipman is open. Switching back to a synchronized mode merges both histories, including deletion records, instead of replacing either side.

Enable Preserve copied formatting and show Rich Text history in Settings before using Paste when you want Clipman to retain HTML supplied by browsers, messaging apps, email clients, and editors. Formatted entries appear in a separate Rich Text section and are copied back with HTML plus the normal plain-text fallback. Android preserves RTF received from Windows, Mac, or iOS, but Android's standard text clipboard does not publish RTF, so RTF-only entries copy as plain text on Android.

An additional Include copied images in Rich Text history setting can store a standalone PNG or JPEG clipboard image. This is also off by default. To add a photo without first copying it, select one photo in Android's Photos, Gallery, or file app, choose Share, and then choose Clipman. Clipman waits for the normal unlock and initial history load, adds the photo to Rich Text history, and reports completion through the status area, sound, and optional haptic feedback. Clipman accepts one shared photo at a time. It preserves an already-compliant image, safely reduces a larger accepted image, and copies the result back as native image data. Retained metadata may contain camera or location information and follows the history's encryption and sync choices.

Your server address, token, and history password remain saved when you switch to Local mode. The token control is disabled until Server mode is selected again. Once configured, the server connection section is collapsed in Settings; use Show server connection to open it.

Main Screen

The main toolbar includes:

Group names are case-insensitive. Spellings such as GitHub, Github, and github 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.

Each history row is one accessibility focus target. TalkBack users can move from entry to entry with a single swipe. Very long entries use a bounded row and TalkBack preview and announce Preview truncated; viewing, copying, editing, searching and synchronizing still use the complete unchanged entry. An unnamed website link uses a readable offline label followed by its destination without http:// or https://; viewing or copying still uses the full unchanged URL. A URL copied with only a trailing screen-reader role word, such as https://example.com  link, remains in Links history while Clipman preserves the original stored text.

Double-tap an entry to copy it to the Android clipboard. Clipman announces Copied to clipboard and plays the copy sound when sounds are enabled.

Long-press, or use TalkBack actions, to open View Entry. The action order matches iPhone and iPad. A named link first offers the copy format opposite to ordinary activation: Copy Name and Link, or Copy Link when named-link copying is enabled. An unnamed public HTTP or HTTPS link can instead offer Use Website Title as Name. Link actions then continue with Open Link, View Entry, Edit Entry, Pin Entry or Unpin Entry, and Delete Entry. An image entry then adds Save to Photos followed by Share; ordinary entries do not include those two actions. Clipman asks before contacting the selected site, can find useful titles on modern script-heavy pages, ignores misleading bot-check titles, and stores a successful result in the ordinary Name field. Local or private destinations, non-standard ports, credential-related parameters, signed requests and token-like paths are refused. Website titles are never fetched automatically or in bulk.

View Entry

View entry shows the clipboard text line by line so TalkBack can review it naturally.

For an image entry, View Entry shows an image preview. Activate the preview to see the image at screen size; use Close image preview to return. Clipman retains a source filename when one is available and otherwise uses a generic image name rather than guessing the originating app.

If Clipman detects one link in an entry, the history row exposes an Open link action.

If Clipman detects multiple links in an entry, View entry lists each URL after the text. Each link is its own button and speaks the URL itself, so you know where it goes before opening it.

Settings

Settings includes:

Choose Cancel at the top, or use Android Back, to discard changes and return to history. Choose Save to apply changes and return to history. A history refresh that finishes while Settings is open does not close the Settings screen.

Opening a .clpconf file starts Clipman and requires the normal device unlock. An imported connection is shown for review and is not applied until you choose Save. If a private-CA HTTPS server generated the file, it can also contain the public authority. Clipman validates that certificate and trusts it only for this server profile and reviewed HTTPS host; it does not install a device-wide Android CA. If a particular Android file provider does not offer Clipman when you open the file, use the import button in Clipman Settings instead. Export offers Save to Files and Share for the address, token, and matching private authority currently shown in Settings. Share opens Android's native share chooser with temporary read-only access to the file. Every .clpconf file contains the private server token; store and share it securely, never keep it beside an exported clipboard history, and delete it or move it to a password manager after configuring your devices.

When Clipman starts in Shared Folder or Server mode, it displays the encrypted local cache before contacting synchronized storage. While Clipman is in the foreground and Settings is closed, it checks revisions every five seconds. It reads full history only when a revision changes, pauses checks in the background, and progressively slows retries during an outage. Returning to Clipman or closing Settings triggers an immediate refresh.

After a normal addition, edit, pin, title change, or deletion, Clipman saves and encrypts the local database once and uploads it against the known server revision. It downloads, decrypts, merges, and retries the complete history only when another client changed the server first. The status area reports server sync in progress and does not report the change as synced until Clipman Server accepts it.

If only some custom sounds are available, Clipman uses those and falls back to bundled defaults for the rest.

Updates

When an update is available, Clipman can download the versioned Android APK from the official GitHub release. Before opening the installer, it checks the package name and version, checks the SHA-256 digest when GitHub supplies one, and confirms that the APK is signed by the same application key as the installed Clipman.

Android requires the user to approve application installation. The first in-app update may also ask you to allow Clipman as an installation source. This permission allows Clipman to open Android's installer for its verified update; it does not permit Clipman to install silently. You can remove that permission later through Android's application settings.

Server Addresses

Server addresses may be entered as:

clipman://host:port
host:port
http://host:port
https://host:port

clipman:// is Clipman's private-network server scheme. Use HTTPS or a VPN such as Tailscale when connecting across untrusted networks.

Privacy and Security Notes