

  Breeze  --  An application launcher with command-line style


1. Abstract

  Breeze is an application launcher, driven with keyboard.
  It aims to be a clone of Bluewind (http://cspace.s2.xrea.com/), but not
  yet.


2. Version / Release date

  0.0.5   2008-09-20
  0.0.4   2008-07-22
  0.0.3   2006-02-25
  0.0.2   2006-01-27
  0.0.1   2005-12-22


3. Installation

  See INSTALL.


4. How to use

  Edit $HOME/.xinitrc to launch breeze on startx. (be sure to add '&'.)
  Keys bound to call breeze is now hard-coded. Default is <Mod4> + <space>.
  You can change the key via command line arguments (see below).

  A window opens when that bound keys pressed. Then enter keyword and press
  <Enter>. Command registered with the keyword will be executed. If the
  keyword is not registered (= first time use), registration dialog box will
  prompt you to register it.

  There are some pre-defined commands as below:

    "Reload"      --- Reload commands from last-saved file
    "About"       --- Show version info
    "Quit"        --- Quit Breeze itself
    "Edit" or "" (empty string)
                  --- Open command editor

  All resisted commands are saved in $HOME/.breeze_commands.  Please do not
  edit the file directly.


  [ Advise on <Windows key> ]

  <Mod4> key is usually mapped on <Super_L> and <Super_R> as below:

    $ xmodmap -pm | grep Super
    mod4        Super_L (0x73),  Super_R (0x74)

  Also, <Super_L>, <Super_R> are mapped on <Windows key> on PC/AT keyboard:

    $ xmodmap -pk | grep Super
        115         0xffeb (Super_L)
        116         0xffec (Super_R)

  If not, man page xmodmap(1) will help you.  Also you can change the default
  key by modifying `src/main.c' and recompiling it.


  [ Run-time key configuration ]

  Since version 0.0.3, Breeze is capable of run-time key configuration with
  command-line arguments.  For example, to bind <Ctrl> + <Alt> + <Enter> as
  keys to call, launch Breeze as below:

    breeze -k Return -m Control -m Mod1

  See "breeze --help" for the detail options.


5. Authors

  See AUTHORS.

  Website: http://breeze.sourceforge.jp/


6. Copyright and disclaimer

  Breeze is licensed under the GNU General Public License version 2.
  This software is provided with no warranty.  See COPYING for more details.

