Skip to content

Instantly share code, notes, and snippets.

@jasonm23
Created May 30, 2025 18:51
Show Gist options
  • Save jasonm23/4fd10f79521278af55f2979975700740 to your computer and use it in GitHub Desktop.
Save jasonm23/4fd10f79521278af55f2979975700740 to your computer and use it in GitHub Desktop.
Configure CopyQ for tab synchronizarion to directory

Sync a Tab to a Directory with copyq, not setable from the cli tool, but is possible in the config.

(linux/macos: ~/.config/copyq/copyq.conf | windows: %APPDATA%\copyq\copyq.conf )

Define tabs

Config will default to 1 tab called &clipboard. The & marks the letter to activate with Alt

[Tabs]
size=1
1\name=&clipboard
1\icon=
1\max_item_count=0
1\store_items=true
  • size - set to the number of tabs you want.
  • name - tab name with optional & in front of the letter you want to use with Alt
  • icon - name of icon
  • max_item_count - 0 copyq default, or custom max for this tab.
  • store_items=true - store items on or off

To add a new tab in the config, change size and We add a second tab, called pinned:

[Tabs]
size=2
1\name=&clipboard
1\icon=
1\max_item_count=0
1\store_items=true
2\name=pinned 
2\icon=
2\max_item_count=0
2\store_items=true

The order doesn't matter to copyq, but it's easier to read sorted.

Sync to disk

For network sharing, sync to a shared folder, works ok with network drives, dropbox, icloud, etc. Don't recommend it with &clipboard it gets laggy.

With your tab name, add to the config, on Linux/macos

itemsync\sync_tabs=pinned, /mnt/some_shared_volume/path/dir/anything

On Windows you can use drive letters or network location \\server\share\path

On all platforms no need to quote values, just don't put , between tab names and share location.

itemsync\sync_tabs=pinned, P:\Some Directory, Another Tab, \\server\share\path
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment