AmaroK XUL Remote

Control AmaroK from any Firefox browser on your network.

This AmaroK script embeds a Firefox extension and a HTTP server


FEATURES:
- player manipulation: play, pause, stop, next, previous, seek, volume
- auto refreshing playlist view, plays a given track on click, can delete tracks
- collection browser with filtering, ordered by artist/album
- drag and drop tracks, album and artists to the playlist
- cover view for current track
- access restricted by login/password/IP address

The project developpement is now hosted on: http://sourceforge.net/projects/xul-amarok/
please go there to report bugs or wishes.


REQUIREMENTS:
- python >= 2.3
- pyqt (python QT bindings)
- AmaroK >= 1.4.3
- Firefox >= 1.5

INSTALL:
- Download the archive, then install and run it with AmaroK script manager
- On the first launch, you will be prompted for some parameters:
- interface(optional): the IP adress of your network interface the server will listen on (empty means all)
- port (required): you can leave 8888 as a default
- login/passwd (optional): if you wish to restrict access
- on any host on your network, launch firefox, go to http://amarok_host:8888 , and install the extension
- restart firefox
- launch "AmaroK remote" in the firefox "Tools" menu.
- set the options of the extension to match those on the server

NOTES:
If you get troubles with the configuration interface, you can use this sample xulremote.ini file:

[Debug]
debugajax = off
debugdcop = off

[HttpAuth]
passwd =
login =

[Hosts]
allowed =

[Listen]
interface = 127.0.0.1
port = 8888

of course replace 127.0.0.1 with the IP you want to listen on.

1.0 - 2007-05-24
- new option to open the remote in a tab
- disable launch by KDE session manager (closes #1614228)

0.9b - 2007-04-30
minor fixes:
- Default server IP address to 127.0.0.1
- No more client hostname lookup
- new window for cover display

0.9a - 2006-11-03
- fix bug [ 1585368 ] Wrong file name transmitted

0.9 - 2006-10-21
- feature: context menus on collection and playlist
- feature: restrict connections from an IP addresses list
- works with firefox2, Amarok 1.4.3
- extension code rewrite

0.8 - 2006-04-30
- feature: delete tracks from playlist (press delete key)
- better playlist refreshing behaviour
- more playlist columns
- bugfix: collection browser now works fine with sqlite
- bugfix: more robust handling of unicode/non-unicode locales

0.7a - 2006-03-01
- bugfix: non resolved IPs could not connect
- no changes to extension

0.7 - 2006-02-25
- login/password authentication (HTTP Basic)
- big changes on the script side, now a pyqt application
- configuration interface
- always use dcop CLI, pydcop no longer required
- unicode bugfixes
- no more javascript warnings
- debugging possibilities, see xulremote.ini

0.6 - 2006-02-12
- unicode support
due to some issues with unicode and pydcop, the command line dcop is used for some actions

- reworked communication layer
uses AJAX instead of XML-RPC, which was designed for ascii

- sliders for seek and volume
adapted from foxytunes (thanks to Alex Sirota)

- amarok message on new connections
- cover view

0.5 - 2006-02-05
- support for firefox 1.5.0.1

0.4 - 2005-10-16
- drag and drop now works with albums and artists
- support for special characters

0.3 - 2005-09-10
- support for firefox 1.5 (won't work anymore with 1.0.x)
- use the new firefox preferences system
- works with amaroK 1.3
- better layout
- collection browser handles compilations
- dropped the Dynamic mode switch

0.2 - 2005-05-03
- Add a party mode enable/disable switch
- corrected bugs in the collection browser
- some cleanups