Skip to content GitHub
Guide contents
English View source

Settings

Settings

CyberPaste is configured through a multi-tab Settings window with eight tabs: General, Folders, Full Mode, Compact Mode, AI Processing, Notifications, Maintenance, and Achievements & Progress.


General

Language & Appearance

Setting Description
Language Auto (system), Deutsch, English, Español, Français, 日本語, 中文
Theme 3 themes: Light, Dark, and CyberPaste. System is a fourth option that follows Windows. The frosted window is part of the CyberPaste theme, not a separate material setting
Round corners Window corner rounding
Title bar animation Animated title bar effects

Startup & Integration

Setting Description
Start with Windows Auto-launch at sign-in
Hide when focus is lost Hide the window after a click outside it. Pinning the window keeps it open
Image editor path External image editor for "Open external viewer"

Clipboard & Capture

Setting Description
History limit Maximum clips to retain — slider 50 – 1000, step 50 (default 300)
Auto-delete history Automatically cleans unpinned history older than the configured period (1 day up to 1 year; disabled by default)
Auto-paste Paste the clip after selecting it
Auto-inject paste Simulates Ctrl+V after pasting (requires auto-paste)
Reset view on paste Return to the default view after pasting
Type to search Start searching by typing
Show action messages Confirmation toasts for actions
Auto-check updates Check for new versions on startup

Hotkeys

Setting Description
Toggle window Main hotkey (default: Ctrl+Shift+V)
View mode toggle Switch Full/Compact (default: Ctrl+M)

Title-bar actions use consistent Ctrl shortcuts:

Shortcut Action
Ctrl+E Toggle hover peek
Ctrl+R Reset window size
Ctrl+. Open the More menu
Ctrl+F11 Maximize / restore
Ctrl+L Toggle Compact layout
Ctrl+H Open search history

Privacy

Setting Description
Ignored applications Apps whose clipboard content is never captured

Sounds

Setting Description
Clipboard sound Play a sound when a clip is captured (toggle + custom WAV/MP3 path)
Startup sound Play a sound at launch (toggle + custom path)

ℹ️ Clips older than 30 days are also auto-deleted (fixed backend default; not exposed in the UI).


Folders

Manage folders in one place: create, rename, delete, reorder (drag), and choose icon/color.


Full Mode

Setting Description
Grid scale Zoom level (percentage, 60% – 175%)
Grid columns Column count (auto or fixed)
Scroll direction Vertical or horizontal
Show scrollbar / source icon / time / type icon / number Card detail toggles
Show HUD Shortcut hints + hotkey badge in the title bar
Show hover peek Expanded preview on card hover
Type filter Default filter chip

Compact Mode

Setting Description
Row height Height of clip rows
Auto-height Adjust row to content
Peek enabled Hover preview
Show scrollbar / source icon / time / type icon / number Row detail toggles
Sidebar collapsed Collapse the folder sidebar by default
Folder layout Sidebar (vertical) or horizontal bar
View position Where the compact window appears (auto / cursor / caret)
Clip numbering Positional or countdown

AI Processing

Setting Description
Provider OpenAI, DeepSeek, Kimi, Gemini, Grok, Meta (Muse Spark), Custom
API key Provider API key
Model Model name (dropdown with the provider's models, or custom)
Base URL Auto-filled per provider; editable for custom endpoints
Prompt / Title: Summarize, Translate, Explain Code, Fix Grammar Custom prompt and display name per action, with reset and descriptions

See AI Actions for details.


Notifications

Setting Description
Toasts enabled Master toggle
Show action messages Confirmation toasts for actions
Duplicate toasts Duplicate detection notices
Position 5 placements (default bottom-center)
Monitor Primary monitor or a specific display
Duration Short (1.5s), Normal (3s), Long (5s), Very long (8s)
Click action None, Close, Open, System viewer, Toggle pin
Test notification Send a sample toast

Maintenance

System & Storage

  • Database size readout
  • Open data directory button

Data Management

Action Description
Clear History Deletes all clips (with confirmation)
Load sample clips Temporarily shows demo clips (real clips are not deleted)

Backup & Restore

Action Description
Export backup Saves a JSON file with clips, folders, images, settings, and local progress
Import backup Restores from a backup file (asks for confirmation, then reloads)

ℹ️ There is no separate "export settings" or "reset to defaults" button, the backup includes your settings, and importing a backup replaces the current state.


Achievements & Progress

Progress is optional, local-only, and enabled by default. The tab displays lifetime totals, active days, the original profile date, and long-term achievements.

Setting Description
Usage progress Enable or disable new local counters without deleting existing progress
Achievement notifications Show or hide unlock notifications independently
Reset progress Delete counters and unlocked achievements without deleting clips

The original profile date is preserved when progress is reset. See Achievements & Progress for the complete list of milestones and backup behavior.

← All documentation