README
1What is bbdock ?
2
3 bbdock displays one or more PNG icons in the BlackBox/FluxBox slit from
4 which you can launch the corresponding applications. It is pretty similar
5 in function and appearance to bbbutton which you might want to try if you
6 are reading this on a display with a color-depth below 16 bits.
7
8How to compile
9
10 Since you are reading this I assume you already unpacked the archive into
11 some directory.
12
13 ./configure
14 make
15 su
16 make install
17
18 For more options try ./configure --help
19
20 You need X11 libraries & headers and libpng-devel. If anything fails,
21 just drop me a line at mf@markusfisch.de ;-)
22
23Configuration
24
25 You may invoke bbdock either with your icons specified on command line
26 or simply create a short configuration file (.bbdockrc) in your home
27 directory.
28
29 The syntax for a command-line-argument or a line in the configuration
30 file is equal:
31
32 IMAGEFILE:COMMAND[:WINDOWTITLE;[:IDLE]]
33
34 IMAGEFILE - should be path and filename of some PNG icon
35 COMMAND - a script or binary to execute
36 WINDOWTITLE - is a semicolon-seperated list of case-insensitive
37 window-titles of corresponding application-windows. Those
38 strings may contain wildcard characters (* and/or ?) to
39 exclusively identify a window. By providing this list you
40 make the icon exclusive to one instance of course. Clicking
41 on already launched icons will raise the corresponding
42 window instead of invoking a new instance.
43 IDLE - idle time after triggering one icon in miliseconds, instead
44 of using numbers you may also use the terms "lame" (~ 10 s),
45 "slow" (~ 5 s), "fast" (~ 500 ms) or "fastest" (~ 250 ms)
46
47 For example, run it from command line this way:
48
49 $ bbdock "~/.icons/firefox.png:firefox:*Firefox"
50
51 Sample out of a ~/.bbdockrc:
52
53 ~/.icons/terminal.png:xterm::1
54 ~/.icons/firefox.png:firefox:*Firefox
55
56 To start by configuration file, just run bbdock. Type "bbdock -h" for
57 a detailed view of general options.
58
59Requirement
60
61 The images should be not much greater than 48x48 pixels and must be in
62 PNG format. Use images with transparency to get the most out of it.
63
64 You need libpng-devel to compile this software. The raise-window
65 function is only available to window managers which implement the EWMH
66 specification.
67
68Bugs
69
70 Currently there are only two known bugs you might run into:
71
72 If you're using BlackBox > 0.70 you need to patch it in order to make it
73 work correctly. Just insert the following code after line 250 into
74 blackbox-0.70.0/src/Slit.cc and recompile BlackBox:
75
76 if ((texture.texture() & bt::Texture::Gradient) && frame.pixmap)
77 XSetWindowBackgroundPixmap(display, frame.window, frame.pixmap);
78 else if ((texture.texture() & bt::Texture::Solid))
79 XSetWindowBackground(display, frame.window,
80 texture.color1().pixel(screen->screenNumber()));
81
82 FluxBox < 0.9 may fail to raise applications that are exclusive. Update
83 to FluxBox 0.9 to fix this problem.
84
85Links
86
87 bbdock - http://bbdock.nethence.com
88 BlackBox - http://blackboxwm.sourceforge.net/
89 FluxBox - http://www.fluxbox.org/
90 BBButton - http://www.angelfire.com/theforce/button/
91 wmctrl - http://sweb.cz/tripie/utils/wmctrl/
92
93Licencing
94
95 See the COPYING file
96
97Authors
98
99 See the AUTHORS file
100
