Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
panel-plugins:xfce4-clipman-plugin:start [2020/08/16 16:31] – created kevinbowen | panel-plugins:xfce4-clipman-plugin:start [2024/12/09 07:15] (current) – [Search The History] kevinbowen | ||
---|---|---|---|
Line 7: | Line 7: | ||
* **[[# | * **[[# | ||
* **[[#Action Settings|Action Settings]]** | * **[[#Action Settings|Action Settings]]** | ||
- | * **[[#Tweaks Dialog|Tweaks Dialog]]** | + | * **[[#History Settings|History Settings]]** |
- | * **[[#About Clipman|About Clipman]]** | + | * **[[#Latest Release|Latest Release]]** |
* **[[#Source Code Repository|Source Code Repository]]** | * **[[#Source Code Repository|Source Code Repository]]** | ||
* **[[# | * **[[# | ||
Line 21: | Line 21: | ||
In X11 (all Unix platforms) there are by default two clipboards to exchange any data between the windows. A default clipboard which is modified by manual copies (for instance when you select a file and press the copy button), and there is a primary clipboard which is modified by selections (for instance when you select text in a field). | In X11 (all Unix platforms) there are by default two clipboards to exchange any data between the windows. A default clipboard which is modified by manual copies (for instance when you select a file and press the copy button), and there is a primary clipboard which is modified by selections (for instance when you select text in a field). | ||
- | // | + | // |
---- | ---- | ||
Line 28: | Line 28: | ||
// | // | ||
- | <figure "Clipman menu"> | + | <figure "Clipboard Manager: Dropdown Menu"> |
- | {{:extra: | + | {{:panel-plugins: |
- | + | ||
- | Shows the menu that popups when clicking the Clipman icon in the Xfce Panel or the notification area | + | |
</ | </ | ||
+ | Shows the menu that popups when clicking the Clipman icon in the Xfce Panel or the notification area | ||
There are two ways to run // | There are two ways to run // | ||
// | // | ||
+ | |||
+ | ---- | ||
===== Search The History ===== | ===== Search The History ===== | ||
- | If you want to search the history of your clipboard you can use the command-line tool '' | + | If you want to search the history of your clipboard, you can click on "Show full history…" |
* shows the complete history | * shows the complete history | ||
* supports (fuzzy) type-ahead search | * supports (fuzzy) type-ahead search | ||
Line 46: | Line 47: | ||
* allows the user to switch from paste-on-activate to regular copying by holding down the Ctrl key | * allows the user to switch from paste-on-activate to regular copying by holding down the Ctrl key | ||
+ | <figure " | ||
+ | {{: | ||
+ | </ | ||
+ | |||
+ | Clipman history dialog, shown by running '' | ||
---- | ---- | ||
===== Settings ===== | ===== Settings ===== | ||
- | The settings dialog is available under the // | + | The settings dialog is available under the " |
- | ==== General | + | ==== Behavior |
- | The following table describes the available options in the //General// tab of the //Settings dialog//. | + | The following table describes the available options in the //Behavior// tab of the //Settings dialog//. |
^ Option ^ Description ^ | ^ Option ^ Description ^ | ||
- | | Sync selections | Sync the primary clipboard with the default clipboard in a way that it is possible to paste what gets selected | | + | | Sync mouse selections | Sync the primary clipboard with the default clipboard in a way that it is possible to paste what gets selected | |
- | | Save on quit | Keeps the history at every new session | + | | Persist mouse selections |
- | | Store last copied image | Allows to store one image in the history | + | | QR-Code support |
- | | Ignore selections | + | | Paste instantly |
- | | Reverse order | Reverse order of the history shown in the menu | | + | | Position menu at pointer |
- | | Size of the history | + | | Maximum items | Number |
- | + | ||
- | <figure " | + | |
- | {{: | + | |
- | Settings | + | <figure " |
+ | {{: | ||
</ | </ | ||
[[|Back to Top]] | [[|Back to Top]] | ||
---- | ---- | ||
- | ===== Action Settings | + | ==== Action Settings ==== |
- | An action is a pair of a name and a regular expression. Each action can have one or more commands. The support of actions is optional and can be enabled or disabled through the {gui> | + | An action is a pair of a name and a regular expression. Each action can have one or more commands. The support of actions is optional and can be enabled or disabled through the {gui> |
To add an action click the {gui> | To add an action click the {gui> | ||
Line 80: | Line 84: | ||
To learn more about actions go to [[# | To learn more about actions go to [[# | ||
- | <figure "Clipman | + | <figure "Clipboard Manager: |
- | {{: | + | {{: |
- | + | ||
- | Settings | + | |
</ | </ | ||
- | ==== Action Dialog | + | === Action Dialog === |
An action has a human readable name that describes the pattern it is going to match. An action must have at least one command which also has a human readable name. The matched text can be reused in the command. | An action has a human readable name that describes the pattern it is going to match. An action must have at least one command which also has a human readable name. The matched text can be reused in the command. | ||
- | The actions are always matched against text selections unless specified otherwise. When the box {gui> | + | The actions are always matched against text selections unless specified otherwise. When the box {gui> |
- | <figure " | + | <figure "Clipboard Manager: Edit Action Dialog |
- | {{: | + | {{: |
+ | </ | ||
Settings dialog showing the Action Dialog when creating or editing an action | Settings dialog showing the Action Dialog when creating or editing an action | ||
- | </ | + | |
== Regular Expression == | == Regular Expression == | ||
Line 129: | Line 132: | ||
[[|Back to Top]] | [[|Back to Top]] | ||
---- | ---- | ||
- | ===== Tweaks Dialog ===== | ||
- | <figure " | + | ==== History Settings ==== |
- | {{: | + | |
- | Settings | + | <figure " |
+ | {{: | ||
</ | </ | ||
+ | |||
+ | ^ Option ^ Description ^ | ||
+ | | Remember history | Enable history | | ||
+ | | Remember last copied image | Allows to store one image in the history | | ||
+ | | Reorder history items | Push last copied text to the top of the history | | ||
+ | | Reverse history order | Reverse order of the history shown in the menu | | ||
+ | | Ignore mouse selections | Prevents the primary clipboard from being inserted in the history | | ||
+ | | Size of the history | Sets the number of items to keep in history (different from the number of menu items) | | ||
+ | |||
+ | ---- | ||
==== Xfconf ==== | ==== Xfconf ==== | ||
Line 157: | Line 169: | ||
xfconf-query -c xfce4-panel -p / | xfconf-query -c xfce4-panel -p / | ||
+ | |||
+ | To list all settings type this command (the table above may be out of date): | ||
+ | |||
+ | xfconf-query -c xfce4-panel -lv | grep / | ||
[[|Back to Top]] | [[|Back to Top]] | ||
---- | ---- | ||
- | ===== About Clipman | + | ===== Latest Release |
- | // | + | {{rss> |
- | This documentation was written by Mike Massonnet (mmassonnet@xfce.com). Please send all your comments and suggestions regarding this manual. | + | [[https:// |
- | This software is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. | + | * **[[https:// |
- | You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA. | + | [[|Back |
---- | ---- | ||
Line 179: | Line 195: | ||
===== Reporting Bugs ===== | ===== Reporting Bugs ===== | ||
- | If you are experiencing a bug in '' | + | * **[[: |
- | + | ||
- | + | ||
- | <note important> | + | |
- | + | ||
- | + | ||
- | ===== Report a new bug ===== | + | |
- | + | ||
- | If your bug has not been reported before, please [[https:// | + | |
- | + | ||
- | When writing your bug report, try to be as descriptive as possible, but avoid verbosity; Mozilla has a nice guide on [[https:// | + | |
- | + | ||
- | For more information, | + | |
- | + | ||
- | **[[https:// | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | + | ||
- | ==== Open Bugs ==== | + | |
- | Here's a list (updated daily) | + | |
- | {{rss> | ||
[[|Back To Top]] | [[|Back To Top]] | ||
---- | ---- | ||
- | [[ : | + | [[ : |