The amaroK bindings for Python

This is a fairly complete amaroK remote control class, extremely useful for amaroK scripts and other applications. Basically, you can remote control amaroK by calling methods from an amaroKProxy instance. In addition, it implements the Observer/Observable pattern so you can deal with events in an object-oriented, loosely coupled fashion. Even better, you can call an amaroKProxy instance’s collection.getSong(filename) method to get a Song object, with track, artist, album name, and elegant “Artist - Track name” strings.

Nearly all DCOP functions for communication with amaroK are implemented.

It will use KDE bindings’ DCOP module if available, otherwise it will default to the command-line DCOP dcop command, through python-commandsplus. If using KDE bindings, a slave process is spawned, and IPC is used to marshal and unmarshal function calls, so as to not contaminate your application’s sys.modules with KDE’s Python modules. This all happens automatically in the background.

Resources

Licensing

This software is under the GPL. See the file COPYING for licensing information. Contact me if you need to license this software under a different license.

Getting help

Help for this software is available in several forms. Here are the rules:

  • E-mails or posted comments with bug reports, patches, suggestions or contributions of any kind will be received by me in good faith, and I will, in time, incorporate all submitted improvements, in any form, to the software.
  • This software is delivered to you without warranty of any kind, as recognized by the GNU General Public License.
  • Special requests, such as customization, third-party licenses, development of large features, or requests which require software engineering to be applied, will be performed by me, for a fee. If you’re attracted to my engineering skills, wait until you see my rates. After all, living on a Third World country has its advantages. Let me know if you’re interested.