ulrik@kaizer.se/
kupfer (dude!)

kupfer, a convenient command and access tool

screenshot

Kupfer is an interface for quick and convenient access to applications and their documents.

The most typical use is to find a specific application and launch it. We have tried to make Kupfer easy to extend with plugins so that this quick-access paradigm can be extended to many more objects than just applications.

We hope that using Kupfer feels both very fun and different.

[screenshot] rhythmbox songs

You can access songs from the music player quickly (here using Rhythmbox integration).

[screenshot] file management

You can browse and manage files.

Latest Kupfer blog post

Stealing icons
Posted late Sunday evening, April 3rd, 2011

Latest version

v206

Source tarball: kupfer-v206.tar.gz (785 K)

The longest changelog ever—the best Kupfer ever?

Released Thursday, 14 April 2011

These are changes since the v205 release. Below this I have included the full changelog for all the features introduced in v205, since it was not published in whole together with the that release.

I would like to thank all contributors for patches, bug reports, comments and translations. A special thanks to those who have contributed to the user documentation; it is now complete in both Polish and Spanish.

If you like my work with Kupfer, you can support me by donating. There are instructions how to do so on the web page. –ulrik

  • Thunderbird: fix double create email windows (747198)
  • Thunderbird: fix problem with loading contacts (Karol Będkowski) (747538)
  • Use rst2man as it was configured (747500)
  • Reduce runtime memory use for substantially by reimplementing the icon cache (expectations vary btw. 10 to 30 percent).
  • Prefer gnomekeyring over kwallet, and don't load keyring support if it is not requested by a plugin (747864)
  • Make the "folder" icon take precedence over "inode/directory"
  • Fix a regression in Go To that would not focus minimized windows.
  • In Go To action, cycle application windows (if they are all on the same workspace).
  • Fix 671105: the user's home is aliased as Home Folder and the "lookalike" application is hidden.
  • Use GTK+ as default icon set, the ASCII icon set remains as a plugin
  • Fix regression 749824, kupfer used a GTK+ 2.20 feature. Kupfer should now run under GTK+ 2.18 (2.16?). GTK+ 2.20 is recommended and needed for full input method support.
  • Remake .desktop file parsing to be much more lenient, so that we can launch all applications again. Affected were especially launcher files written by wine.
  • Make sure the Home key works in text mode (750240)
  • Rhythmbox: Fix omission of .jpg extension when searching cover art (William Friesen)
  • Support xfce4-dict in Dictionary plugin (David Schneider)
  • Make sure kupfer.svg can be mimetype-detected (NAKAMURA Yoshitaka) (750488)
  • Fix regression that prevented mimetypes and icon cache from being updated properly when installing from source.
  • Focus the plugin list search box by default in the preferences window.
  • Fix regression in XFCE Session Management that had a broken logout command.
  • Install kupfer as a Thunar 'sendto' object.
  • Fix a bug in the autostart file we installed, it was including a '%F' which broke --no-splash when autostarted on XFCE.
  • LibreOffice: support their newer recent documents file (Karol Będkowski)
  • Notes: Insert newlines after the new note title (748991)
  • Commands: Recognize absolute paths with arguments as shell commands (for example /bin/grep --help.
  • GNU Screen: check if sessions are still active (756449), don't give up even if $SCREENDIR is missing when we are started (753376)
  • Notes: support the program kzrnote as well
  • Renamed the two like-named command actions in spanish (Daniel Mustieles)
  • Localization updates for v206:
    • sl Andrej Žnidaršič
    • es Daniel Mustieles
    • de Mario Blättermann

This is the changelog for the v205 release, which was released previously.

  • Changes to the interface
    • Add a small menu button on the window for explicit access to context actions, preferences window, and help.
    • Increase icon size to 128px
    • Always show description field
    • Use an undecorated window with rounded corners
    • Let the frame be slightly transparent if supported
    • Themable colors and properties by using GTK+ styling, see Documentation/GTKTheming.rst, and the plugin Custom Theme that shows how to use custom styles.
  • Add context action "Set X as default action for object Y"
    • For example, you can make Launch Again default for Terminal, and our default configuration uses this setting for two common terminals (GNOME and XFCE).
  • Updated Kupfer's technical documentation (in Documentation/), including the Plugin API reference.
  • Implement a preedit widget for input methods, also resolving the incompatibility with ibus (David Schneider) (696727)
  • Re-implement launching of applications
  • Allow the user to configure which terminal program is used. Applies to all of Run in Terminal, Open Terminal Here, for .desktop files that specify Terminal=true etc.
  • Implement an "alternatives" mechanism so that plugins can register mutually exclusive alternatives. Currently implemented are Terminals (see above) and Icon Renderers.
  • Thunar: Use Thunar 1.2's Copy and Move API.
    • These allow copying and moving anything through thunar, and it will show progress dialogs for longer transactions.
  • Add Ascii & Unicode Icon Set for fun
  • Add simple plugin Quick Image Viewer to show images in a simple way.
  • Add Send Keys plugin that can send synthetic keyboard events, and prominently can be used for the Paste to Foreground Window action on text. Requires xautomation package. (621453)
  • Volumes: treat mounts as regular folders, so they can be targets for file operations.
  • File Actions: the action Move to Trash switches home to the Trash plugin, the archive actions go to new Archive Manager plugin. Archive Manager also updated to recognize more archive file types, including .xz.
  • Activate current selection on double-click in the interface. (700948)
  • Update the preferences window and move the folder configuration to the Catalog tab.
  • Add initialize_plugin to the plugin interface.
  • The D-Bus interface has been extended with X screen and timestamp-aware versions of all methods:
    • PresentOnDisplay, PutFilesOnDisplay, PutTextOnDisplay, ExecuteFileOnDisplay all act like their similarly-named predecessors, but take $DISPLAY and $DESKTOP_STARTUP_ID as their last two arguments.
    • kupfer-exec activation sends the event timestamp so that focus can be carried along correctly even when running .kfcom files (if activated as an application by startup-notification-aware launchers, this works with most standard desktop components).
  • Internally, change how actions are carried out by allowing the action execution context object to be passed down the execution chain instead of being a global resource. This also allows plugins to cleanly access current environment (event timestamp, current screen etc).
    • Support running kupfer on multiple X screens (614796), use the command kupfer --relay on each additional screen for global keyboard shortcut support. This is experimental until further notice!
  • The Tracker 0.8 plugin supports version 0.8 and 0.10 alike. Because of that and the expected compatibility with one version after this too, it's now called Tracker.
  • The Favorites plugin lists Kupfer Help and Kupfer Preferences by default (for new users), so that it's not empty and those items are ranked higher.
  • In free-text mode, show a character count in the text entry.
  • The action Go To on applications has changed implementation. It will first bring to front all the application's windows on the current workspace, and upon the next invocations it will focus the other workspaces, in order, if they have windows from the same application. For single-window applications, nothing is changed.
  • Localization updates for v205:
    • (cs) Marek Černocký
    • (de) Mario Blättermann
    • (es) Daniel Mustieles
    • (ko) Kim Boram
    • (nb) Kjartan Maraas
    • (pl) Karol Będkowski
    • (sl) Andrej Žnidaršič
    • (sv) Ulrik
Posted Thursday night, April 14th, 2011

Version history... [RSS]

Donations

I accept donations for my work on Kupfer.

Flattr button Paypal button

Get Kupfer from your distribution

Ubuntu and Debian
Kupfer is available in the repository under the package name kupfer, you can install it with your package manager.
Ubuntu PPA
More up to date versions of Kupfer are available in Kupfer's PPA.
Arch Linux
Kupfer is available in the community repositories (AUR)

Installation from Source

The installation from source is simple and uses waf; install Kupfer with the following procedure:

./waf configure
./waf
sudo ./waf install

Requirements

Kupfer requires Python 2.6 or later, and Python modules gtk, dbus, and xdg. Intltool is required to build the package from source. The module python-keybinder is strongly recommended. See the README for more detailed information.

Documentation

  1. User Documentation "Help"
  2. Technical Documentation

Links