ClipboardFilter

A secure clipboard filtering application that automatically detects and masks sensitive information in real-time.

✨ Features

• 🔒 112 pre-configured filters across 7 categories
• 🌍 Multi-language support (EN, FR, DE, ES, IT)
• ⚡ Real-time filtering with global hotkey (Ctrl+Shift+V)
• 📦 Template system for import/export
• 🎨 Auto theme detection (Light/Dark)
• 🗂️ Custom folders for organization
• ⚙️ Regex support for advanced patterns

📥 Download

Get the latest release for your platform:

• Windows: ClipboardFilter-Setup.exe

• Linux/Unix:

  • AppImage (Universal)
  • .deb (Debian/Ubuntu)
  • .rpm (Fedora/RHEL)

• macOS: ClipboardFilter.dmg for new Apple chip (ARM64)

  • Note : For macOS, this application are not compatible with Intel chips and PowerPC architecture.

🚀 Quick Start

Windows

1. Download ClipboardFilter-Setup.exe
2. Run the installer
3. Launch from Start Menu
4. Copy sensitive text and press Ctrl+Shift+V to paste filtered content

Linux

# AppImage
chmod +x ClipboardFilter-*.AppImage
./ClipboardFilter-*.AppImage

# Debian/Ubuntu
sudo dpkg -i clipboard-filter_*.deb

# Fedora/RHEL
sudo rpm -i clipboard-filter-*.rpm

macOS

1. Download ClipboardFilter.dmg
2. Open and drag to Applications
3. Launch ClipboardFilter

📖 Usage

Default Filters

ClipboardFilter includes 112 filters across these categories:

Category	Count	Examples
💻 Developer	33	API keys, tokens, secrets
💰 Finance	20	Credit cards, IBAN, crypto
👤 Personal	12	Emails, phones, addresses
🏥 Health	3	Social security numbers
👔 HR	5	Employee IDs, badges
⚙️ System	31	IPs, paths, UUIDs
💬 Communication	8	Slack, Discord, Teams

Creating Custom Filters

1. Click "+ Add Filter"
2. Fill in:
   • Description: Filter name
   • Category: Classification
   • Pattern: Text or regex to detect
   • Replacement: Substitution text
   • ☑️ Use Regex: For pattern matching
3. Click "Save"

Example:

Description: Employee Badge
Pattern: BADGE-\d{6}
Replacement: BADGE-******
☑ Use Regex

Templates

Export/import filter collections:

# Export your custom filters
Templates > Export JSON > "My Filters"

# Import a template
Templates > Import JSON > Select file

🛠️ Development

Prerequisites

• Node.js 18+
• npm 9+

Setup

git clone https://github.com/50bvd/clipboardfilter.git
cd clipboardfilter
npm install

Build

npm run build      # Compile TypeScript
npm start          # Run in development

Package

npm run package:win          # Windows
npm run package:linux:deb    # Linux (Debian)
npm run package:mac          # macOS

📚 Documentation

• User Guide - Complete user manual
• Developer Guide - Technical documentation

🤝 Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit changes: git commit -m 'Add amazing feature'
4. Push to branch: git push origin feature/amazing-feature
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👤 Author

Loup LIGNON KRASNIQI

• GitHub: @50bvd
• Email: loup.lk-pro@protonmail.ch

🙏 Acknowledgments

• Built with Electron
• Icons from Lucide

---

⭐ Star this repo if you find it useful!