How to Use CopyQ Portable: Setup, Tips, and Shortcuts
What CopyQ Portable is
CopyQ Portable is the portable version of CopyQ, a clipboard manager that stores text, images and other clipboard items, lets you organize them with tabs and labels, and supports searching, editing, scripting and custom shortcuts — all without installing the app system-wide (runs from a folder or USB drive).
Quick setup (Windows example)
- Download the portable ZIP from the official CopyQ releases page and extract to a folder or USB drive.
- Run copyq.exe from that folder. On first run it creates a config and database inside the portable folder.
- Pin or create a shortcut to copyq.exe if you want quick access. Do not move the folder while CopyQ is running.
Basic workflow
- Copy items as usual (Ctrl+C). CopyQ automatically logs clipboard entries.
- Open the main window with the default hotkey (usually Ctrl+
or configurable) to view history.</li><li>Click an item to paste it into the current application, or use keyboard navigation (arrow keys + Enter).</li><li>Use tabs to separate contexts (e.g., “Work”, “Personal”) and labels to tag frequently used clips.</li></ul><h3>Useful settings to change</h3><ul><li>History size / item lifetime: Limit stored items to save space on portable drives.</li><li>Store images: Enable only if you need images; otherwise keep off to reduce DB size.</li><li>Start minimized: Have CopyQ run in the tray when launched.</li><li>Use portable config path: Ensure paths in settings are relative so everything stays in the portable folder.</li></ul><h3>Handy tips</h3><ul><li>Keep the portable folder on a fast drive (SSD/USB 3) to avoid slow database operations.</li><li>Backup the CopyQ folder periodically (copies the DB and config).</li><li>Use the search box to quickly find snippets by keyword.</li><li>Create predefined items (snippets) for boilerplate text and pin them to a tab.</li><li>When using on multiple machines, close CopyQ before moving the drive to avoid DB corruption.</li></ul><h3>Shortcuts and keyboard commands (defaults may differ — verify in Preferences)</h3><ul><li>Open main window: Ctrl+(or custom) - Paste selected item: Enter
- Delete item: Del
- Edit item: F2
- Create new snippet: Ctrl+N
- Toggle show/hide: assigned global shortcut (set in Preferences)
Automation & scripting
- Use CopyQ’s scripting (QtScript/JavaScript) to create custom paste behaviors, modify items, or integrate with other tools. Example uses: auto-format copied phone numbers, replace placeholders in templates, or run commands on clipped files.
Troubleshooting
- If the database seems corrupted, close CopyQ, remove/rename the data file in the portable folder, and restart (this resets history).
- If global shortcuts conflict, change them in Preferences or temporarily disable other apps’ shortcuts.
- Ensure write permissions on the portable folder; run with appropriate privileges if needed.
If you want, I can:
- provide a ready-to-import CopyQ script for a common task (e.g., format phone numbers), or
- give step-by-step instructions for configuring a specific shortcut or snippet.
Leave a Reply