https://github.com/razee4315/clipstream
A lightweight, context-aware clipboard manager for Windows that feels native to the OS.
https://github.com/razee4315/clipstream
clipboard clipboard-history clipboard-manager copy-paste copy-paste-tool productive productive-tool
Last synced: 1 day ago
JSON representation
A lightweight, context-aware clipboard manager for Windows that feels native to the OS.
- Host: GitHub
- URL: https://github.com/razee4315/clipstream
- Owner: Razee4315
- License: mit
- Created: 2025-11-29T10:49:29.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-06-25T21:02:57.000Z (1 day ago)
- Last Synced: 2026-06-25T21:05:53.989Z (1 day ago)
- Topics: clipboard, clipboard-history, clipboard-manager, copy-paste, copy-paste-tool, productive, productive-tool
- Language: C++
- Homepage:
- Size: 387 KB
- Stars: 9
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# ClipStream
A fast, native clipboard manager for Windows — built in C++ with Qt 6.
ClipStream remembers everything you copy — text and images — and brings it back
instantly with a global hotkey, full-text search, and one-keystroke paste.
> **Note:** ClipStream was originally built with Tauri (Rust + Preact). It has been
> rebuilt from the ground up in **C++/Qt 6** for a smaller, faster, fully native app.
> The original implementation lives on the [`legacy`](../../tree/legacy) branch.
## Features
- **Event-driven capture** — listens to the OS clipboard, no polling, ~0% idle CPU
- **Global hotkey** — `Ctrl+Shift+V` opens the overlay anywhere, at your cursor
- **Full-text search** — instant SQLite FTS5 search across your history
- **Text & images** — images stored as files on disk (not bloating the database)
- **Smart actions** — open URLs, reveal files, convert colours, evaluate maths
- **Format on paste** — paste as UPPER / lower / Title / trimmed
- **Quick paste** — `Ctrl+1`–`9` to paste the Nth clip instantly
- **Snippets** — save reusable text (`Ctrl+N`), kept pinned at the top
- **Source tracking** — shows which app each clip came from
- **Privacy first** — masks detected secrets, excludes password managers, pause toggle
- **Themes** — System / Dark / Light
- **Lightweight & native** — ~39 MB bundle, single-file installer ~13 MB
## Install
Download the latest installer from [Releases](https://github.com/Razee4315/clipstream/releases),
or build from source below.
## Shortcuts
| Shortcut | Action |
|----------|--------|
| `Ctrl+Shift+V` | Open / close the overlay |
| `↑` `↓` | Navigate |
| `Enter` | Paste selected |
| `Shift+Enter` | Paste with formatting |
| `Ctrl+1`–`9` | Quick-paste the Nth clip |
| `Ctrl+O` | Open link / file (smart action) |
| `Ctrl+N` | New snippet |
| `F2` | Edit clip |
| `Shift+Del` | Delete clip |
| `Esc` | Close |
## Tech stack
- **Language:** C++17
- **UI:** Qt 6 Widgets (frameless translucent overlay, model/view, custom delegate)
- **Storage:** SQLite + FTS5 via Qt SQL
- **Platform:** Win32 (`RegisterHotKey`, `SendInput`, `GetForegroundWindow`) behind a
cross-platform abstraction (Linux/macOS stubs ready to implement)
- **Build:** CMake + Ninja (MinGW); packaged with windeployqt + Inno Setup
## Build from source
Requires Qt 6 (MinGW kit), CMake, and Ninja.
```powershell
# Configure (Release, Ninja)
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release `
-DCMAKE_PREFIX_PATH="C:/Qt/6.11.1/mingw_64"
# Build
cmake --build build
# Bundle the Qt runtime to run anywhere
windeployqt --release --no-translations dist\ClipStream\ClipStream.exe
```
CI builds and packages an installer on every push (see `.github/workflows/build.yml`).
## Project layout
```
src/
├─ main.cpp, theme.{h,cpp}, AppController.{h,cpp}
├─ core/ ClipboardMonitor · Database (SQLite/FTS5) · ContentClassifier · MathEval
├─ ui/ OverlayWindow · HistoryModel · EntryDelegate · SettingsDialog
└─ platform/ HotkeyManager · ForegroundApp · PasteSimulator · Autostart
├─ win/ (Windows implementations)
└─ stub/ (Linux/macOS placeholders)
```
## Author
**Saqlain Abbas**
[](https://www.linkedin.com/in/saqlainrazee/)
[](https://github.com/razee4315)
## License
[MIT License](LICENSE) — feel free to use and modify.
## Contributing
Contributions welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.