DotGhostBoard
Advanced cryptographic & privacy-first clipboard manager for Linux with hardware-level secure wiping
๐ป DotGhostBoard
Advanced clipboard manager for Kali Linux โ part of the DotSuite toolkit.
What is DotGhostBoard?
DotGhostBoard is a lightweight, privacy-first clipboard manager built natively for Linux. It runs silently in the background, capturing everything you copy โ text, images, and video paths โ and stores them locally in a SQLite database. No cloud. No telemetry. No Electron.
Think Ditto (Windows) or CopyQ (Linux) โ but built for the DotSuite ecosystem with a Kali-native dark aesthetic.
DotGhostBoard UI Demo
DotGhostBoard Capture Demo
Features
- Text capture โ Every text you copy is saved instantly
- Image capture โ Screenshots and copied images saved as
.png - Video path detection โ Detects copied file paths for
.mp4,.mkv,.avi, and more - Pin system โ Pin important items; they are protected from deletion forever
- Persistent storage โ SQLite database survives reboots
- Real-time search โ Filter your clipboard history instantly
- Clear history โ Wipe unpinned items in one click (pinned items always stay)
- System tray โ Lives quietly in your tray, always available
- Global Shortcuts โ
Ctrl+Alt+Vtoggles the dashboard from anywhere;Ctrl+Alt+Spaceopens the floating Spotlight search overlay (GNOME & XFCE native) - Tiling Window Manager Support (EWMH) โ Seamless cross-workspace migration upon summon (
Ctrl+Alt+V,dotghostboard --toggle) on Qtile, Openbox, and EWMH-compliant window managers; migrates to your active workspace and focuses without hiding - Spotlight Quick Search โ Floating, instant clipboard search overlay (
Ctrl+Alt+Space); search, navigate with arrows, copy, and close instantly with zero window flicker; protected by Eclipse Master Password - In-Dashboard Search โ
Ctrl+Finstantly focuses and selects the search bar within the main dashboard - App icon โ Auto-generated neon ghost icon via
scripts/generate_icon.py - Dark Neon UI โ Custom QSS theme built for dark desktops
- Settings panel โ โ Max history limit, privacy clear-on-exit, theme toggle
- Desktop notifications โ Settings โ Notifications โ Enable desktop notifications โ Save. Changes apply immediately; security alerts, update alerts, and notification sounds can be controlled separately. Disabling desktop notifications keeps secret protection active.
- Unified unlock and Vault-aware protection โ By default, enter your Master Password once to unlock both Dashboard and Vault. Settings โ Eclipse โ Vault Password can enable an independent password, requested immediately after Dashboard authentication. Capture waits for both steps. Secret recognition is initialized before capture resumes, so ordinary text is recorded immediately and stored Vault values stay out of history and sync even with heuristic detection disabled. The Vault still auto-locks independently after its idle timeout; recognition continues until the application exits. Locking the whole session locks both. Unified unlock was introduced in v2.1.3.
- Dashboard auto-lock โ Optional in Settings โ Eclipse: Disabled (default), 5 minutes, 30 minutes, or 1 hour of inactivity. Locking hides Dashboard and Spotlight and clears decryption keys, while protected local capture continues after the first successful login. API and LAN sync stay stopped while locked. Pause Monitoring explicitly stops capture, including while locked; tray status shows the difference. New suspected secrets are excluded while locked until you unlock and copy again to review. The Vault keeps its separate idle lock.
- Imported-password protection โ The password field of CSV-imported records is also recognized independently of the full username/URL/notes record, including existing imports. An unreadable Vault key displays an error and exits safely without resetting data.
- Backup & Recovery โ Settings โ Recovery lets you select entries or enable All items / Auto Sync. The latest encrypted copy updates after changes; daily, weekly, or monthly versions are retained separately from safety/manual copies. Choose a folder and backup passphrase, preview and restore versions, or recover into a new profile if the original is lost. Scheduled work runs while the app and Vault are unlocked and catches up on unlock. Setup, retention, failure handling, and restore guide.
- Keyboard navigation โ
โ/โto move between cards,Enterto copy,Escto clear focus - Double-click to paste โ Double-click any card to copy it instantly
- Standalone autostart โ
scripts/setup_autostart.pysets up boot entry without bash - Image thumbnail previews โ Lazy-loaded thumbnails capped at 300ร180px; deferred rendering via
QTimer.singleShot - Video thumbnails via ffmpeg โ First-frame extraction from video files; background thread processing; graceful fallback if ffmpeg unavailable
- Auto-cleanup โ Configurable
max_captureslimit (default 100); oldest unpinned captures deleted from disk on startup - Image viewer popup โ Full-size image preview with smooth scaling;
Ctrl+Cto copy image;Escapeto close - Copy image to clipboard โ Image items now copy actual image data (not file path) back to clipboard
- Drag & drop reorder โ Pinned cards show drag handle; reorder persists via
sort_orderin database - Tag system โ Assign custom
#tagsto any item; colored chip display with rotating 6-palette colors; inline autocomplete from existing tags
Tag System Demo
- Combined search โ Search by text and tag simultaneously (e.g.
"python #code"); tag-only filter works on all item types - Collections & Drag-and-Drop โ Group items into named folders; sidebar panel with click-to-filter, right-click to rename/delete. Features intuitive drag-and-drop interface for organizing items.
Drag and Drop Collections Demo
- Multi-select โ
Ctrl+Clickto toggle,Shift+Clickfor range selection; neon greenโoverlay on selected cards
Multi-Select Demo
- Local Encryption (Eclipse Mode) โ Secure sensitive clipboard items using AES-256 encryption. Items are hidden and locked behind a Secret Overlay until explicitly revealed.
Local Encryption Demo
- Session Lock & Master Password โ Protect your entire dashboard with a Master Password. Features automatic timeout locking and a stylish blurred lock screen.
Session Lock Demo
- Advanced Settings & Pro UI โ Comprehensive control over Stealth Mode, App Filters, Auto-lock timeouts, and a beautiful DotSuite licensing/about page.
Settings and About Demo
-
Bulk actions toolbar โ Appears when 2+ selected: Pin All, Unpin All, Add Tag, Export, Delete All, Cancel
-
Export โ Export selected items to
.txt(timestamped blocks) or.json(structured data with tags) -
Global tag manager โ โ Settings โ "Manage Tagsโฆ"; rename or delete tags across all items in one click
-
Drag & drop visual feedback โ Ghost pixmap with neon border while dragging; source card dims to 35%; drop targets highlight with dashed green border
-
E2EE Local Network Sync (Nexus) โ End-to-end encrypted clipboard synchronization across your local network. AES-256-GCM protection with X25519 (ECDH) handshakes.
-
mDNS Auto-Discovery โ Zero-config discovery of peers on the same WiFi.
-
REST API โ Token-protected local-network API for history, item pushing, and pairing workflows.
-
CLI Companion โ
dotghost pushanddotghost popfrom your terminal for seamless shell workflow. -
Secure Device Pairing โ PIN-protected handshakes to ensure unauthorized devices can't intercept your sync data.
-
The Vault Subsystem (
Ctrl+Shift+V) โ Dedicated encrypted drawer panel (vault.db) with envelope encryption (domain-separated KEK + per-database DEK), masked secrets, search filtering, category pills, constant-time deduplication, and auto-scrubbing. Features an expanded 380px drawer with a clean two-row header and an informative Empty State Tips Card. -
Zero-Log Secret Detector โ Shannon entropy analysis & regex heuristics detecting API keys, tokens, and passwords on copy, offering one-click "Send to Vault" and auto-scrub actions without leaving plaintext in history.
-
Desktop Notifications โ Native FreeDesktop desktop notifications (
notify-send) with interactive click-to-summon callbacks. -
Copy Count Badge โ Each card shows a live pill badge (
ร2,ร5,ร10+) tracking how many times an item has been copied. Color escalates from teal โ orange โ ๐ฅ as the count grows. -
Auto-Pin Suggestion โ At
ร5copies a non-blocking toast appears suggesting you pin the item. Atร10the item is auto-pinned silently so frequently-used text is always protected from deletion. -
Smart Auto-Tagging (Leviathan) โ Zero-overhead rules engine automatically categorizes incoming clips (
#link,#code,#json,#secret,#email,#ip,#phone,#path,#hash) using local regex heuristics. -
Contextual Smart Actions โ Inline card actions tailored to content type:
๐ Open Linkin browser,{ } Format JSONwith indentation,โ Composeemail,๐ก Copy IP, or๐ก โ Vaultto securely encrypt credentials. -
Built-in Vault Password & Token Generator โ Cryptographically strong password/token generator in Add/Edit Secret dialog (
โก Generate) with customizable length, symbols, and live Shannon entropy strength bar. -
Vault Password History โ Retains last 3 previous encrypted password versions (
vault_item_history) with single-click reveal, copy, or revert via dedicated๐history modal dialog. -
Vault Encrypted Export & Import (
.vault) โ New AES-256-GCM backup packages use Argon2id (64 MiB, 3 passes, 1 lane). Legacy PBKDF2 backups remain readable. Exports include all secrets, 3-version history, and expiry dates. -
Secret Expiration Dates & Status Badges โ Optional expiration dates on vault items (
30d,90d,180d,1y, or custom date picker) with live visual card status badges (โ EXPIRED,โ ๏ธ Xd left,โณ YYYY-MM-DD). -
Vault Plaintext History Sweep โ Deleting or scrubbing a secret from The Vault automatically purges any lingering unencrypted plaintext copies from clipboard history.
-
Dynamic Auto-Purge History โ Configurable history threshold dynamically enforced from Settings, auto-purging oldest unpinned items while respecting pin immunity.
-
Unified Password Input & Masking (
PasswordInputWidget) โ Reusable password input with integrated๐๏ธ / ๐eye toggle, unified design system, and compact, balanced spacing across both App Session Lock and Vault Unlock screens. -
Modern Typography & Aesthetic โ Clean sans-serif UI typography (
Inter/Noto Sans), muted dark-slate theme, refined card padding, compact 26ร26 action buttons, and customizable shortcuts button in Settings. -
Mouse Selection Monitoring (PRIMARY Selection) โ Optional automatic capture of text highlighted with the mouse (X11
PRIMARYselection, Issue #2) with 450ms anti-flood debouncing and smart 3-way consolidation (forward append, backward prepend, recoil boundary trimming). -
Dynamic Primary-to-Clipboard Sync โ Automatically synchronizes mouse-highlighted text to the system
CLIPBOARDbuffer (Ctrl+V) without echo loops, so selecting text with mouse immediately enables pasting viaCtrl+Vacross any application. -
Card Middle-Click to PRIMARY โ Middle-clicking any item card (
Qt.MouseButton.MiddleButton) instantly copies its contents into the LinuxPRIMARYselection buffer for native X11 middle-click pasting. -
Mouse Clip Badge (
๐ฑ๏ธ mouse) โ Distinct emerald pill badge rendered on cards captured via mouse drag to easily differentiate from manualCtrl+Ckeyboard copies. -
Subtle Audio Feedback โ Configurable non-blocking sound feedback on clipboard capture with 4 built-in synthesized presets (
Ghost Pop,Crystal Chime,Tactile Click,Cyber Beam) and custom audio file chooser (.wav,.mp3,.ogg,.flac). -
Vault Multi-Format CSV Importer โ Dedicated wizard for The Vault supporting Bitwarden, KeePassXC, 1Password, Google Chrome, and generic CSV credential exports with preview table and duplicate protection.
Native Desktop Integration: DotGhostBoard integrates seamlessly with desktop environment dock and app launcher.
Project Structure
DotGhostBoard/
โโโ main.py # Entry point + IPC local server (--toggle, --spotlight)
โโโ core/
โ โโโ constants.py # App-wide constants (PAGE_SIZE, thresholds)
โ โโโ config.py # Runtime configuration helpers
โ โโโ paths.py # XDG path resolution
โ โโโ crypto.py # AES-256-GCM + HKDF domain-separated key derivation
โ โโโ notifications.py # FreeDesktop notification dispatcher (action callbacks)
โ โโโ window_manager.py # Pure ctypes EWMH X11 window management
โ โโโ watcher.py # Clipboard Orchestrator โ Backend + Pipeline
โ โโโ shortcuts.py # Global desktop shortcut manager (GNOME/XFCE)
โ โโโ autostart.py # Modular XDG autostart desktop entry manager
โ โโโ sync_engine.py # E2EE background push worker (Nexus)
โ โโโ network_discovery.py # Zeroconf mDNS peer discovery (Nexus)
โ โโโ api_server.py # Local REST API & Handshake handler (Nexus)
โ โโโ pairing.py # PIN-based ECDH handshake logic (Nexus)
โ โโโ updater.py # GitHub auto-updater engine
โ โโโ app_filter.py # App whitelist/blacklist (Eclipse)
โ โโโ media.py # Image/video handler
โ โโโ audio.py # Non-blocking audio dispatcher (pw-play, paplay, aplay, mpv)
โ โโโ clipboard/ # Clipboard pipeline & backend abstraction
โ โ โโโ events.py # ClipboardEvent, CaptureDecision, Action enum
โ โ โโโ pipeline.py # Pure policy engine (no Qt dependency)
โ โ โโโ backend.py # ClipboardBackend Protocol
โ โ โโโ backends/qt_backend.py # Qt polling backend
โ โโโ security/ # Security domain layer
โ โ โโโ detector.py # SecretDetector (regex & entropy heuristics)
โ โ โโโ auto_tagger.py # Rules-based auto-tagging engine (Leviathan)
โ โ โโโ vault/ # Vault: isolated vault.db + DEK envelope encryption
โ โโโ services/ # Business logic layer (Qt-free)
โ โ โโโ history_service.py # Clipboard item queries, pins, tags, copy thresholds
โ โ โโโ collection_service.py # Collection management & categorization
โ โ โโโ security_service.py # Session lock, password lifecycle, Eclipse encryption
โ โ โโโ sync_service.py # Peer trust & LAN sync orchestration
โ โโโ storage/ # Persistence layer
โ โโโ database.py # Context-managed SQLite connection
โ โโโ migrations.py # Versioned schema migrations
โ โโโ __init__.py # Backward-compatible facade
โ โโโ repositories/
โ โโโ clips.py # Clipboard item CRUD, encryption, search
โ โโโ tags.py # Tag normalization & global rename/delete
โ โโโ collections.py # Collection categorization
โ โโโ peers.py # Trusted device credentials
โ โโโ stats.py # Header metrics & copy counts
โโโ ui/
โ โโโ dashboard.py # Window shell + signal bus (Orchestrator โค 500 LOC)
โ โโโ dashboard_compat.py # DashboardCompatibilityMixin architectural shim
โ โโโ window_utils.py # EWMH cross-workspace migration & dialog modality
โ โโโ components/ # Isolated UI layout components
โ โ โโโ __init__.py # Component exports
โ โ โโโ sidebar.py # SidebarWidget (collections & devices layout)
โ โ โโโ topbar.py # TopBarWidget (header, logo, stats, action buttons)
โ โ โโโ cards_view.py # CardsView (QScrollArea container & DnD signals)
โ โ โโโ bulk_toolbar.py # BulkToolbar (HintStrip & BulkBar)
โ โ โโโ tray_manager.py # DashboardTrayManager (tray icon, context menu, tooltips)
โ โโโ controllers/ # Behavioral QObject controllers
โ โ โโโ history_controller.py # Card lifecycle, pagination, search, pin/copy/delete
โ โ โโโ collection_controller.py # Sidebar, drag-drop, collection CRUD
โ โ โโโ security_controller.py # Lock/unlock, secret copy, Eclipse encrypt/decrypt
โ โ โโโ sync_controller.py # Peer pairing, device list, broadcast
โ โ โโโ update_controller.py # Update check worker and notification trigger
โ โโโ vault/ # The Vault UI subsystem
โ โ โโโ vault_panel.py # Slide-out Vault drawer widget (two-row header & tips card)
โ โ โโโ vault_controller.py # Vault lifecycle & duplicate detector
โ โ โโโ secret_card.py # Masked secret card with reveal/copy/scrub
โ โ โโโ secret_dialog.py # Add/Edit secret modal
โ โ โโโ history_dialog.py # Password history viewer & version revert modal
โ โ โโโ backup_dialog.py # Passphrase modal for encrypted export & import (.vault)
โ โ โโโ csv_import_dialog.py # CSV credential import wizard modal (Bitwarden, KeePassXC)
โ โ โโโ unlock_dialog.py # Vault master password unlock dialog
โ โ โโโ send_to_vault.py # Bridge from clipboard cards to Vault
โ โโโ widgets/ # Modular widget package
โ โ โโโ item_card.py # Full clipboard card widget
โ โ โโโ stats_header.py # Header stats bar
โ โ โโโ pin_toast.py # Non-blocking pin suggestion toast
โ โ โโโ tag_chip.py # Tag chip widget
โ โ โโโ tag_input.py # Inline tag autocomplete input
โ โ โโโ password_input.py # Composite PasswordInputWidget with eye visibility toggle
โ โโโ spotlight.py # Floating Spotlight quick search overlay
โ โโโ settings/ # Settings package (decomposed)
โ โ โโโ __init__.py # Backward-compatible facade
โ โ โโโ _io.py # Settings I/O and defaults
โ โ โโโ dialog.py # SettingsDialog orchestrator shell
โ โ โโโ pages/ # Tab builders (General, Security, API, About)
โ โโโ tag_manager.py # Standalone TagManagerDialog
โ โโโ lock_screen.py # Session lock screen
โ โโโ pairing_dialog.py # Device pairing UI (Nexus)
โ โโโ updater_dialog.py # GUI for GitHub updates
โ โโโ update_log_screen.py # Update installation log & process relauncher
โ โโโ ghost.qss # Dark Neon theme stylesheet
โโโ cli/
โ โโโ dotghost.py # Command-line companion (push, pop, spotlight, toggle)
โโโ data/
โ โโโ icons/ # Generated app icons + ghost.svg source
โ โโโ captures/ # Sample captures (.png)
โ โโโ assets/ # GIFs, screenshots, demo media
โ โโโ settings.json # Bundled default settings template
โโโ scripts/
โ โโโ generate_icon.py # Draws ghost icon at 16/32/48/64/128/256px
โ โโโ generate_sounds.py # Wave audio synthesizer generating custom UI feedback presets
โ โโโ install.sh # Autostart + shortcut + CLI symlinker
โ โโโ setup_shortcuts.py # Desktop shortcut configurator (GNOME/XFCE)
โ โโโ build_appimage.sh # AppImage builder
โ โโโ setup_autostart.py # Standalone Python autostart installer
โโโ tests/
โ โโโ test_primary_selection.py# Primary selection, mouse ergonomics & audio tests
โ โโโ test_api.py # REST API & Sync tests
โ โโโ test_autostart.py # Autostart manager tests
โ โโโ test_eclipse.py # Encryption & Security tests
โ โโโ test_ipc_spotlight.py # IPC, Spotlight & Shortcuts tests (220 total passed)
โ โโโ test_media.py # Media detection tests
โ โโโ test_runtime_dir.py # Runtime directory tests
โ โโโ test_storage.py # Database CRUD tests
โโโ roadmap(v1.x).md
โโโ CHANGELOG.md
โโโ requirements.txt
โโโ pytest.ini
โโโ .gitignoreRequirements
| Dependency | Version |
|---|---|
| Python | 3.11+ |
| PyQt6 | 6.6.0+ |
| Pillow | 10.0.0+ |
| cryptography | 44.0.0+ (Argon2id support) |
| pytest | 7.0.0+ |
๐ฅ Download
Packages below are for v2.1.4. Download links become available when the GitHub release is published.
Binary compatibility: these builds were produced on Kali Rolling 2026.3 and
include a library requiring GLIBC_2.43. Older Debian/Ubuntu systems may not run
them; AppImage has the same runtime requirement. Older-distribution compatibility
has not yet been established by rebuilding and testing on those systems.
- ๐ง AppImage โ Portable Linux build
- ๐ฆ DEB โ Debian / Ubuntu / Kali
- ๐ฆ Arch package โ
.pkg.tar.zst - ๐๏ธ Portable tarball โ Extract & run on compatible Linux systems
Installation
Option A โ System Python (Kali Linux)
PyQt6 and Pillow are usually pre-installed on Kali:
git clone https://github.com/kareem2099/DotGhostBoard.git
cd DotGhostBoard
python3 main.pyOption B โ Virtual Environment (Recommended)
git clone https://github.com/kareem2099/DotGhostBoard.git
cd DotGhostBoard
# Create isolated environment
python3 -m venv venv --system-site-packages
source venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Generate app icon (run once)
python3 scripts/generate_icon.py
# Run
python3 main.pyOption C โ pip install (PyPI)
Note: PyPI package publication is planned; use DEB, AppImage, or Git clone for the published release.
# Planned for PyPI release
pip install dotghostboard
dotghostboardOption D โ AppImage (Portable)
Download the v2.1.4 AppImage, then:
chmod +x DotGhostBoard-2.1.4-x86_64.AppImage
./DotGhostBoard-2.1.4-x86_64.AppImageNo installation required. Runs on compatible 64-bit Linux distributions.
Option E โ Full install (autostart + shortcut + icon)
chmod +x scripts/install.sh
./scripts/install.shThis configures autostart, the desktop launcher, CLI companion, and global shortcuts on supported GNOME/XFCE desktops:
Ctrl+Alt+Vโ Toggle DashboardCtrl+Alt+Spaceโ Spotlight Quick Search
Option F โ Build AppImage from source
pip install pyinstaller
chmod +x scripts/build_appimage.sh
./scripts/build_appimage.shOption G โ DEB Package (Debian/Ubuntu/Kali)
Quick install from Releases:
# Download v2.1.4 from GitHub Releases
wget https://github.com/kareem2099/DotGhostBoard/releases/download/v2.1.4/dotghostboard_2.1.4_amd64.deb
# Install via apt
sudo apt install ./dotghostboard_2.1.4_amd64.deb
# Run
dotghostboardOr build locally:
# Clone and build
git clone https://github.com/kareem2099/DotGhostBoard.git
cd DotGhostBoard
# Build the .deb package
chmod +x scripts/build_deb.sh
./scripts/build_deb.sh
# Install
sudo dpkg -i dotghostboard_*.deb
# Run
dotghostboardUninstall:
sudo apt remove dotghostboardInstalled locations:
- Binary:
/opt/dotghostboard/ - Launcher:
/usr/bin/dotghostboard - Desktop entry:
/usr/share/applications/dotghostboard.desktop - Icon:
/usr/share/icons/hicolor/256x256/apps/dotghostboard.png
Usage
| Action | How |
|---|---|
| Copy anything | Just use Ctrl+C anywhere โ DotGhostBoard captures it automatically |
| Mouse Selection (PRIMARY) | Highlight text with mouse โ captured automatically when enabled in Settings |
| Middle-Click to PRIMARY | Middle-click any card to copy directly to Linux PRIMARY buffer for middle-click paste |
| Toggle window | Press Ctrl+Alt+V from anywhere to show or hide the dashboard |
| Spotlight search | Press Ctrl+Alt+Space from anywhere for instant floating quick search |
| Focus search | Press Ctrl+F inside the dashboard to search history |
| Pin an item | Click ๐ on any card |
| Unpin an item | Click ๐ on a pinned card |
| Copy back | Click โ on any card โ or double-click the card |
| Delete an item | Click โ โ pinned items are protected |
| Keyboard navigation | Press โ / โ to move focus; Enter or Space to copy; Esc to clear |
| Clear history | Click "Clear History" โ pinned items are never deleted |
| Settings | Click โ in the top bar โ adjust history limit, global shortcuts, privacy |
| Minimize | Click X โ the app stays alive in the system tray |
| Quit | Right-click the tray icon โ Quit |
๐ก๏ธ The Vault & Encrypted Backups (.vault)
The Vault (Ctrl+Shift+V) is a physically isolated, encrypted credential storage engine (vault.db).
- Envelope Encryption: A random 256-bit Data Encryption Key (DEK) encrypts secrets, titles, categories, expiry dates, and history. Record and history IDs are authenticated to detect ciphertext swapping. Creation/update timestamps, counts, and database structure remain visible. Legacy records migrate after a successful unlock; older app builds cannot read the upgraded format.
- Password Modes: Shared mode (default) wraps the DEK using HKDF-SHA256 over the Dashboard key derived with PBKDF2-HMAC-SHA256 (600,000 rounds). An optional independent Vault password uses Argon2id (64 MiB, 3 passes, 1 lane; random 16-byte salt), with no Dashboard-password fallback. Changing modes verifies the required current passwords and preserves the DEK and secrets. New passwords require at least 12 characters; legacy passwords remain usable for authentication.
- Streamlined Two-Row Drawer: Slide-out drawer with dedicated title/badge status row and independent action toolbar (
+ Add Secret, Lock/Unlock, Export, Import, Tips). - Empty State Onboarding: Informative tips card explaining quick shortcuts (
Ctrl+Shift+V), 30-second clipboard scrubbing, 3-version history, and expiration monitoring. - Encrypted Export (
.vault): Clicking๐ค Exportpackages all secrets, 3-version password histories, categories, expiration dates, and an export timestamp into a standalone binary file.- Cipher:
AES-256-GCM(authenticated encryption with 96-bit random nonce and 128-bit authentication tag). - Key Derivation: Version 2 uses Argon2id (64 MiB, 3 passes, 1 lane) with a per-backup 16-byte random salt. Import still supports version 1 PBKDF2-HMAC-SHA256 backups (100,000 rounds).
- Encrypted File: The application writes an encrypted package. Protection depends on a strong passphrase and a secure device; this does not protect against malware reading an unlocked process, OS swap, or clipboard contents.
- Passphrase Security: Protected by an independent passphrase chosen at export. Passphrases are never stored; backups cannot be decrypted if the passphrase is forgotten.
- Cipher:
- Authenticated Import: Clicking
๐ฅ Importprompts for the backup passphrase, verifies the package's cryptographic integrity tag, and imports secrets into your Vault while automatically skipping exact duplicates.
These password-mode, private-metadata, and backup-v2 changes were introduced in v2.1.3. See the security model and migration notes for exact guarantees, remaining limits, and files required for recovery.
Window Manager & Multi-Workspace Compatibility
DotGhostBoard automatically adheres to the Extended Window Manager Hints (EWMH) specification under X11. When invoked via global shortcut (Ctrl+Alt+V) or Spotlight (Ctrl+Alt+Space) on another virtual desktop or workspace, the window and modal dialogs seamlessly migrate to your active workspace (verified against Qtile and Openbox; should work on any EWMH-compliant tiling WM such as i3 or bspwm, but not yet independently tested on those).
Environment Variables
| Variable | Default | Description |
|---|---|---|
DOTGHOST_HOME | ~/.config/dotghostboard | Override the custom configuration and database directory. |
DOTGHOST_NO_EWMH | 0 | Set to 1 to disable EWMH workspace migration and leave window placement strictly to your window manager's default placement rules. |
Running Tests
QT_QPA_PLATFORM=offscreen DOTGHOST_FORCE_WAYLAND=1 python3 -m pytestLatest verification (headless Qt):
694 passed
Tests Output
Roadmap
| Version | Codename | Status | Goal |
|---|---|---|---|
| v1.0.0 | Ghost | โ Released | Stable base โ clipboard, pin system, dark UI, SQLite |
| v1.1.0 | Phantom | โ Released | Settings panel, keyboard nav, double-click paste, SVG icon |
| v1.2.0 | Specter | โ Released | Image thumbnails, video preview via ffmpeg, auto-cleanup, image viewer |
| v1.3.0 | Wraith | โ Released | Tags, collections, multi-select, bulk actions, export |
| v1.4.0 | Eclipse | โ Released | AES-256 encryption, master lock, stealth mode, pro UI |
| v1.4.1 | Mem & Perf | โ Released | Memory optimizations, GitHub auto-updater, IPC/Wayland bug fixes |
| v1.5.0 | Nexus | โ Released | E2EE Network Sync, mDNS Discovery, REST API, CLI Companion |
| v1.5.1 | Nexus Hotfix I | โ Released | Update pipeline security, self-cleanup install script |
| v1.5.2 | Nexus Hotfix II | โ Released | Aura Check easter egg, Pigeon Doctor purge screen, migration fix |
| v1.5.3 | Nexus Hotfix III | โ Released | Fix blank/white window in deb & AppImage (PyInstaller resource path) |
| v1.5.4 | Nexus Hotfix IV | โ Released | Clipboard capture reliability fix (3-layer bug); Copy Count Badge; Auto-Pin Suggestion |
| v1.5.5 | Nexus Polish & Spotlight | โ Released | Spotlight quick search overlay, relative time, copy count reset, image deduplication, search debounce |
| v1.5.6 | Nexus Global Hotkeys & UI Polish | โ Released | Per-user Global Desktop Shortcuts (GNOME/XFCE), decoupled Spotlight, Eclipse lock protection, UI theme polish, 220 tests |
| v1.5.7 | Nexus Hotfix V | โ Released | CI headless stability, packaging Python dependencies, CLI enhancements, 220 tests |
| v1.6.0 | Phantom | โ Released | v2.x Architecture Foundation: Controllers, Services, Repositories, Pipeline (306 tests) |
| v2.0.0 | Cerberus | โ Released | The Vault UI, Zero-Log Secret Detector, FreeDesktop Notifications, 2.0.0 Icon Architecture (470 tests) |
| v2.0.1 | Cerberus | โ Released | Tiling Window Manager EWMH Migration (Qtile/Openbox), Workspace Toggle Fix, Vault & Notification Hardening (489 tests) |
| v2.1.0 | Leviathan | โ Released | Smart Auto-Tagging, Contextual Card Actions, Vault Generator, Password History, Vault Export/Import, Secret Expiry, Vault Sweep, Auto-Purge (522 tests) |
| v2.1.4 | Leviathan | Current version | Quiet Dashboard lock with continued protected clipboard capture, locked-state Pause/Resume, explicit tray status |
| v2.1.3 | Leviathan | โ Released | Independent Vault password, encrypted recovery versions, unified unlock, searchable selection, responsive recovery operations |
| v2.1.2 | Leviathan | โ Released | Vault clipboard protection, configurable notifications, PRIMARY fixes, runtime-only packaging (589 tests) |
| v2.1.1 | Leviathan | โ Released | Primary Selection (Issue #2), Mouse Ergonomics & Badges, Middle-Click to PRIMARY, UI Audio Feedback & Sound Synthesizer, Vault CSV Importer (546 tests) |
Full details in roadmap(v2.x).md
Acknowledgments
Special thanks to @knodalyte for reporting GitHub Issue #1 ("[BUG] does not behave well under tiling window manager") and GitHub Issue #2 ("[FEATURE] config option to support primary selection"), driving key power-user capabilities across window managers and mouse workflows.
Contributing
Contributions are welcome. Please read CONTRIBUTING.md before submitting a pull request.
License
Apache 2.0 โ see LICENSE for details.
Part of DotSuite
DotGhostBoard is one tool in the DotSuite collection โ a suite of modern, lightweight, and privacy-focused productivity tools built for Linux power users.
๐ Ecosystem Website: https://www.dotsuite.dev/en
DotEnv ยท DotCommand ยท DotSense ยท DotFetch ยท DotShare ยท DotScramble ยท DotGhostBoard
Built with ๐ on Kali Linux
Related Products
โ
โ
โ
โ
โ
โ
โ
โ
โ
โ
โ
โ