Hi, I'm currently working on an upcoming manual for Kupfer. I have tried to use a code block with the following content: <code> [Kupfer] keybinding = <Control>space magickeybinding = <Ctrl><Alt>space </code> But Mallard doesn't accept this construction, I get the following error message: plugins.page:51: parser error : Opening and ending tag mismatch: Alt line 50 and code </code> ^ plugins.page:66: parser error : Opening and ending tag mismatch: Ctrl line 50 and section </section> ^ plugins.page:179: parser error : Opening and ending tag mismatch: Control line 49 and page </page> ^ plugins.page:180: parser error : Premature end of data in tag code line 47 ^ plugins.page:180: parser error : Premature end of data in tag section line 40 ^ plugins.page:180: parser error : Premature end of data in tag page line 1 ^ unable to parse plugins.page Normally it should accept any characters within <code></code>. What's the problem here? I tried to mask the < and > with backslashes, no success. Cheers, MarioTitle: Plugins
You can install custom plugins into ~/.local/share/kupfer/plugins; adding to Kupfer's object knowledge can be surprisingly easy, just look at the default plugins if you want to create new.
The Search the Web plugin uses
You can also install custom search plugins directly, only for Kupfer, in the folder:
~/.local/share/kupfer/searchplugins/
Open terminal first calls
To use Kupfer like a pro, you can configure a "Magic Keybinding"
for Kupfer. GUI configuration is not yet supported, but edit the configuration
file
[Kupfer]
keybinding = space
magickeybinding = space
Now, pressing
Now you can select a word in, say, a web browser, use
If you want to add a custom application, or an application called with
special options, you can create a new launcher for it and place it in
one of the standard places for applications, for example
If you have a collection of scripts that you want to call from kupfer, you can add the scripts folder as a catalog directory to Kupfer in the preferences. Scripts that you add to kupfer's catalog this way can be run directly or in the terminal as long as they are executable.
An example useful script is here which changes the rating of Rhythmbox's currently playing song; I have added five scriptlets calling 'rhrating.py' with numbers from 0 to 5 to my catalog to quickly rate tracks. (This is something that might be integrated into Kupfer later)
The calculator plugin lets you calculate expressions quickly. It can evaluate expressions entered as text starting with "=". Entering = from command mode will start text mode directly with = prefixed for quick access.
The Calculator uses python's math and complex math modules,
and parses expressions as Python expressions. You may use common
mathematical functions, such as sqrt, sin, exp and log; the command
Notice that the power operator in Python is double stars, for example =3**3 will evaluate to 27.
To calculate trig functions for angles, convert to radians first: sin(radians(30)) -> 0.5
The last result is stored as the name _ (an underscore, just like in the Python console).
Kupfer is its own remote control. When kupfer is already running,
kupfer on the command-line will focus its window, but there is more
you can do: If you invoke
For example, if you are using the shell in a directory where you have
a file called "report.pdf", you can focus this file in kupfer by
running
You can also pipe the output of a command into kupfer to send text to the already running instance of Kupfer.
If you find the object you want to use, then invoke an action, Kupfer goes away to perform the action (for example start a program or play a song). When you come back to Kupfer, it will still keep the same object and action selected. Some actions make sense to be repeated (like skipping to the next song) and it can be useful to perform different actions on the same object.
However, you always have the top level catalog reachable when you "come back" to Kupfer -- say you went into the subcatalog "Albums" to browse your albums only; you select and album to play, and play it. You come back with the album selected -- but your next search will still go over the top level catalog, not just albums.
How to come back into the subcatalog you were in? You do that by simply browsing, not searching the first thing you do when you focus Kupfer again. A quick way is to press down-arrow or space to open the browse window; think of it as saying "I want to stay in this subfolder". With the browse window open, your next query will search the current subcatalog.
This way you can work both ways -- you can quickly drill down into folders to find a file, and when you come back for the next action with Kupfer you can either summon any normal toplevel object (just start typing), or stay around where you were, deep in that folder (press space, then type a query).