Sunday, August 29, 2004
Freshmeat
Sourceforge

IMWheel

Versions
Stable: Yes! :D
Development: 1.0.0pre12

The mysterious and tempermental configuration helper window

Announcements

Smash the bugs! - or else...
Click here for Support!
Get the 1.0.0pre12 release below, or better yet cvs!
  • There are new features (auto-repeat) that have not been tested (and that one is not even in the supplied imwheelrc...).
  • A full report entails a log of your complete "imwheel -d -D (insert your options here)" run, with anything you did that you want me to see highlighted!
    State your platform (linux? bsd? what flavor/distro?)
    Also state your window manager, X Server, who supplied imwheel (where did yours come from?), and version numbers for all of them. Any compilation errors: from source tar.gz or cvs, state your gcc and gnu make versions; from cvs, also state your autotool versions.

    Try to include all pertinent information!

    Thank you, if in a few months I have no reports, I'm going to start finishing 1.0.0 (meaning finish the docs, manpage, and releasing). After 1.0.0 is released, only bugfixes will be accepted, as I will move on to other projects, perhaps XWheel will finally see light of day...

    IMWheel 1.0.0pre12 Released(* Security Fix *)
    imwheel-1.0.0pre12.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. No docs updated.
    To tell you the truth, there's not a whole lot of reason to installing imwheel as SUID root anymore. Expect that to disappear in the new release...unless someone can convince me otherwise.
    slackware-current package

    IMWheel 1.0.0pre11 Released
    imwheel-1.0.0pre11.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. No docs updated, except the Changelog.
    slackware-current package

    IMWheel 1.0.0pre10 Released
    imwheel-1.0.0pre10.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. No docs updated, except the Changelog.
    slackware-current package

    IMWheel 1.0.0pre9 Released
    imwheel-1.0.0pre9.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. No docs updated, except the Changelog. I highly suggest renovating your imwheelrc since the default action is now to repeat the same button to the application! (see the DEVELOPMENT.txt and my imwheelrc below)
    slackware-current package

    IMWheel 1.0.0pre8 Released
    imwheel-1.0.0pre8.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. No docs updated, except the Changelog.

    IMWheel 1.0.0pre7 Sorta Released
    imwheel-1.0.0pre7.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. No docs updated, except the Changelog.

    IMWheel 1.0.0pre6 Released
    imwheel-1.0.0pre6.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. No docs updated, except the Changelog.

    IMWheel 1.0.0pre5 Released
    imwheel-1.0.0pre5.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. No docs updated, except the Changelog.
    UPDATE: released a fixed package, as the old one missed stuff

    IMWheel 1.0.0pre4 Released
    imwheel-1.0.0pre4.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. No docs updated, except the Changelog.

    IMWheel 1.0.0pre3 Released
    imwheel-1.0.0pre3.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. No docs updated, except the Changelog.
    UPDATE: The GPM_NO_DOC error/warning/whatever is fixed (hopefully). Redownload the archive for the fix.

    IMWheel 1.0.0pre2 Released
    imwheel-1.0.0pre2.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. Only the manpage is up to date. The readme is now depreciated, because it's silly to keep docs up to date in two places.

    IMWheel 1.0.0pre1 Released
    imwheel-1.0.0pre1.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. Only the manpage is up to date, still, I think!

    IMWheel on IRC
    Go to irc.freenode.net #imwheel and I may be there!

    IMWheel 0.9.9 Released
    imwheel-0.9.9.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information. Only the manpage is up to date!

    (NOTE: Some News has been lost due to a hard drive crash...)

    IMWheel 0.9.9pre2 and below have a security hole
    The first line of any file can be given in debug output if imwheel is installed as suid-root. Basically any user can symlink their $HOME/.imwheelrc to any file and dump the first line. This could allow the first account in the shadow password file to be cracked. The fixed version, imwheel-0.9.9pre3.tar.gz, is now available in the all files directory. Please read DEVELOPMENT.txt for my comments and information on prereleases.

    IMWheel 0.9.8 and below have a security hole
    TESO and zero knowledge have released the advisory that imwheel has a hole. This affects only SUID imwheel or people who have a SUID wrapper to run imwheel. Please patch your imwheel 0.9.8 source with this patch to fix it. The next version of imwheel, version 0.9.9, already is fixed, but is not ready for release. Thanks go out to Francis Galiegue <francis@mandrakesoft.com> for giving me the patch. Most people just pointed me to the problem statement, which gave me no clue as to how to fix it.

    XFree86 4.0 usage with GPM and/or JAM
    UPDATE:XFree 4.0a (an internal working product of the xfree86 group, is said to have fixed this problem. I have submitted a request to join the xfree86 organization. If I get such approval, I will make sure that imwheel, gpm, and future XFree86 releases are compatible. Meanwhile use the XGrabButton method to get things done and avoid using gpm/jam type programs.
    XFree86 4.0 has a broken mouse driver in the respect that it fails to work with FIFOs. Because of this problem, only Method #1, the XGrabButton method, will work. You should disable GPM or at least NOT run it with the "-R" nor "-W" arguments. If your mouse works with the XServer's mouse driver and you can use the ZAxis wheel to button mapping, then run IMWheel without the -W/--wheel-fifo option. Using -k will have no effect, and you may see a warning, but it is just a warning, not an error. It will complain that another imwheel process may be running but that we don't do anything with that, because we don't need to!
    I am looking into the reasoning behind messing the FIFO ability up, and I have looked into the source code for XFree86 4.0, and I think it is because they try to do more interaction with the mice on initialization, but the problem is that FIFOs are one way communication channels, thus no FIFO mouse emulation will work because it cannot send the proper responses back to the driver. So we'll have to wait and see where this goes. Meanwhile I'm also considering making a replacement mouse.so module to fix what they broke.

    VNC Wheel support
    Here's a link for mouse wheel support in VNC for the Microsoft Windows version of VNC. (this link is to avoid any questions to me about it). IMWheel can then be used on the UNIX VNC server through a Windows VNC session to that UNIX machine.

    Description

    In short, it's a program to use that good ol' Microsoft Intellimouse Wheel under XFree86 (and other servers) on Linux (others as well, including 4+ button mice!). So use this program and make Microsoft hardware useful for another OS! I hope this thought makes Billy Goats shiver ;)

    IMWheel also supports stick type mouse with all directions of motion. GPM has been altered to support stick mice as well. IMWheel has been proven to work for many people and is the choice of a lazy generation (downloading and compiling/installing is excepted in this clause). I'm lazy too...so why the heck did I do all this code! Because I like too...and besides who can find X application resource settings to configure the wheel for everything?

    IMWheel supports Linux and FreeBSD.
    Linux users should get the regular archive.
    FreeBSD users should configure imwheel not to use gpm.

    Your suggestions have been taken too heart and I added support for as much as suggested as possible. If you have another suggestion don't hesitate to email it to me. They will be integrated into jam/xwheel.

    Current Archives

    This is a pre-1.0 version, so report all bugs!

    Don't forget to merge the new imwheelrc with your own!!! get my imwheelrc file here.

    Full

  • imwheel-1.0.0pre12.tar.gz 182KB

    Parts

  • There will be no imwheel-X.X.X.nogpm.tar.gz, configure gpm out yourself!
  • This patch is not in sync with some of the minor code fixes in the imwheel archives, which are only due to compiler updates.
  • gpm-1.19.3.imwheel.patch.gz 13KB

    Get the pre-release versions from the following link, using a pre-release version is the best way to get new features and bug fixes fast. It also helps me if you report on the status of your pre-release experiences, good and bad. This helps determine the readiness of the pre-release to become a full release. I try not to pre-release or release buggy versions, but I can only confirm my experience through you, the user! Enjoy, but tell me how much! (It's only an E-Mail, geez!)

  • All files, old and new!

    CVS anonymous read-only access

  • GPM is not in the CVS archive, for that either download the real gpm and patch it, or download the current release or development version of imwheel and compile it in there. You can configure gpm and avoid imwheel if you like when you use the imwheel archives to get it.

        Instructions
    1. mkdir a directory to check the files out into, and cd into it.
    2. Run cvs -d :pserver:anonymous@jonatkins.org:/usr/local/cvsroot/imwheel login
      press enter at the password prompt, there is no password.
    3. Run cvs -d :pserver:anonymous@jonatkins.org:/usr/local/cvsroot/imwheel co .
    4. configure and make as usual (read README and INSTALL)

    Third Party Archives (Versions Unknown)

  • Slackware packages supplied by package maintainers at LinuxMafia.org
    Slackware is my distro of choice...it rocks!
  • RPM & tar.gz archives supplied by Nick Koston <bdraco@darkorb.net>
  • RedHat 6.1 Binary & Source RPMs from RedHat's ftp.cdrom.com mirror, the powertools dir!
    They have i386, Alpha, and Sparc Binaries...Although I don't think the Sparc one is of any use at all, is it?
  • Debian RPMs & required packages from Debian's developer pages.
    That's right, Debian is working imwheel directly into their distribution!
  • FreeBSD also has some port info here.

    Text Files

  • ChangeLog
  • BUGS
  • NEWS
  • README
  • imwheel manpage

    Distributions Apparently including IMWheel

    A short note on distributions including imwheel. Most distributions remove my version of gpm from the imwheel package. I do not support the regular gpm, nor do I support anything in the current incarnation of gpm I have, except for the wheel functionality and the extra mice. If you were given the short end of the stick because you trusted a distribution...then get the latest tar.gz file from above here, and live in the real world, where progress comes in a little work but better payoffs.

    Other Places Where IMWheel Is Mentioned

    English
  • Steven K. Baum's Linux Software Encyclopedia
    French
  • Trucs et astuces
    German
  • Verwenden einer Wheel-Mouse unter Linux

    I got a kick out of reading the bad translations at Babelfish!

    Links worthy to mention

  • How to get side buttons working in XFree86
  • (another) How to get side buttons working in XFree86
  • imwheel howto for linux and a logitech mx500 or mx700