80 lines
3.6 KiB
Plaintext
80 lines
3.6 KiB
Plaintext
== Recoll hotkey: starting / hiding recoll with a keyboard shortcut
|
|
|
|
Type a key (ie: F12) and have recoll appear or disappear. On the first
|
|
occurrence, recoll is started if it's not already running. Further
|
|
occurrences toggle recoll between visible and minimized states. Never
|
|
thought this would be useful until someone asked for it. Can't do without
|
|
it anymore :)
|
|
|
|
This works well with both Gnome and KDE, but is implemented using a gnome
|
|
library (*libwnck*) and its python interface, which you may have to install
|
|
on your system if you are a pure KDE user. The library most probably exists
|
|
in the package repositories for your distribution, so this should not be
|
|
too complicated.
|
|
|
|
This should also work with other window managers, because it is based on a
|
|
standard window manager interface extension (EWMH) that most modern window
|
|
managers implement.
|
|
|
|
=== Installing the script (all desktops):
|
|
|
|
- You will need the libwnck library and its python interface. These are
|
|
usually part of a gnome installation, otherwise check and possibly
|
|
install them. For OpenSuse, the library should already be there but you
|
|
need to install gnome-python-desktop.
|
|
- Download the
|
|
link:https://www.recoll.org/files/hotrecoll.py[http://www.recoll.org/files/hotrecoll.py
|
|
script]. If you have a recent recoll installation (1.14.3 and
|
|
further), it's already in the recoll filters directory
|
|
('/usr/[local/]share/recoll/filters')
|
|
- Copy the script to some permanent place (ie: '~/bin') and make it
|
|
executable (you can leave it in the filters dirs if it's there). In a
|
|
shell window: `chmod +x hotrecoll.py`.
|
|
- You can check that the script works (or not) by executing it on the
|
|
command line. It does not need an argument. Recoll should appear or
|
|
disappear every time you execute the script. A few warning messages may
|
|
be considered normal. If the script says that it does not find the wnck
|
|
library or some other module, you'll have to install them.
|
|
|
|
=== Installing the keyboard shortcut (Gnome):
|
|
|
|
- _System->Preferences->Keyboard shortcuts_, or execute
|
|
*gnome-keybinding-properties*
|
|
- Click add, Name, ie: StartRecoll, Action: /path/to/hotrecoll.py
|
|
- This will add the shortcut to the "Custom shortcuts" section. You can
|
|
then click in the "Shortcut" column for "StartRecoll", and type any key
|
|
combination (ie: push F12) to assign a key shortcut.
|
|
|
|
=== Installing the keyboard shortcut (KDE):
|
|
|
|
Under KDE installing a global custom keyboard shortcut like we need is most
|
|
helpfully not under "Keyboard Shortcuts" but under "Input Actions".
|
|
|
|
- _Kmenu -> Configure Desktop -> Input Actions -> Edit -> New -> Global
|
|
Shortcut -> Command/Url_
|
|
- A new Action appears, named _New Action_. You can rename it something
|
|
like +hotrecoll+ for clarity.
|
|
- Click the _Trigger_ tab, click the input area and press your preferred
|
|
key combination (ie: F12)
|
|
- Click the _Action_ tab, and enter +hotrecoll.py+ (if it's in your PATH),
|
|
or else the full path to the command (e.g.:
|
|
'/usr/share/recoll/filters/hotrecoll.py').
|
|
- Click _Apply_.
|
|
|
|
=== Installing the keyboard shortcut (XFCE):
|
|
|
|
Open the settings manager, and add the shortcut in the
|
|
_Application Shortcuts_ panel inside the _Keyboard_ tool.
|
|
|
|
|
|
=== Other environments
|
|
|
|
Many window managers have a way to set up a keyboard shortcut for running
|
|
an arbitrary command. You'll need to look at the documentation for yours,
|
|
or search the web for a solution.
|
|
|
|
An alternative independant of the environment would be to use the XBindKeys
|
|
utility. See this link:http://www.linux.com/archive/feed/59494[linux.com
|
|
article] for helpful instructions.
|
|
|