NAME

       kupfer - Convenient command and access tool for applications and documents

SYNOPSIS

       kupfer [ OPTIONS | FILE ... ]
       kupfer-exec FILE ...

DESCRIPTION

       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.

       kupfer-exec is a helper script that can execute  commands  saved  to  file,  but  only  by
       connecting to an already running instance of Kupfer.

SPAWNING

       Running  kupfer  on  the command line (without options) will try to show the program it if
       already running.

       Kupfer can be invoked with a list of files
          kupfer FILE ...

       This can be used to select files given as command-line arguments in the program. Then  you
       can invoke actions even on objects from a shell-based context.

       You  may  also  pipe  text  to  kupfer  to  pass it to a currently running instance of the
       program.

OPTIONS

       --no-splash
              Launch without presenting main interface

       --list-plugins
              Display a list of all installed plugins

       --debug
              Enable more verbose output that can help understanding the program's operation.

       --relay
              Is deprecated and will be started by the Multihead Support plugin when needed

       --exec-helper=HELPER
              Run plugin helper program, which should be the name of a module inside kupfer.

       The following are generic options

       --help Display usage information

       --version
              Display version information

CONFIGURATION

       Custom  plugins  are   added   to   kupfer   by   installing   them   to   the   directory
       ~/.local/share/kupfer/plugins, or any kupfer/plugins directory in any of $XDG_DATA_DIRS.

ENVIRONMENT VARIABLES

       If  KUPFER_NO_CUSTOM_PLUGINS is set, only allow loading built-in plugins (installed in the
       program's python package).

       If KUPFER_NO_CACHE is set, do not load from or write to any source cache files.

AUTHOR

       Ulrik Sverdrup <ulrik.sverdrup@gmail.com>

                                               2011                                     KUPFER(1)