CopyTrail - Native Clipboard History Manager

CopyTrail is a native, local-first clipboard history app for macOS and Windows. It records the latest 1000 clipboard items, supports search, tags, pinned entries, deletion, light/dark themes, Chinese/English UI, and multi-format clipboard history for text, images, files, rich text, HTML, PDF, and common binary clipboard data.

官网 / Official website: https://copytrail.dyd730515.workers.dev/

CopyTrail 是一个原生剪贴板历史工具，适合正在寻找 clipboard history、clipboard manager、copy history、paste history、Mac clipboard history、Windows clipboard history、Maccy alternative、CopyQ alternative、Ditto alternative、Clipy alternative、PastePal alternative、Raycast Clipboard alternative 或 Alfred Clipboard alternative 的用户。无需账号，默认中文，剪贴板历史保存在用户本机。

Features

• Native macOS menu bar app built with SwiftUI.
• Native Windows tray app implementation, including a Win32/C++ build and a WPF/.NET version.
• Keeps the latest 1000 clipboard history records locally.
• Supports text, images, files, PDFs, rich text, HTML, and common binary clipboard formats.
• Search by content, filename, link, and tag.
• Automatic and custom tags for organizing clipboard history.
• Pin, delete, and copy any history item back to the clipboard.
• Compact popover UI below the menu bar or tray area.
• Light theme, dark theme, system theme, Chinese UI, and English UI.
• Local JSON storage. No account is required.
• Optional anonymous device report for basic app/device telemetry only. Clipboard content is never uploaded.

功能

• 原生 macOS 菜单栏应用，SwiftUI 开发。
• 原生 Windows 托盘应用，包含 Win32/C++ 版本和 WPF/.NET 版本。
• 最多保留最近 1000 条剪贴板历史记录。
• 支持文本、图片、文件、PDF、富文本、HTML 和常见二进制剪贴板格式。
• 支持按内容、文件名、链接和标签搜索。
• 自动识别标签，也可以自定义 tag 分类。
• 支持置顶、删除、一键复制历史记录回剪贴板。
• 点击菜单栏或托盘图标后弹出紧凑历史面板。
• 支持浅色主题、深色主题、跟随系统，以及中文/英文界面。
• 数据保存在本地 JSON 文件，无需登录。
• 可选匿名设备基础信息上报，不上传剪贴板内容。

Download

Download the latest macOS DMG and Windows installer from the official website:

https://copytrail.dyd730515.workers.dev/

Project Layout

Sources/                  macOS SwiftUI app
Resources/                macOS app icons and bundled images
windows/CopyTrail.Native  Native Windows Win32/C++ app and NSIS installer
windows/CopyTrail.Windows WPF/.NET Windows implementation
site/                     Static marketing and download website for Cloudflare Workers
db/migrations/            Supabase table and RLS migrations for anonymous device reports
scripts/                  macOS build, DMG, and icon generation scripts

Run macOS App Locally

CLANG_MODULE_CACHE_PATH=.build/module-cache swift run --disable-sandbox

Build macOS App

chmod +x scripts/build-app.sh
scripts/build-app.sh
open dist/CopyTrail.app

Build a macOS DMG:

chmod +x scripts/build-dmg.sh
scripts/build-dmg.sh

Build a Developer ID signed and notarized macOS DMG for public release:

security find-identity -v -p codesigning

xcrun notarytool store-credentials copytrail-notary \
  --apple-id "your-apple-id@example.com" \
  --team-id "YOURTEAMID" \
  --password "your-app-specific-password"

COPYTRAIL_SIGNING_IDENTITY="Developer ID Application: Your Name (YOURTEAMID)" \
COPYTRAIL_NOTARY_PROFILE="copytrail-notary" \
COPYTRAIL_NOTARIZE=1 \
scripts/build-dmg.sh

The notarized DMG flow signs the app with hardened runtime, creates the DMG, signs the DMG, submits it to Apple notarization, staples the notarization ticket, and validates the final artifact. Use an Apple app-specific password, not your normal Apple ID password.

macOS clipboard history storage path:

~/Library/Application Support/CopyTrail/history.json

Build Windows App

Win32/C++ native Windows app:

cd windows/CopyTrail.Native
./build-native.sh

WPF/.NET version on Windows:

cd windows\CopyTrail.Windows
.\build.ps1

Windows clipboard history storage path:

%AppData%\CopyTrail\history.json

Website

The static website is in site/ and is deployed with Cloudflare Workers Static Assets.

cd site
npm install
npm run dev
npm run deploy

The Worker serves public/ as static assets and dynamically generates robots.txt, sitemap.xml, and canonical URLs for the active domain.

Device Report

CopyTrail can write a basic anonymous device report to public.app_device_reports. It is triggered only when:

• The app launches for the first time.
• More than 24 hours have passed since the last successful report.
• The app version or build number changes.
• The OS version, device model, language, timezone, theme, or app language changes.

Reported fields include anonymous install ID, app version, OS version, device model, architecture, language, timezone, screen size, theme, and app language. Clipboard content is never uploaded.