English · 日本語 · 简体中文 · 한국어 · Español · Français · Deutsch · Português
Board-Man is a local-first macOS clipboard workspace for fast recall, repeated text, pins, search, images, usage signals, and keyboard-driven pasting.
The current formal product line is v0.2.1. It follows the intentional version reset from the older experimental line. Historical v0.1.x and v1.2.x tags are preserved rather than reused;
maincan still contain changes that have not yet shipped in a tagged archive.
Board-Man keeps the clipboard workflow in one compact panel instead of making you bounce between a clipboard menu, a template manager, and a settings window.
- Open clipboard history with
⌘⌥V - Search text, URLs, commands, and image entries
- Paste the selected item with Return or a single click
- Pin important entries permanently or for a timed period
- Store repeated text as reusable Templates
- Group, reorder, enable, disable, and edit Templates
- See local usage signals and style used items separately from pinned items
- Mask sensitive rows without deleting their local data
- Adjust timestamp format, timestamp position, and timestamp actions
- Show or hide image entries and place image previews on the left or right
- Tune item text size, panel height, theme, font, and display density
- Keep clipboard data local without requiring cloud synchronization
History is the main clipboard timeline. Mouse hover and keyboard navigation share the same active selection, so moving with ↑ / ↓ continues from the row currently under the pointer and moving the pointer updates the active row again.
Rows can show pins, timestamps, usage indicators, masks, and image previews without allowing those accessories to squeeze the central title into an unreadable layout. Pin labels can be displayed as OFF, P, or PIN.
Templates are reusable text entries for replies, prompts, commands, URLs, checklists, and other content you paste repeatedly.
- Single-click a Template to paste it
- Double-click a Template to open it for editing
- Use
↑/↓or the pointer to move through the same selection state - Create and rename groups
- Enable or disable a group or individual Template
- Reorder Templates without rebuilding the group
- Edit title and content in the right-side editor
The source code still uses the historical internal term snippet; the product UI uses Templates in English and 定型文 in Japanese.
The Appearance screen uses card-based controls with a live preview. The current development UI includes controls for:
- Layout: row numbers, UI density, item text size, panel height
- Timestamp: relative/absolute presentation, position, and interaction behavior
- Usage: usage counts, used-item appearance, Pin label style, image visibility and position
- Theme & color: theme preset, light/dark mode, font, and lighten option
Additional settings cover History, Templates, shortcuts, privacy, updates, licensing, excluded applications, and other panel behavior.
At narrower widths, the center title absorbs compression while Pin, timestamp, and other fixed accessories retain usable spacing. Tab labels switch to shorter localized forms instead of collapsing into ellipses.
The screenshot workflow also keeps matching Japanese scenes current:
| Action | Default interaction |
|---|---|
| Open Board-Man | ⌘⌥V |
| History / Templates / Settings | ⌘1 / ⌘2 / ⌘3 |
| Focus search | ⌘F |
| Move active row | ↑ / ↓ |
| Paste selected row | Return |
| Paste a Template | Single click |
| Edit a Template | Double click |
| Copy selected row | ⌘C |
| Pin or unpin | ⌘P |
| Preview | Space |
Timestamp actions and several other shortcuts are configurable in Settings rather than being fixed to one global default.
Clipboard history can contain passwords, tokens, customer information, private URLs, local paths, and images. Board-Man therefore keeps its working data on the Mac and does not require a cloud clipboard account.
Privacy-related behavior includes masking rows, history controls, excluded applications, and local retention settings. Review those settings before using Board-Man with especially sensitive workflows.
Board-Man uses macOS Accessibility and Input Monitoring permissions for global shortcuts and reliable direct pasting. Recent development work also includes Chromium paste reliability improvements, image clipboard identity handling, and recovery paths for older clipboard / Template records whose original payload needs reconstruction.
macOS permission prompts are never bypassed. Accessibility and Input Monitoring must be granted by the user in System Settings.
Download Board-Man v0.2.1, unzip Board-Man-v0.2.1.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.
- macOS 13 or later
- Apple Silicon or Intel Mac
- Accessibility permission for global interaction and direct paste behavior
- Input Monitoring permission for reliable shortcut handling
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 test suite 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 a local development build should use scripts/boardman/install-dev-stable.sh and read docs/boardman-dev-install.md. The helper keeps the canonical local app at /Applications/Board-Man.app, uses a stable signing identity, verifies the result, and avoids accumulating indexed development copies.
README captures are generated from isolated temporary Board-Man profiles with deterministic demo clipboard content. They do not use the maintainer's real clipboard history or Templates database.
The automatic screenshot exporter is intentionally available in Debug builds. Build a current Debug app first, then pass that app to the capture script:
BOARDMAN_SCREENSHOT_APP=/path/to/Debug/Board-Man.app \
./scripts/boardman/capture-readme-screenshots.shThe script generates English and Japanese History, Templates, Settings, and compact-width scenes under docs/assets/screenshots/, verifies the PNG dimensions, cleans up its temporary profiles, and restores the canonical app when needed.
See docs/readme-screenshots.md for the full workflow and verification checklist.
v0.2.1 is the current patch release on the formal product line introduced by v0.2.0. It keeps the rebuilt History / Templates / Settings workflow intact while shipping post-v0.2.0 fixes for large-text descenders, timestamp paste-then-shortcut actions, global shortcut recovery, Japanese Template empty-state copy, and safe repository/build cleanup.
For the authoritative development summary, see CHANGELOG.md.
- Changelog
- v0.2.1 release notes
- v0.2.0 release notes
- Development install guide
- QA checklist
- Screenshot workflow
- Release and update architecture
- UI design system
- Contributing guide
- Security policy
- Support guide
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.