| 1 | ACME 2.0 |
|---|
| 2 | |
|---|
| 3 | This is ACME, a small tool for your laptops. It makes the small multimedia |
|---|
| 4 | buttons on these things actually do something. It currently only fully supports |
|---|
| 5 | Apple laptops (iBooks and Powerbooks), and should work on other systems as well. |
|---|
| 6 | |
|---|
| 7 | Supported is: |
|---|
| 8 | - Volume keys (Mute, Volume Down, Volume Up) |
|---|
| 9 | - Brightness keys (kernel 2.4.18-rc2-benh minimum, PowerBooks only) |
|---|
| 10 | - Eject (just launches "eject") |
|---|
| 11 | - Power (asks to exit the current Gnome session) |
|---|
| 12 | - My Home (opens a file manager window in your home dir) |
|---|
| 13 | - Search (launches gnome-search tool) |
|---|
| 14 | - E-Mail (launches evolution or balsa) |
|---|
| 15 | - Sleep (uses apm to put to sleep) |
|---|
| 16 | - Screensaver (launches gnome's screensaver) |
|---|
| 17 | - Finance (launches gnucash) |
|---|
| 18 | - Help (launches yelp) |
|---|
| 19 | - Record (launches gnome-sound-recorder) |
|---|
| 20 | - WWW (launches an empty new browser) |
|---|
| 21 | - Calculator (launches gnome-calculator) |
|---|
| 22 | - Close Window, Shade Window |
|---|
| 23 | - Media (launches the default MP3 player) |
|---|
| 24 | - Groups (Browser to www.gnomedesktop.org) |
|---|
| 25 | - Play, Pause, Stop, Previous and Next, and Refresh (see News below) |
|---|
| 26 | |
|---|
| 27 | Eject and Power need to be pressed for a longer time to take effect. |
|---|
| 28 | The automatic dimming of the screen when inactive was removed, as this |
|---|
| 29 | functionality is available in a less broken way in XFree 4.2. |
|---|
| 30 | |
|---|
| 31 | This URL contains more information: |
|---|
| 32 | http://lists.debian.org/debian-powerpc/2002/debian-powerpc-200204/msg00615.html |
|---|
| 33 | |
|---|
| 34 | New in version |
|---|
| 35 | -------------- |
|---|
| 36 | |
|---|
| 37 | 2.0.2: |
|---|
| 38 | - Build fixes for non-XFree86 X11 installations |
|---|
| 39 | |
|---|
| 40 | 2.0.1: |
|---|
| 41 | - Plenty of translation updates, and a small fix for Anders that nobody else |
|---|
| 42 | will care about ;) |
|---|
| 43 | |
|---|
| 44 | 2.0: |
|---|
| 45 | - Fix key names not getting translated in the preferences |
|---|
| 46 | - Work properly on multihead |
|---|
| 47 | |
|---|
| 48 | 1.99.13: |
|---|
| 49 | - Build fixes again |
|---|
| 50 | |
|---|
| 51 | 1.99.12: |
|---|
| 52 | - Build fixes |
|---|
| 53 | |
|---|
| 54 | 1.99.11: |
|---|
| 55 | - Added support for Play, Pause, Stop, Previous and Next buttons. |
|---|
| 56 | developers should fetch the key with the following keysyms |
|---|
| 57 | XF86XK_AudioPlay, XF86XK_AudioPause, XF86XK_AudioStop, |
|---|
| 58 | XF86XK_AudioPrev, XF86XK_AudioNext |
|---|
| 59 | - Clear the keycode after we ungrab a key |
|---|
| 60 | - HIG-ish interface from elle.uca@genie.it |
|---|
| 61 | - Added support for Media, Groups and Refresh buttons |
|---|
| 62 | |
|---|
| 63 | 1.99.10: |
|---|
| 64 | - New application icon by Lapo Calamandrei |
|---|
| 65 | - Fix crashes with Gtk+ 2.1 |
|---|
| 66 | - Show the tray icon again if the panel crashes |
|---|
| 67 | - Added support for the "Close Window" and "Shade Window" buttons |
|---|
| 68 | |
|---|
| 69 | 1.99.9: |
|---|
| 70 | - Add support for WWW, Calculator and Record |
|---|
| 71 | - Only use the fb-level stuff on Powerbooks and iBooks |
|---|
| 72 | - Better icons by Lapo Calamandrei |
|---|
| 73 | - Use key releases instead of key presses |
|---|
| 74 | - Add nifty icons before the description, as the "Enabled/Disabled" |
|---|
| 75 | labels weren't very clear |
|---|
| 76 | |
|---|
| 77 | 1.99.8: |
|---|
| 78 | - launch the preferences if ACME is unconfigured |
|---|
| 79 | - make it possible to run ACME even without a (supported) soundcard |
|---|
| 80 | - Remove usage of keycode everywhere in the GUI |
|---|
| 81 | - Click anywhere on the line in the prefs to change a shortcut |
|---|
| 82 | - Some prefs fixes |
|---|
| 83 | - Added plenty of keys from Christian's keyboard (My Home, Search, |
|---|
| 84 | E-Mail, Sleep, Screensaver, Finance and Help keys) |
|---|
| 85 | - Fix key grabbing not to annoy a11y programs |
|---|
| 86 | |
|---|
| 87 | 1.99.7: |
|---|
| 88 | - make acme be unique per display instead of per user |
|---|
| 89 | - fixed a bug causing it to always use default values when grabbing |
|---|
| 90 | keys. (Mikael Hallendal) |
|---|
| 91 | - fix crash on exit |
|---|
| 92 | - default to OSS mixer even if ALSA is present. |
|---|
| 93 | |
|---|
| 94 | 1.99.6: |
|---|
| 95 | - use CLAMP when appropriate |
|---|
| 96 | - some build updates |
|---|
| 97 | - ALSA/OSS run-time detection |
|---|
| 98 | - acme should now be able to compile on all Unices |
|---|
| 99 | - fix the error dialog not popping up when the brightness couldn't be controlled |
|---|
| 100 | |
|---|
| 101 | 1.99.5: |
|---|
| 102 | - completely ported now with all deprecated calls removed |
|---|
| 103 | - fixed a bug with the custom eject command |
|---|
| 104 | - made disabled keys appear as having a "Disabled" keycode in the prefs rather |
|---|
| 105 | than "-1" |
|---|
| 106 | - made the prefs window non-resizable |
|---|
| 107 | - proper i18n setup |
|---|
| 108 | |
|---|
| 109 | 1.99.4: |
|---|
| 110 | - eject command is configurable for "power users", via gconf-editor (note that this won't be made configurable via the preferences GUI, if eject doesn't work for you, file a bug against it) |
|---|
| 111 | - added sound playing when the volume is changed (I recommend |
|---|
| 112 | /System/Library/Sounds/Purr.aiff from your MacOS X partition) |
|---|
| 113 | - UI reviewed by Calum, cleanups, icon for the preferences window by Jimmac |
|---|
| 114 | |
|---|
| 115 | 1.99.3: |
|---|
| 116 | - added a "use_pcm" configuration for people that don't want to change the master volume |
|---|
| 117 | - made gconf really work now :) |
|---|
| 118 | - changed the dashes to underscores in the schema |
|---|
| 119 | - don't use libglade-convert anymore, glade-2 works well enough now |
|---|
| 120 | - added brightness button support, GUI for the eject button, and misc fixes |
|---|
| 121 | - much better behaviour and looks when acme is swapped out |
|---|
| 122 | - killed Acme global variable, better non-linux and non-ppc platform support, |
|---|
| 123 | cleanups |
|---|
| 124 | - made acme exit if another version of it is already running |
|---|
| 125 | - translate .schemas file, added dummy en_GB translation |
|---|
| 126 | - changed the default volume step to 6% |
|---|
| 127 | - added a configuration GUI |
|---|
| 128 | - added button to launch acme in the configurator |
|---|
| 129 | |
|---|
| 130 | 1.99.1: |
|---|
| 131 | - removed some unused images |
|---|
| 132 | - made it compile (and work!) with everything but GDK_DISABLE_DEPRECATED |
|---|
| 133 | - added an icon for the brightness |
|---|
| 134 | - gconf-ied the whole thing |
|---|
| 135 | |
|---|
| 136 | 1.99.0: |
|---|
| 137 | - ported to gnome2 |
|---|
| 138 | - fixed stupidity when running on_ac_power |
|---|
| 139 | - fixed problem with screen level |
|---|
| 140 | - cleaned up header |
|---|
| 141 | - added gob generated files to the distribution, no need for gob anymore |
|---|
| 142 | - build fixes to get glade files into the distribution |
|---|
| 143 | - remove use of keysym, and use keycodes directly |
|---|
| 144 | - fixed glade generation bug |
|---|
| 145 | - patch by Radek Doulik <rodo@ximian.com> to avoid flashing dialog |
|---|
| 146 | - make it really not flash, realise the widget before moving it |
|---|
| 147 | - don't dim the screen if ~/.acme.no.dim file exists |
|---|
| 148 | - use a GtkImage instead of a GnomeCanvasItem |
|---|
| 149 | - a single press on power button now does the job |
|---|
| 150 | - patch for better eject button behaviour by Radek Doulik <rodo@ximian.com> |
|---|
| 151 | - remove stuff for the automatic dimming, use XFree's |
|---|
| 152 | - remove necessity of gob2 when building from a tarball |
|---|
| 153 | |
|---|
| 154 | 1.0.3: |
|---|
| 155 | - fix the zombies |
|---|
| 156 | - move the window further down the screen, half-way at the bottom of it |
|---|
| 157 | - add uninstall to the Makefile |
|---|
| 158 | - use AnyModifier with XGrabKey so we grab the keys even when Alt, etc. are |
|---|
| 159 | pressed. |
|---|
| 160 | - a couple of cleanups |
|---|
| 161 | - added a "repeat" to the eject key, so hitting it by accident will not open |
|---|
| 162 | the CD tray anymore :) |
|---|
| 163 | - if screensaver is disabled, don't dim the screen |
|---|
| 164 | - autoconf support |
|---|
| 165 | - gobjectification of the volume and the backlight handling |
|---|
| 166 | |
|---|
| 167 | 1.0.2: |
|---|
| 168 | - make sure the volume doesn't "roll over" |
|---|
| 169 | - fix the version number |
|---|
| 170 | - added a dialog that informs about the permissions of /dev/mixer |
|---|
| 171 | - fixed the fact that keycodes didn't get bound to keysyms anymore |
|---|
| 172 | (causing it not to work *at all*) |
|---|
| 173 | |
|---|
| 174 | 1.0: |
|---|
| 175 | - use oss calls directly instead of scripts |
|---|
| 176 | - catch the problem that would appear if acme was launched twice |
|---|
| 177 | - automatically restart if it gets killed, or for a new session |
|---|
| 178 | |
|---|
| 179 | Requirements |
|---|
| 180 | ------------ |
|---|
| 181 | |
|---|
| 182 | - the gnome2 libraries and gob2 (only if you intend to work on acme) |
|---|
| 183 | |
|---|
| 184 | Installation |
|---|
| 185 | ------------ |
|---|
| 186 | |
|---|
| 187 | 1) ./configure |
|---|
| 188 | 2) make |
|---|
| 189 | 3) make install |
|---|
| 190 | 4) Make sure you have read and write permissions on /dev/pmu and /dev/mixer |
|---|
| 191 | 3) run acme |
|---|
| 192 | |
|---|
| 193 | Voila ! |
|---|
| 194 | |
|---|
| 195 | FAQ |
|---|
| 196 | --- |
|---|
| 197 | |
|---|
| 198 | Q: I'm not seeing the popup window when I change the brightness, what's wrong ? |
|---|
| 199 | A: There are 2 things to check: |
|---|
| 200 | 1) at least a 2.4.18-rc2-benh kernel. |
|---|
| 201 | 2) that the permissions on /dev/fb0 and /dev/pmu make it readable and |
|---|
| 202 | writable for the users that want to use acme. |
|---|
| 203 | |
|---|
| 204 | Q: The keys on my <whatever> keyboard don't do anything, it's supposed to work. |
|---|
| 205 | A: 'insmod evdev' will maybe get the keys recognised. You can also find more |
|---|
| 206 | about some special keyboards here: |
|---|
| 207 | http://www.win.tue.nl/~aeb/linux/kbd/scancodes-2.html |
|---|
| 208 | |
|---|
| 209 | |
|---|
| 210 | Bugs |
|---|
| 211 | ---- |
|---|
| 212 | |
|---|
| 213 | - Hitting the power button many times gets messy |
|---|
| 214 | - need to "just work" on PCs that don't have a Master volume |
|---|
| 215 | - need to use the evdev device on Linux when available |
|---|
| 216 | - acme-properties doesn't update the status/content of the table when gconf |
|---|
| 217 | changes a value |
|---|
| 218 | |
|---|
| 219 | Thanks |
|---|
| 220 | ------ |
|---|
| 221 | |
|---|
| 222 | Thanks to Linas Vepstas <linas@linas.org> for writing idle-timer.c and saving |
|---|
| 223 | me a lot of time and reading (although I removed it ;) |
|---|
| 224 | Thanks to TigerT for mocking up the GUI of the volume dialog, and drawing the |
|---|
| 225 | nifty icons along with Garrett Le Sage. |
|---|
| 226 | |
|---|
| 227 | License |
|---|
| 228 | ------- |
|---|
| 229 | |
|---|
| 230 | GNU General Public License for everything in this package. |
|---|
| 231 | |
|---|
| 232 | Links |
|---|
| 233 | ----- |
|---|
| 234 | |
|---|
| 235 | OSS Mixer documentation: |
|---|
| 236 | http://www.opensound.com/pguide/mixer.html |
|---|
| 237 | |
|---|
| 238 | ALSA 0.5.x Mixer documentation: |
|---|
| 239 | http://www.alsa-project.org/alsa-doc/alsa-lib-old/mixer.html |
|---|
| 240 | |
|---|
| 241 | ALSA 0.9.x mixer "documentation": |
|---|
| 242 | http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/alsa/alsa-utils/amixer/amixer.c |
|---|
| 243 | http://www.alsa-project.org/alsa-doc/alsa-lib/mixer_8c.html |
|---|
| 244 | |
|---|
