NOTICE!

Music Applet has been superseded by Panflute. All active development is taking place there.

Music Applet - Frequently Asked Questions

I compiled and installed Music Applet, but when I run it from the command line, nothing happens. What's wrong?

GNOME panel applets aren't supposed to be run from the command line. After installing Music Applet, right-click on a panel, choose "Add to Panel", and select Music Applet from the list that appears.

I compiled and installed Music Applet, but it's not showing up in the Add to Panel menu. What's wrong?

You installed the applet's .server file, which tells GNOME about the applet, to a directory that isn't being checked. The .server file gets installed to $PREFIX/lib/bonobo/servers, where $PREFIX equals whatever directory you specified as --prefix at compile time (default: /usr/local).

The easiest way to fix this is to add the directory the .server file is to add it to the list of directories that get checked. Edit /etc/bonobo-activation/bonobo-activation-config.xml (or wherever Bonobo keeps its activation configuration on your system) and add this line:

<item>$PREFIX/lib/bonobo/servers</item>

between <searchpath> and </searchpath>, replacing $PREFIX with the appropriate directory. For example, with the default prefix, you would say:

<item>/usr/local/lib/bonobo/servers</item>

Then log out and log back into GNOME to make sure the directory gets re-scanned.

And if logging out and back in still doesn't work, as a last resort you can try rebooting.

Why doesn't the Preferences dialog have sensible defaults? All the fields are blank at first.

This usually happens when you are installing Music Applet as an ordinary user as opposed to root. Although all the files will be installed in whatever directory you specified as the --prefix at configure time, GConf will still try to install the applet's schema file (which has those sensible defaults you're looking for) in a directory only writable by root. If you look at the output from a "make install", you'll probably see GConf's verbose error messages about this.

The workaround is to specify at configure time where to install the schema. Use the configure script's --with-gconf-source option to tell GConf to install the schema in your user's GConf store, instead of the system-wide one. For example, this works for me:

--with-gconf-source=xml:merged:$HOME/.gconf

Of course, GConf has a few different ways to store its data (that's what the xml:merged part is all about), so check what your copy of GConf is using first.

I found a bug in Music Applet that I'm trying to debug. Are there any tricks to help me debug this (or any other) GNOME applet?

The trick is this: run the applet's executable file from the command line before adding it to the panel. When you do this, GNOME will use the instance you started yourself instead of launching a new instance of the applet. There's several ways this helps you when debugging:

Music Applet used to work, but ever since I upgraded Rhythmbox to 0.9.0 or 0.9.1, nothing works anymore! What's wrong?

Short answer: Upgrade to Rhythmbox 0.9.2 later. Then make sure you have D-Bus 0.35 or later installed. Then recompile the applet, if you didn't have D-Bus available when you compiled it originally. Now it should work.

Long answer: There are two IPC mechanisms that Rhythmbox uses. The first is Bonobo, which Rhythmbox 0.8.x uses. The second is D-Bus, which was introduced in Rhythmbox 0.9.0 and enhanced after 0.9.1 was released.

The root of the problem is that the Bonobo interface changed between 0.8.8 and 0.9.0 in a way that broke backwards compatibility, preventing a client program (such as Music Applet) from being able to speak with both versions of Rhythmbox via Bonobo. That's why things stopped working when you upgraded Rhythmbox.

The D-Bus interface added in 0.9.0 was originally pretty limited, and didn't offer the functionality needed by Music Applet. This changed shortly after 0.9.1 was released, making D-Bus a viable option.

Rhythmbox Applet will automatically use the best IPC mechanism available. If Rhythmbox 0.9.2 or later is running and D-Bus is available, it will use D-Bus. If Rhythmbox 0.8.x is running, it will use Bonobo.

Music Applet will never support Rhythmbox 0.9.0 or Rhythmbox 0.9.1. If you're using one of those two releases, you should stronly considering upgrading to a version that has better D-Bus support, especially now that those two releases of Rhythmbox are outdated anyway.