ClipBob

Quick Start Guide

ClipBob is a powerful clipboard management app that automatically saves your clipboard history and provides quick access through global hotkeys.

Installation & Setup

Download: Get ClipBob from the official release page
Install: Run the installer and follow the setup wizard
Permissions: Grant necessary permissions for clipboard access and global hotkeys
Launch: ClipBob will start automatically and run in the background

                    Default Hotkey: Press Cmd+Shift+V to open ClipBob instantly from anywhere on your system.
                

System Requirements

macOS

macOS 10.15 or later
64-bit processor
50 MB available storage

Windows

Windows 10 or later
64-bit processor
50 MB available storage

Linux

Ubuntu 18.04+ / equivalent
64-bit processor
50 MB available storage

Features Overview

Automatic History: Saves clipboard content automatically with configurable limits
Content Type Detection: Recognizes text, URLs, emails, phone numbers, images, files, and folders
Global Hotkeys: Customizable system-wide shortcuts for instant access
Privacy Mode: Filters sensitive content like passwords and credit card numbers
Search & Filter: Quickly find clipboard items with real-time search
Favorites: Pin important items for permanent storage
Auto-Cleanup: Automatically removes old items based on your settings
Local Storage: All data stored locally on your device for maximum privacy

Configuration

Hotkey Settings

Customize your global hotkeys in Settings > Hotkey Configuration:

Choose from preset combinations or create custom hotkeys
Test hotkeys before applying changes
System conflict detection prevents conflicts with existing shortcuts

Privacy Settings

Privacy Mode: Enable to filter sensitive content automatically
History Limits: Set maximum number of items (50-500)
Auto-Cleanup: Configure automatic deletion of old items (1-90 days)

Storage Management

ClipBob stores data in the following locations:

macOS: ~/Library/Application Support/ClipBob/
Windows: %APPDATA%/ClipBob/
Linux: ~/.local/share/ClipBob/

Troubleshooting

Common Issues

Hotkeys Not Working

Check if ClipBob has accessibility permissions
Verify hotkey configuration in Settings
Test for conflicts with other applications
Try resetting to default hotkey combination

Clipboard History Not Saving

Ensure Auto-Save is enabled in Settings
Check if Privacy Mode is filtering content
Verify sufficient disk space is available
Restart the application

Performance Issues

Reduce history limit in Settings
Enable automatic cleanup for better performance
Clear old items manually if needed
Check system resources and close unnecessary apps

Note: If issues persist, try restarting ClipBob or your system. Most configuration changes take effect immediately.

Advanced Usage

Command Line Options

ClipBob supports several command line arguments for advanced users:

./ClipBob --help              # Show all available options
./ClipBob --reset-config      # Reset all settings to defaults
./ClipBob --debug            # Enable debug logging
./ClipBob --no-autostart     # Disable automatic startup

Keyboard Shortcuts

Cmd/Ctrl + F: Focus search bar
Cmd/Ctrl + D: Delete selected item
Cmd/Ctrl + S: Toggle favorite status
Enter: Copy selected item to clipboard
Escape: Close ClipBob window

Data Export/Import

While ClipBob doesn't currently support data export, all clipboard items are stored in a standard SQLite database that can be accessed by database tools if needed for migration purposes.

Technical Specifications

Architecture

Framework: Flutter with native platform integration
Database: SQLite for local data storage
Clipboard API: Platform-specific clipboard integration
Hotkey System: Native system hotkey registration

Security Features

Local-only data storage (no cloud sync)
System-level encryption for stored data
Privacy mode with content filtering
Automatic cleanup of sensitive data

Performance

Memory Usage: Typically 20-50 MB
CPU Usage: Less than 1% during normal operation
Storage: Variable based on clipboard content and history size
Startup Time: Under 2 seconds on modern systems

FAQ

Is my clipboard data secure?

Yes, all data is stored locally on your device and never transmitted to external servers. ClipBob uses system-level encryption and offers privacy mode for sensitive content.

Can I sync my clipboard across devices?

Currently, ClipBob focuses on local storage for maximum privacy and security. Cloud sync features may be considered for future releases.

How much storage does ClipBob use?

Storage usage depends on your history limit and the type of content saved. Text items use minimal space, while images and files require more storage.

Can I customize the appearance?

ClipBob follows your system's appearance settings (light/dark mode). Additional customization options may be added in future updates.

What happens when I uninstall ClipBob?

All clipboard history and settings are completely removed when you uninstall the application. Make sure to export any important data before uninstalling.