1 wmbutton Ver. 0 Rel 6.1
2 -------------------------------------------------------------
3 Code is based on wmppp, wmload, wmtime, wmcp, and asbutton
4 Author: Edward H. Flora <ehf_dockapps@cox.net>
5 This version is released by:
6 Christian 'Greek0' Aichinger <Greek0@gmx.net>
7 Ver 0 Rel 6.1 Jan 23, 2005
11 wmbutton is a simple application launching program that sits in the
12 dock in WindowMaker, can be swallowed by Wharf in Afterstep, and
13 should be fairly configurable.
17 This program is released under the GPL license. A copy (in case you
18 don't already have hundreds of them floating around) can be found in
19 this distribution in the file COPYING
23 Christian 'Greek0' Aichinger <Greek0@gmx.net>
24 Did some code cleanup and fixed several memory leaks.
25 Ralf Horstmann <ralf.horstmann@gmx.de>
26 Added ability to load pixmaps at startup,
27 without having to re-compile
28 Michael Cohrs <camico@users.sourceforge.net>
29 Added Tool Tips, and updated graphics
30 Bruno Essmann <essmann@users.sourceforge.net>)
32 Ben Cohen <buddog@aztec.asu.edu>
33 original author of wmcp (et al.)
34 Thomas Nemeth <tnemeth@multimania.com>
36 Casey Harkins <charkins@cs.wisc.edu>
37 Bug fix reading config file path - 3/6/99
38 Added button-presses, and other - denoted by *charkins*
39 Michael Henderson <mghenderson@lanl.gov>
40 Application ideas, suggestions
41 Ryan ?? <pancake@mindspring.com>
42 Modified wmbutton to asbutton.
43 Note: asbutton is a seperate program, not associated
44 with wmbutton (just as wmbutton is not associated
48 The contributors listed above are not necessarily involved with the
49 development of wmbutton. I'm listing them here partially as thanks for
50 helping out, catching bugs in the code, etc.
55 tar xvzf wmbutton-0.6.1.tar.gz
57 CD to source directory:
60 Edit background xpm, and buttons.xpm to your preferences
61 There are icon files in ./icons to work from
69 Put the executable somewhere in your path:
70 mv wmbutton /usr/local/bin (or anyhere in your path)
75 Grab the appicon and move it to the dock.
76 Change the settings to start with Windowmaker
78 Afterstep Wharf 1.6.??:
79 *Wharf wmbutton -Swallow "wmbutton" wmbutton &
82 The appicon has only a two pixel border where you can grab
85 If make doesn't work, you may need to fiddle with the settings in
88 Tested on: (Well, it runs, I don't know if 'Tested' is quite right...)
92 Clients: Red Hat 8.x, Kernel 2.4.18
97 wmbutton [-g geom] [-d dpy] [-f cfgfile] [-b btnfile] [-F <font>]
100 wmbutton Ver 0 Rel 6.1
102 -g <geometry> Window Geometry - ie: 64x64+10+10
103 -d <display> Display - ie: 127.0.0.1:0.0
104 -f <filename> Full path to configuration file.
105 -b <filename> Full path to button xpm.
106 -F <font> Custom tooltip font (e.g. -b\&h-lucidatypewriter-medium-*-*-*-12-*)
108 -h Help. This message.
109 -m Disable Middle Mouse functionality.
110 -s Swap tooltip colors.
111 -n Turn off tooltips.
114 Selects the application to launch, numbered 1 through 9
116 Middle mouse button: (unless disabled (-m))
117 Selects the application to launch, numbered 11 through 19
120 Selects the application to launch, numbered 21 through 29
124 This is a simple application launching tool for use in WindowMaker, and
125 possibly Afterstep. (Who knows, it should run for other window managers too,
126 by why bother?? It is taken from wmcp, by Ben Cohen, and modified just
127 enough to run applications rather than send ALT-[1..9] key sequences to
128 WindowMaker. It has also taken some ideas from asbuttons, and
129 included them back into the original. There may still be some code
130 left over from wmcp that is no longer needed, but...
132 The mini-icons must be combined into a single graphic, buttons.xpm. The
133 background border is defined in backdrop.xpm. Both must be edited in your
134 favorite graphics editor (GIMP??), and then recompiled. wmbuttons uses a
135 configuration file (usually ~/.wmbutton) for which applications to launch.
136 There is no need to restart wmbuttons when simply changing the configuration,
137 as wmbutton searches the file whenever a button is pressed.
139 As of release 0.5, you can also pass in your own pixmap file for the
140 buttons, to override the buttons that are compiled it. This file should
141 still have the same height and width so that it will make sense,
142 though really you give it any XPM you want, but it will only display
143 the upper left 54x54 pixel corner.
146 An example file is included, related to the the buttons.xpm graphic file.
151 0.6.1 Minor changes to the Makefile.
152 0.6 Code cleanup and fixes for memory leaks by Christian 'Greek0' Aichinger.
153 0.5 Added Modifications submitted by Ralf Horstmann.
154 Load different pixmaps at start-up time, rather than having
155 to compile them in. This also makes it much easier to run
157 Added Modifications submitted by Michael Cohrs.
159 Updated default buttons.xpm graphics
160 General Code clean-up, including export must functions to
161 seperate C file, to reduce clutter.
163 0.4 Added Modifications submitted by Casey Harkins.
164 Start application on mouse button release,
165 Only start app if cursor is still on application button
166 Added 3-D button press look
167 Added new .wmbutton configuration file
169 0.3 Graphics changed to incorporate most changes made by asbutton
170 Removed Middle/Right mouse click on button to turn off buttons
172 Added Middle and Right mouse buttons to run more Applications
173 (Yes, you can now really run 27 different Apps from a single
174 instance of wmbuttons, if you would want too...)
175 Fixed bug for finding config file .wmbutton.
176 It used to not look in the home directory, but in the
177 startup directory. Thanks to Casey harkins for the fix.
178 Included the icons directory from the asbutton distribution,
181 0.2 Added single configuration file, user selectable.
183 0.1 Origional version.
184 Shamelessly taken from wmcp 1.2.5,
185 by Ben Cohen <buddog@aztec.asu.edu>
189 Add ability (via config file) to use discrete 16x16 pixel icons for
190 the buttons, rather than having to paste them all into the existing file.
191 Make changing icons and/or background graphics easier.
192 Allow for less than 9 icons, 4 would be nicer on the mini-icon size.
196 Remember, they're just undocumented FEATURES!!!
198 Probably Lots. Send comments (preferably with fixes) to
199 <ehf_dockapps@cox.net>
205 "C code. C code run. Run, code, run.