English · 日本語 · 简体中文 · 한국어 · Español · Français · Deutsch · Português
Board-Man is a local-first macOS clipboard workspace that brings history, reusable templates, pins, search, usage signals, and image previews into one keyboard-driven panel.
Board-Man is under active development. The latest downloadable release is v1.2.3;
mainmay contain features that have not yet shipped in a tagged release.
- Open clipboard history instantly with
⌘⌥V - Search and paste text, URLs, commands, and images
- Pin important entries and apply timed pins
- Turn repeated text into reusable Templates
- See paste-count signals for frequently reused content
- Mask sensitive rows without deleting their local data
- Customize timestamps, shortcuts, appearance, retention, and panel behavior
- Keep clipboard data on the Mac without requiring cloud synchronization
Templates store text you paste repeatedly, such as replies, command patterns, URLs, and release checklists. They can be grouped, reordered, enabled or disabled, edited in place, and opened through group shortcuts.
The upstream code still uses the internal term snippet; the product UI uses Templates in English and 定型文 in Japanese.
Settings cover general behavior, appearance, history, Templates, privacy, updates, licensing, keyboard shortcuts, timestamps, usage indicators, and panel sizing. The interface includes English, Japanese, Simplified Chinese, and Korean product translations, with additional README translations in this repository.
At narrower widths, the panel preserves spacing for Pin badges and timestamps while the central preview text absorbs compression. Tab labels switch to shorter localized forms instead of collapsing into unreadable ellipses.
Download Board-Man v1.2.3, unzip Board-Man-v1.2.3.zip, and move Board-Man.app to /Applications.
If macOS blocks the first launch, Control-click the app and choose Open, or allow it from System Settings → Privacy & Security.
Board-Man needs Accessibility and Input Monitoring permissions for global shortcuts and reliable pasting. These permissions must be granted manually; the app does not bypass macOS TCC protections.
- Copy text, a URL, a command, or an image.
- Press
⌘⌥Vor open Board-Man from the menu bar. - Search or move through the list with the arrow keys.
- Press Return to paste the selected item into the original input field.
- Pin durable entries or save repeated text as a Template.
| Action | Shortcut |
|---|---|
| Open Board-Man | ⌘⌥V |
| History / Templates / Settings | ⌘1 / ⌘2 / ⌘3 |
| Focus search | ⌘F |
| Move selection | ↑ / ↓ |
| Paste selected item | Return |
| Copy selected item | ⌘C |
| Pin or unpin | ⌘P |
| Preview | Space |
- macOS 13 or later
- Apple Silicon or Intel Mac
- Accessibility and Input Monitoring permissions for full shortcut and paste behavior
git clone https://github.com/uniplanck/boardman.git
cd boardman
xcodebuild \
-project Board-Man.xcodeproj \
-scheme Board-Man \
-configuration Debug \
-destination 'platform=macOS' \
-skipPackagePluginValidation \
-skipMacroValidation \
buildRun the tests with:
xcodebuild \
-project Board-Man.xcodeproj \
-scheme Board-Man \
-configuration Debug \
-destination 'platform=macOS' \
-parallel-testing-enabled NO \
-maximum-parallel-testing-workers 1 \
testMaintainers installing local builds should use scripts/boardman/install-dev-stable.sh and read docs/boardman-dev-install.md.
Build a current Debug app, then run:
BOARDMAN_SCREENSHOT_APP=/path/to/Board-Man.app \
./scripts/boardman/capture-readme-screenshots.shThe script launches isolated temporary Board-Man profiles, replaces the clipboard with deterministic demo content, generates English History, Settings, compact-width, and Japanese History scenes, writes the PNG files under docs/assets/screenshots/, removes the temporary profiles, and leaves a harmless completion message on the clipboard. It never uses the maintainer's real clipboard history or Templates database.
See docs/readme-screenshots.md for the full workflow and verification checklist.
- Changelog
- Development install guide
- QA checklist
- Screenshot workflow
- Release and update architecture
- UI design system
- Contributing guide
- Security policy
- Support guide
Clipboard history can contain passwords, tokens, customer information, private URLs, and local paths. Review the Privacy settings, mask sensitive rows when useful, and avoid committing real clipboard data, .env files, credentials, or local authentication material.
The README screenshots are generated only from isolated demo profiles. Security reports should follow .github/SECURITY.md.
Board-Man is a heavily modified derivative of Clipy and preserves upstream attribution and license notices:
Board-Man is distributed under the inherited MIT license terms and is not endorsed by the upstream Clipy or ClipMenu maintainers.