📋 Clipber

A lightning-fast, privacy-first clipboard manager and history vault for Windows.

📥 Download Latest Installer (.exe)  •  📦 Download Portable (.zip)  •  🚀 All Releases

---

✨ Features

• ⚡ Instant Quick Popup (Win + Shift + V): A glassmorphic overlay appears right at your mouse cursor. Search your recent clipboard history with real-time debounce, preview contents, and copy or paste with one key.
• 🗄️ Comprehensive History Vault (Win + Shift + H): A dedicated management window for browsing all-time history with pagination, detailed preview, and advanced multi-mode search.
• 🔍 Multi-Mode Search:
  • Exact: Match literal text or substrings.
  • Fuzzy: Forgiving search for typos and partial phrases.
  • Regex: Full regular expression pattern matching.
• 🏷️ Smart Content Classification: Automatically detects and tags clip types:
  • 🔗 URLs
  • ✉️ Emails
  • 💻 Code snippets
  • 📁 File paths
  • 🖼️ Images
  • 📝 Plain text
• 📌 Pinning & Organization: Pin frequent or critical clips so they are never purged. Group and organize clips with customizable tags.
• 🖥️ Source App Tracking & Exclusions: See which application generated each clip. Easily filter by app, or exclude sensitive apps (like password managers) from clipboard recording.
• 🔒 100% Offline & Privacy-First: All data is stored locally in SQLite (%AppData%\ClipboardVault\vault.db). Zero telemetry, zero analytics, zero external network calls.
• 🧹 Automated Retention: Set retention limits and automatic cleanup rules to keep database size minimal and performance snappy.
• 🪟 System Tray Resident: Runs quietly in the background with minimal memory consumption and optional Windows startup integration.

---

⌨️ Shortcuts

Shortcut	Action	Description
Win + Shift + V	Quick Popup	Opens clipboard history near cursor with live search
Win + Shift + H	History Vault	Opens full vault manager with filters and regex search
Enter	Paste / Select	Copies selected clip and pastes directly into active window
Esc	Dismiss	Closes popup overlay immediately
P	Pin / Unpin	Toggles pin state on the highlighted clip
Delete	Delete	Removes the highlighted clip from your history

---

🚀 Installation

Option 1: Setup Installer (Recommended)

1. Download Clipber-Setup-1.0.0.exe.
2. Run the installer (no administrator privileges required for current user install).
3. Check Launch at Windows startup if you want Clipber to start automatically.
4. Finished! Clipber will appear in your system tray.

Option 2: Portable ZIP

1. Download Clipber-v1.0.0-win-x64.zip.
2. Extract the archive into any folder of your choice.
3. Run Clipber.exe.

---

🛠️ Building from Source

Prerequisites

• Windows 10 / 11 (64-bit)
• .NET 8.0 SDK
• (Optional) Inno Setup 6 to build the installer

1. Clone the repository

git clone https://github.com/zhmdff/Clipber.git
cd Clipber

2. Run in Development Mode

dotnet run -c Debug

3. Run Tests

dotnet test

4. Build Standalone Installer

powershell -ExecutionPolicy Bypass -File installer/build-installer.ps1

The compiled installer will be output to dist/Clipber-Setup-<version>.exe.

---

🏗️ Architecture

Clipber
├── Models/             # ClipEntry, ClipType, Tag, AppSetting
├── Data/               # EF Core SQLite AppDbContext
├── Services/           # Win32 ClipboardMonitor, HotkeyService, TypeDetector, StorageService
├── ViewModels/         # MVVM CommunityToolkit ViewModels (Popup, Vault, Settings)
├── Views/              # WPF XAML Glassmorphic overlays & windows
└── installer/          # Inno Setup script & automated build pipeline

• Storage: Entity Framework Core with SQLite database located at %LocalAppData%\ClipboardVault\vault.db.
• Hooks: Native Win32 API hooks (AddClipboardFormatListener, RegisterHotKey) running asynchronously to ensure zero UI stutter.
• UI: Modern WPF styling with dark-mode aesthetic, micro-animations, and DPI-aware positioning.

---

📄 License

Distributed under the MIT License. See LICENSE for more information.