home
[section::QLBar]
QLBar is a Toolbar gadget for X11 that contains icons and allows to launch associated applications quickly. Usually it appears as a one pixel high line placed at edge of the screen, because not to cover other windows. On mouse move on this line QLBar appears as a bar with icon images. Common configured application is launched after mouse press over associated icon.
[section::download]
Date bzip2 tar gzip Slackware
2018-04-21 qlbar-0.2.5.tar.bz2 qlbar-0.2.5.tar.gz -
2012-01-23 qlbar-0.2.4.tar.bz2 qlbar-0.2.4.tar.gz qlbar-0.2.4-i486-1_pab.tgz
2011-11-27 qlbar-0.2.3.tar.bz2 qlbar-0.2.3.tar.gz
2011-11-05 qlbar-0.2.2.tar.bz2 qlbar-0.2.2.tar.gz
2011-03-15 qlbar-0.2.0.tar.bz2 qlbar-0.2.0.tar.gz
2008-08-13 qlbar-0.1.4.tar.bz2 qlbar-0.1.4.tar.gz
2008-05-06 qlbar-0.1.3.tar.bz2 qlbar-0.1.3.tar.gz
2007-12-26 qlbar-0.1.2.tar.bz2 qlbar-0.1.2.tar.gz
2007-11-11 qlbar-0.1.1.tar.bz2 qlbar-0.1.1.tar.gz
2007-10-20 qlbar-0.1.0.tar.bz2 qlbar-0.1.0.tar.gz
[section::requirements]
QLBar requires following libraries:
  1. IMlib2 that can be found at: http://freshmeat.net/projects/imlib2/
[section::configuration]
QLBar configuration is based on two files: menu and config that are placed in $HOME/.qlbar directory by default.

  1. Menu - menu file describes applications that are assigned to bar.
    (application name) is in ( and ) brackets
    {execute path} is placed in { and } brackets and points to a file that will be launched
    <icon path> is placed in < and > and points to a icon (xpm, png, ...) file that will be displayed on the bar.

  2. Config - config file contains informations about display and behavior of qlbar
    It's format is as follow: attribute name = attribute value and below attributes are available for current version:

    Attribute name Description Default value
    icon-width integer that represents width of each icon on the toolbar in pixels 32
    icon-height integer that represents height of each icon on the toolbar in pixels 32
    bar-color integer that represents color of the toolbar in line hidden mode 80
    bar-height integer that represents height of the bar in hidden mode (width of a line) in pixels 1
    bar-width integer that represents width of the bar in hidden mode (width of a line) in pixels 1
    string default - that tells the width of the bar will be computed as a sum of widths of all icons the bar contains default
    position string that represents placement information of the bar. Possible values are:
    n - bar will be placed on upper edge of screen
    ne - bar will be placed on upper-right corner of screen
    e - bar will be placed on right edge of screen
    se - bar will be placed on lower-right edge of screen
    s - bar will be placed on lower edge of screen
    sw - bar will be placed on lower-left edge of screen
    w - bar will be placed on left edge of screen
    nw - bar will be placed on upper-left edge of screen     		n
    bar-time integer that represents after how many seconds bar will hide when mouse pointer is not over the bar 1
    double string true double click to execute command false
    click-interval interval 250 interval between button clicks [msec] 250
    layout string that informs the bar to be placed horizontal or vertical horizontal
    hoffset integer that represents horizontal offset (in pixels) from position corner of the screen. It has meaning only when layout is horizontal and position is one of following: ne, nw, se, sw 0
    voffset integer that represents vertical offset (in pixels) from position corner of the screen. It has meaning only when layout is vertical and position is one of following: ne, nw, se, sw 0
    balloon-color integer that represents background color of a balloon tooltip  
    font-color integer that represents foreground (text) color of a balloon tooltip  
    font-name string that represents name of a font used by balloon tooltip  
    font-size integer that represents size of a font used by balloon tooltip  
    font-dir string that represents directory of TTF containing font used by tooltip balloon  
    show-balloon string true when tooltip balloon should be shown, false if balloon tooltip should not be shown. Default true  
    daemonize qlbar will be run in the background  
    log application will produce default (warn level) logs  
    loglevel the log level: trace, debug, info, warn, error, fatal warn
    logfile log filename, default: stderr  

[section::white papers]
Manual page for 0.2.2+ versions qlbar_man.html qlbar.pdf
[section::TODO]
priority LOW priority MEDIUM priority HIGH
create distibution specific installation packages
transparent rectangle with alpha that appears when user moves mouse over toolbar item
right click context menu over every item with extra features (configure)
sliding bar instead of sudden appear, hide
fixed qlbar icon, with clock, reminder, or other functionalities...
bar movement by mouse dragging to other dock place
configurable separator in .qlbar/menu file
[section::screenshots]