diff --git a/docs/faq.rst b/docs/faq.rst index 051e635cd91c4e78b50008714a0ce490661ac148..9f78f8032ac45d4bffb4a2a71c5a3dc44ad18377 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -80,7 +80,7 @@ To re-enable the functionality select "File - Enable Clipboard Storing" (same sh To permanently disable storing the clipboard in CopyQ: -1. And pen "Preferences" (``Ctrl+P`` shortcut). +1. Open "Preferences" (``Ctrl+P`` shortcut). 2. Go to "History" tab. 3. Clear "Tab for storing clipboard" field. @@ -97,6 +97,8 @@ then choose what to import back. Importing tabs and commands won't override existing tabs, and will create new ones. +.. _faq-disable-notifications: + How to enable or disable displaying notification when clipboard changes? ------------------------------------------------------------------------ @@ -139,6 +141,8 @@ opens main window on Ctrl+Shift+1). To use the command in CopyQ: To share your commands, you can select the commands from command list in "Command" dialog and press "Copy Selected" button (or just hit Ctrl+C). +.. _faq-ignore-password-manager: + How to omit storing text copied from specific windows like a password manager? ------------------------------------------------------------------------------ @@ -345,6 +349,8 @@ Here is the correct command to use for some editors:: code --wait %1 open -t -W -n %1 +.. _faq-config-path: + Where to find saved items and configuration? -------------------------------------------- diff --git a/docs/index.rst b/docs/index.rst index ee9e608b1553e8d1d7ab615aa831e1b8254260ba..eeb429194f0df0ef4e7c34bbf4482c351d19d246 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -18,6 +18,7 @@ advanced topics like scripting and application development process. keyboard images tags + security theme faq known-issues diff --git a/docs/password-protection.rst b/docs/password-protection.rst index c333db2cece981163e6edbfcd5b9b56022dd10ee..76e26c942ecf95649f61bc644ecc945faee6d347 100644 --- a/docs/password-protection.rst +++ b/docs/password-protection.rst @@ -1,3 +1,5 @@ +.. _encrypt: + Password Protection =================== diff --git a/docs/security.rst b/docs/security.rst new file mode 100644 index 0000000000000000000000000000000000000000..1b10c5d01351d89d7193c501d15d9664f7cfa737 --- /dev/null +++ b/docs/security.rst @@ -0,0 +1,54 @@ +Security +======== + +This page describes how CopyQ handles the clipboard data and how to make the +clipboard safer. + +Data Storage +============ + +By default, Any text or image in the clipboard is stored automatically in CopyQ. + +You can completely disable automatic clipboard storing or avoid storing content +copied from windows with matching window titles. + +.. seealso:: + + - :ref:`faq-disable-clipboard-storing` + - :ref:`faq-ignore-password-manager` + +The data from all tabs are stored in the configuration directory unencrypted +(unless the Encryption plugin is enabled for a tab). + +.. seealso:: + + - :ref:`faq-config-path` + - :ref:`encrypt` + +CopyQ does not collect any other data and does not send anything over network. + +Clipboard Content Visibility +============================ + +The clipboard content is normally shown in the item list of a clipboard tab, +main window title, tray tool tip and notification. + +To disable showing the current clipboard in GUI, use `"No Clipboard +in Title and Tool Tip" command +<https://github.com/hluk/copyq-commands/tree/master/Scripts#no-clipboard-in-title-and-tool-tip>`__ +and disable notifications (in Preferences). + +.. seealso:: + + - :ref:`faq-disable-notifications` + - :ref:`faq-share-commands` + +Clipboard Access +================ + +Usually other applications can access clipboard content without any +restriction. + +To restrict accessing the data after a long time, use `"Clear Clipboard After +Interval" command +<https://github.com/hluk/copyq-commands/tree/master/Scripts#clear-clipboard-after-interval>`__.