ClipMD

Cross-platform system tray tool that detects clipboard content and lets you save it as .md files with a single click on a mouse-side bubble.

简体中文 · 繁體中文

Features

• Clipboard Monitoring — Event-driven, zero-polling, no CPU overhead
• Mouse-side Bubble — A small M↓ icon pops up near the cursor when content is detected; left-click to save
• Smart File Naming — Automatically extracts 4 keywords via jieba segmentation for the filename (e.g. 检索_RAG_架构_分析.md)
• Smart Suppression — No bubble when copying inside VS Code / Typora / Obsidian and other editors
• Global Hotkey — Ctrl+Alt+M to force-save current clipboard as Markdown
• System Tray — Right-click menu to manage save path, pause monitoring, toggle auto-start, etc.
• High DPI Support — Works with 4K displays and various scaling ratios
• Dark / Light Theme — Automatically follows the system theme (Windows / macOS)

Installation

Option 1: Download Pre-built Binary (Recommended)

Grab the latest build from the Releases page:

Platform	File	Notes
Windows	ClipMD.exe	Double-click to run
macOS	ClipMD-macOS	Run chmod +x ClipMD-macOS first, then double-click or launch from terminal

Option 2: Run from Source

git clone https://github.com/fluten/ClipMD.git
cd ClipMD
pip install -r requirements.txt
python main.py

macOS users do not need pywin32; all other dependencies are the same.

Usage

1. On first launch a welcome dialog lets you choose the save directory
2. Copy any text — a small M↓ icon appears near the cursor
3. Left-click the icon to save as .md; the icon turns into a green ✓ on success
4. Right-click the icon or wait 3 seconds to dismiss
5. Right-click the system tray icon to:
   • Set / open the save folder
   • View recently unsaved items
   • Pause / resume monitoring
   • Toggle launch at startup

File Naming

Saved files are named automatically with a three-tier fallback:

1. 4 extracted keywords joined by underscores: 检索_RAG_架构_分析.md
2. Falls back to the first 10 characters of the content
3. Falls back to a timestamp: 20260404_143022.md

Hotkeys

Shortcut	Action
Ctrl+Alt+M	Force-save current clipboard as .md

On macOS the global hotkey requires Accessibility permission in System Settings.

Building from Source

Windows:

pip install pyinstaller
pyinstaller ClipMD.spec --clean -y

macOS:

pip install pyinstaller
pyinstaller --onefile --noconsole --collect-data jieba --name ClipMD main.py

The output binary is located in the dist/ directory.

System Requirements

Platform	Requirement
Windows	Windows 10 / 11
macOS	macOS 12 Monterey or later

Pre-built binaries include all runtime dependencies — no Python installation required.

Tech Stack

• Python 3.10+ / PyQt6 / jieba
• Platform-specific: pywin32 (Windows), fcntl (macOS / Linux)
• GitHub Actions CI for dual-platform builds
• PyInstaller packaging

Changelog

v1.2.0 (2026-04-07)

• Internationalization: English / Simplified Chinese / Traditional Chinese
• Auto-detects system language on first launch
• Language switcher in the tray menu (takes effect after restart)
• Added README.zh-TW.md (Traditional Chinese)

v1.1.0 (2026-04-04)

• macOS support via the new platform_utils abstraction layer
• GitHub Actions CI auto-builds Windows + macOS binaries on tag push
• README internationalized: English as default, Chinese moved to README.zh-CN.md

v1.0.1 (2026-04-04)

• Smart filename generation using jieba keyword extraction (4 keywords joined by underscores)
• Three-tier fallback: keywords → first 10 characters → timestamp
• Auto-denoising: filters Markdown symbols, conversational filler prefixes, URLs, emoji
• Filename sanitization: illegal character removal, 50-char truncation, consecutive underscore merging

v1.0.0 (2026-04-04)

• Clipboard monitoring with mouse-side bubble for one-click save as .md
• Smart suppression in VS Code / Typora / Obsidian and other editors
• Global hotkey Ctrl+Alt+M to force-save current clipboard
• System tray with right-click menu for settings
• Auto dark / light theme following the system, high DPI support, launch at startup