Skip to main content
Вернуться к продуктам
python

DotGhostBoard

Продвинутый криптографический менеджер буфера обмена для Linux с защитой конфиденциальности

5 звезд1 Форк0 проблемВерсия v2.1.4
DotGhostBoard • README•23 min read

👻 DotGhostBoard

Advanced clipboard manager for Kali Linux — part of the DotSuite toolkit.

Ecosystem - DotSuite

Version Codename Python PyQt6 Platform Tests License


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 DemoDotGhostBoard UI Demo DotGhostBoard Capture DemoDotGhostBoard 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+V toggles the dashboard from anywhere; Ctrl+Alt+Space opens 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+F instantly 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, Enter to copy, Esc to clear focus
  • Double-click to paste — Double-click any card to copy it instantly
  • Standalone autostart — scripts/setup_autostart.py sets 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_captures limit (default 100); oldest unpinned captures deleted from disk on startup
  • Image viewer popup — Full-size image preview with smooth scaling; Ctrl+C to copy image; Escape to 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_order in database
  • Tag system — Assign custom #tags to any item; colored chip display with rotating 6-palette colors; inline autocomplete from existing tags
Tag System DemoTag 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 DemoDrag and Drop Collections Demo
  • Multi-select — Ctrl+Click to toggle, Shift+Click for range selection; neon green ✓ overlay on selected cards
Multi-Select DemoMulti-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 DemoLocal 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 DemoSession 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 DemoSettings 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 push and dotghost pop from 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 ×5 copies a non-blocking toast appears suggesting you pin the item. At ×10 the 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 Link in browser, { } Format JSON with indentation, ✉ Compose email, 📡 Copy IP, or 🛡 → Vault to 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 PRIMARY selection, 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 CLIPBOARD buffer (Ctrl+V) without echo loops, so selecting text with mouse immediately enables pasting via Ctrl+V across any application.

  • Card Middle-Click to PRIMARY — Middle-clicking any item card (Qt.MouseButton.MiddleButton) instantly copies its contents into the Linux PRIMARY selection 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 manual Ctrl+C keyboard 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.

Kali Dock IntegrationKali Dock Integration

Project Structure

CODE
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
└── .gitignore

Requirements

DependencyVersion
Python3.11+
PyQt66.6.0+
Pillow10.0.0+
cryptography44.0.0+ (Argon2id support)
pytest7.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.


Installation

Option A — System Python (Kali Linux)

PyQt6 and Pillow are usually pre-installed on Kali:

BASH
git clone https://github.com/kareem2099/DotGhostBoard.git
cd DotGhostBoard
python3 main.py

Option B — Virtual Environment (Recommended)

BASH
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.py

Option C — pip install (PyPI)

Note: PyPI package publication is planned; use DEB, AppImage, or Git clone for the published release.

BASH
# Planned for PyPI release
pip install dotghostboard
dotghostboard

Option D — AppImage (Portable)

Download the v2.1.4 AppImage, then:

BASH
chmod +x DotGhostBoard-2.1.4-x86_64.AppImage
./DotGhostBoard-2.1.4-x86_64.AppImage

No installation required. Runs on compatible 64-bit Linux distributions.

Option E — Full install (autostart + shortcut + icon)

BASH
chmod +x scripts/install.sh
./scripts/install.sh

This configures autostart, the desktop launcher, CLI companion, and global shortcuts on supported GNOME/XFCE desktops:

  • Ctrl+Alt+V — Toggle Dashboard
  • Ctrl+Alt+Space — Spotlight Quick Search

Option F — Build AppImage from source

BASH
pip install pyinstaller
chmod +x scripts/build_appimage.sh
./scripts/build_appimage.sh

Option G — DEB Package (Debian/Ubuntu/Kali)

Quick install from Releases:

BASH
# 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
dotghostboard

Or build locally:

BASH
# 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
dotghostboard

Uninstall:

BASH
sudo apt remove dotghostboard

Installed 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

ActionHow
Copy anythingJust use Ctrl+C anywhere — DotGhostBoard captures it automatically
Mouse Selection (PRIMARY)Highlight text with mouse — captured automatically when enabled in Settings
Middle-Click to PRIMARYMiddle-click any card to copy directly to Linux PRIMARY buffer for middle-click paste
Toggle windowPress Ctrl+Alt+V from anywhere to show or hide the dashboard
Spotlight searchPress Ctrl+Alt+Space from anywhere for instant floating quick search
Focus searchPress Ctrl+F inside the dashboard to search history
Pin an itemClick 📌 on any card
Unpin an itemClick 📍 on a pinned card
Copy backClick ⎘ on any card — or double-click the card
Delete an itemClick ✕ — pinned items are protected
Keyboard navigationPress ↑ / ↓ to move focus; Enter or Space to copy; Esc to clear
Clear historyClick "Clear History" — pinned items are never deleted
SettingsClick ⚙ in the top bar — adjust history limit, global shortcuts, privacy
MinimizeClick X — the app stays alive in the system tray
QuitRight-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 📤 Export packages 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.
  • Authenticated Import: Clicking 📥 Import prompts 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

VariableDefaultDescription
DOTGHOST_HOME~/.config/dotghostboardOverride the custom configuration and database directory.
DOTGHOST_NO_EWMH0Set to 1 to disable EWMH workspace migration and leave window placement strictly to your window manager's default placement rules.

Running Tests

BASH
QT_QPA_PLATFORM=offscreen DOTGHOST_FORCE_WAYLAND=1 python3 -m pytest

Latest verification (headless Qt):

TEXT
694 passed
Tests OutputTests Output

Roadmap

VersionCodenameStatusGoal
v1.0.0Ghost✅ ReleasedStable base — clipboard, pin system, dark UI, SQLite
v1.1.0Phantom✅ ReleasedSettings panel, keyboard nav, double-click paste, SVG icon
v1.2.0Specter✅ ReleasedImage thumbnails, video preview via ffmpeg, auto-cleanup, image viewer
v1.3.0Wraith✅ ReleasedTags, collections, multi-select, bulk actions, export
v1.4.0Eclipse✅ ReleasedAES-256 encryption, master lock, stealth mode, pro UI
v1.4.1Mem & Perf✅ ReleasedMemory optimizations, GitHub auto-updater, IPC/Wayland bug fixes
v1.5.0Nexus✅ ReleasedE2EE Network Sync, mDNS Discovery, REST API, CLI Companion
v1.5.1Nexus Hotfix I✅ ReleasedUpdate pipeline security, self-cleanup install script
v1.5.2Nexus Hotfix II✅ ReleasedAura Check easter egg, Pigeon Doctor purge screen, migration fix
v1.5.3Nexus Hotfix III✅ ReleasedFix blank/white window in deb & AppImage (PyInstaller resource path)
v1.5.4Nexus Hotfix IV✅ ReleasedClipboard capture reliability fix (3-layer bug); Copy Count Badge; Auto-Pin Suggestion
v1.5.5Nexus Polish & Spotlight✅ ReleasedSpotlight quick search overlay, relative time, copy count reset, image deduplication, search debounce
v1.5.6Nexus Global Hotkeys & UI Polish✅ ReleasedPer-user Global Desktop Shortcuts (GNOME/XFCE), decoupled Spotlight, Eclipse lock protection, UI theme polish, 220 tests
v1.5.7Nexus Hotfix V✅ ReleasedCI headless stability, packaging Python dependencies, CLI enhancements, 220 tests
v1.6.0Phantom✅ Releasedv2.x Architecture Foundation: Controllers, Services, Repositories, Pipeline (306 tests)
v2.0.0Cerberus✅ ReleasedThe Vault UI, Zero-Log Secret Detector, FreeDesktop Notifications, 2.0.0 Icon Architecture (470 tests)
v2.0.1Cerberus✅ ReleasedTiling Window Manager EWMH Migration (Qtile/Openbox), Workspace Toggle Fix, Vault & Notification Hardening (489 tests)
v2.1.0Leviathan✅ ReleasedSmart Auto-Tagging, Contextual Card Actions, Vault Generator, Password History, Vault Export/Import, Secret Expiry, Vault Sweep, Auto-Purge (522 tests)
v2.1.4LeviathanCurrent versionQuiet Dashboard lock with continued protected clipboard capture, locked-state Pause/Resume, explicit tray status
v2.1.3Leviathan✅ ReleasedIndependent Vault password, encrypted recovery versions, unified unlock, searchable selection, responsive recovery operations
v2.1.2Leviathan✅ ReleasedVault clipboard protection, configurable notifications, PRIMARY fixes, runtime-only packaging (589 tests)
v2.1.1Leviathan✅ ReleasedPrimary 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

Похожие продукты

‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌