Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
panel-plugins:clipman:start [2013/03/22 08:58] – created mike | panel-plugins:clipman:start [2023/07/31 21:03] (current) – Update from https://docs.xfce.org/panel-plugins/xfce4-clipman-plugin/start gael | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Clipman ====== | + | ~~NOTOC~~ |
+ | {{ : | ||
+ | ====== Clipman | ||
- | This manual describes //**Clipman**// version 1.2.0. | + | |
- | + | * **[[#Search The History|Search The History]]** | |
- | Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. The complete license text is available from the [[http:// | + | * **[[# |
+ | * **[[#Action Settings|Action Settings]]** | ||
+ | * **[[# | ||
+ | * **[[# | ||
+ | * **[[#Latest Release|Latest Release]]** | ||
+ | * **[[#Source Code Repository|Source Code Repository]]** | ||
+ | * **[[# | ||
+ | ---- | ||
===== Introduction ===== | ===== Introduction ===== | ||
Line 13: | Line 22: | ||
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). | ||
- | // | + | // |
- | ==== Getting Started ==== | + | ---- |
+ | ===== Getting Started | ||
// | // | ||
<figure " | <figure " | ||
- | {{: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 | ||
Line 29: | Line 39: | ||
// | // | ||
+ | ---- | ||
+ | |||
+ | ===== Search The History ===== | ||
+ | |||
+ | If you want to search the history of your clipboard, you can click on "Show full history…" | ||
+ | * shows the complete history | ||
+ | * supports (fuzzy) type-ahead search | ||
+ | * supports paste-on-activate (i.e. pastes the selected text directly into the previously active window on hitting " | ||
+ | * 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 xfce4-clipman-history or by clicking on the menu entry | ||
+ | </ | ||
+ | |||
+ | |||
+ | ---- | ||
===== 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 " | + | <figure " |
- | {{:extra: | + | {{:panel-plugins: |
- | Settings dialog with the General | + | Settings dialog with the Behavior |
</ | </ | ||
+ | |||
+ | [[|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 59: | Line 90: | ||
<figure " | <figure " | ||
- | {{:extra: | + | {{:panel-plugins: |
Settings dialog with the Actions tab | Settings dialog with the Actions tab | ||
Line 68: | Line 99: | ||
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 " | ||
- | {{:extra: | + | {{:panel-plugins: |
Settings dialog showing the Action Dialog when creating or editing an action | Settings dialog showing the Action Dialog when creating or editing an action | ||
Line 104: | Line 135: | ||
For example, from the simple pattern "'' | For example, from the simple pattern "'' | ||
+ | |||
+ | [[|Back to Top]] | ||
+ | ---- | ||
+ | |||
+ | ==== History Settings ==== | ||
+ | |||
+ | <figure " | ||
+ | {{: | ||
+ | |||
+ | Settings dialog showing the History tab | ||
+ | </ | ||
+ | |||
+ | ^ 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 126: | Line 178: | ||
xfconf-query -c xfce4-panel -p / | xfconf-query -c xfce4-panel -p / | ||
- | ===== Support ===== | + | To list all settings type this command (the table above may be out of date): |
- | To report a bug or a feature request use the bug tracking system at [[http://bugzilla.xfce.org/ | + | xfconf-query -c xfce4-panel -lv | grep /plugins/clipman |
+ | |||
+ | [[|Back to Top]] | ||
+ | ---- | ||
===== About Clipman ===== | ===== About Clipman ===== | ||
- | // | + | // |
- | + | ||
- | This documentation was written by Mike Massonnet (mmassonnet@xfce.com). Please send all your comments and suggestions regarding this manual. | + | |
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. | 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. | ||
Line 140: | Line 193: | ||
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. | 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. | ||
+ | ---- | ||
+ | |||
+ | ===== Latest Release ===== | ||
+ | |||
+ | {{rss> | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | * **[[https:// | ||
+ | |||
+ | [[|Back to Top]] | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Source code repository ===== | ||
+ | [[https:// | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Reporting Bugs ===== | ||
+ | * **[[: | ||
+ | |||
+ | |||
+ | [[|Back To Top]] | ||
+ | ---- | ||
+ | [[ : |