CZEN
CZEN

PURE / Lab

Installation: Pure Clipboard

This guide assumes you can type a command into Terminal. PURE requires no sign-in to the website or any account, and it will not install anything for you.

Test build. Test build. The app is signed ad-hoc only and is not notarized by Apple, so macOS will block it on first launch. Verify the SHA-256 and follow the installation guide before opening it.

Download the app ↓ PureClipboard-0.8.0-b9-arm64-adhoc-TEST.dmg · 2,9 MB

What you need

Third-party software

Installation steps

  1. Check that the Mac has an Apple chip (M1 or later) and macOS 14 or later (Apple menu → About This Mac).
  2. Download the file PureClipboard-0.8.0-b9-arm64-adhoc-TEST.dmg with the Download button on this page (GitHub Release v0.8.0-b9).
  3. Check the SHA-256 checksum with the command below. The value must match exactly. If it does not, do not open the file; download it again.
  4. Double-click the DMG and drag Pure Clipboard into the Applications folder.
  5. Eject the DMG and open the app from the Applications folder, not directly from the disk image.
  6. If macOS blocks the app, open System Settings → Privacy & Security, choose Open Anyway for Pure Clipboard and confirm.
  7. After the first launch everything is off and nothing changes. Manual copying (⌘C, ⌘V) works without any further setup.
  8. Optional: turn on Auto Copy and install the hook in the Claude Code or Codex card. In Codex, start Codex and approve the hook with Type in Codex:/hooks. Every change is shown first, and a backup is made before any file is changed.
  9. Optional: for Pure Remote, install and sign in to Tailscale. For file transfer to a phone, install adb.
  10. Uninstall: in the app, click Remove on each integration, quit the app and move it to the Trash. The folder ~/Library/Application Support/PureClipboard holds settings and backups; delete it once you no longer need them.

Tested on

Tested on: a MacBook Pro (Apple silicon) running macOS 27.2 and a Samsung Galaxy S25+ (Android) phone. File transfer over Wi‑Fi and text transfer through Termux were verified; transfer over a cable has not been verified yet.

Phone with Android (optional)

Pure Clipboard on the Mac works fully on its own, without a phone, Android, Tailscale or Pure Remote. Without these parts you still have: manual copying (⌘C, ⌘V), automatic copying of answers from Claude Code and Codex (Auto Copy), the pclip command in Apple Terminal, clipboard history (optional, off by default) and the sensitive-data check. Pure Remote is an overview of the Tailscale network and needs none of the phone parts. Phone features are optional, and each has its own steps below.

A. Text transfer between the phone and the Mac (Termux)

  1. On the Mac, turn on Remote Login: System Settings → General → Sharing → Remote Login. Allow only your own user. The phone connects to the Mac over SSH, so this service must be on.
  2. On the Mac, install Tailscale and sign in with the account you will also use on the phone.
  3. In Pure Clipboard, open the card “Termux – phone ↔ Mac”, click Prepare channel and confirm the plan of changes. The app changes nothing without your confirmation.
  4. On the phone, install the Termux and Termux:API apps. We recommend the F-Droid versions; the Google Play versions are often older.
  5. On the phone, install Tailscale and sign in with the same account as on the Mac.
  6. In Termux, install the required packages: Paste into Termux:pkg install openssh termux-api
  7. If the phone has no SSH key yet, create one: Paste into Termux:ssh-keygen -t ed25519 (press Enter to accept the defaults). Then add the public part to the Mac with Paste into Termux:ssh-copy-id uzivatel@jmeno-macu, where the user and the Mac name come from Tailscale.
  8. In the card “Termux – phone ↔ Mac” in Pure Clipboard, copy the command that installs the script (the Copy command button) and paste it into Termux. Finish the installation as the output shows.
  9. Save the Mac address with the Paste into Termux:pcr setup command, which the card in the app shows (the Mac name in Tailscale or its IP address).
  10. Check the channel with Paste into Termux:pcr doctor. All lines should be OK. If one is not, fix it as the output shows.
  11. Usage: Paste into Termux:pcr tomac sends the phone clipboard to the received messages in the app on the Mac, from where you paste it into the Mac clipboard with Copy. Paste into Termux:pcr frommac sends text from the Mac to the phone clipboard. Received text is never pasted into the Mac clipboard by itself.

B. File transfer from the Mac to the phone (adb)

  1. On the Mac, install the adb tool: Paste into Terminal:brew install --cask android-platform-tools (requires Homebrew).
  2. Check the installation with Paste into Terminal:adb version. It should print a version.
  3. On the phone, open Settings → About phone → Software information and tap Build number seven times. This turns on Developer options.
  4. In Settings → Developer options, turn on USB debugging (for a cable) or Wireless debugging (for Wi‑Fi). For Wi‑Fi, the phone and the Mac must be on the same network.
  5. Connect the phone with a cable, or for Wi‑Fi enter the address from Wireless debugging into the Phone address field in the app. Confirm the Allow debugging prompt on the phone.
  6. On the Mac, check the connection with Paste into Terminal:adb devices. The phone must be listed with the state device.
  7. In Pure Clipboard, open the card File transfer to phone, choose a file and send it. The file is checked with SHA-256 and an existing file is never overwritten.
  8. After a phone restart the Wi‑Fi port changes. Enter the address again from Wireless debugging.

File transfer over Wi‑Fi has been verified on a Samsung Galaxy S25. Transfer over a cable has not been verified yet.

Report a bug

If the app does not work as described, tell us. A GitHub form opens where you describe what happened and paste the error text. Do not include passwords, tokens or personal data. You need a GitHub account to submit.

Report a bug on GitHub ↗

Verify the checksum

Open Terminal and enter the command (adjust the file name if you renamed it):

Open Terminal (Spotlight: ⌘ + Space, type Terminal) and paste this command:

shasum -a 256 ~/Downloads/PureClipboard-0.8.0-b9-arm64-adhoc-TEST.dmg

Expected SHA-256: 377a350d130e1dbc0b505c5e4ef3dbb63be890ae60aef4640e205d4e42b15a57

Troubleshooting

Nothing is copied automatically
Check that both Auto Copy and the switch of the integration are on and that the hook is installed. The integration card shows a “Last event” line with the reason for skipping.
Text was skipped because of sensitive data
The check found something that looks like a password or token. This is intended. If you know the text is safe, copy it manually with ⌘C.
Codex does not copy
The hook must be approved in Codex with Type in Codex:/hooks.
pclip: command not found
Open a new Terminal window or run Paste into Terminal:source ~/.zshrc.
macOS blocks the app again
After each update, repeat the Open Anyway step.

Changelog

The version history and changes are on the app page in Lab.

Licence

Pure Clipboard is distributed under the MIT License. Copyright holder: Studio Pure Sound. Full text: LICENSE in the application repository.

LICENSE ↗

Support

If something does not work, write to us at [email protected].

Back to the app page