
<div align="center">
	<h2>AmaroK XUL Remote 1.0</h2>
	<p>Control AmaroK from any Firefox browser on your network.</p>
	<p>This AmaroK script embeds a Firefox extension and a HTTP server</p>
</div>

<div><h4>INSTALL</h4>
<ul>
	<li>Download the archive, then install and run it with AmaroK script manager</li>
	<li>You can also install find it in "Get more scripts" in AmaroK script manager</li>
	<li>On the first launch, you will be prompted for some parameters:<br />
		<b>interface</b> (optional): the IP adress of your network interface the server will listen on (empty means all)<br />
		<b>port</b> (required): you can leave 8888 as a default<br />
		<b>login/passwd</b> (optional): if you wish to restrict access
	</li> 
	
	<li>on any host on your network, launch firefox, go to http://&lt;hostname&gt;:&lt;port&gt; , and install the extension</li>
	<li>restart firefox</li>
	<li>launch "AmaroK remote" in the firefox "Tools" menu.</li>
	<li>set the options of the extension to match those on the server</li>
</ul>
</div>

<div><h4>REQUIREMENTS</h4>
<ul>
	<li>python &gt;= 2.3</li>
	<li><b>pyqt</b> (python QT bindings)</li>
	<li>AmaroK &gt;= 1.4.3</li>
	<li>Firefox &gt;= 1.5 or 2</li>
</ul>
</div>

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


<div><h4>CHANGELOG</h4>
<ul>
	<li><b>1.0 - 2007-05-24</b><br />
	- new option to open the remote in a tab<br />
	- disable launch by KDE session manager (closes #1614228)
    </li>
    
	<li><b>0.9b - 2007-04-30</b><br />
    - minor fixes:<br />
       Default server IP address to 127.0.0.1<br />
       No more client hostname lookup<br />
       new window for cover display
    </li>
    
	<li><b>0.9a - 2006-11-03</b><br />
    - fix bug [ 1585368 ] Wrong file name transmitted
    </li>

	<li><b>0.9 - 2006-10-21</b><br />
	- feature: context menus on collection and playlist<br />
	- feature: restrict connections from an IP addresses list<br />
	- works with firefox2, Amarok 1.4.3<br />
	- extension code rewrite
	</li>
	
	<li><b>0.8 - 2006-04-30</b><br />
	 - feature: delete tracks from playlist (press delete key)<br />
	 - better playlist refreshing behaviour<br />
     - more playlist columns<br />
	 - bugfix: collection browser now works fine with sqlite<br />
	 - bugfix: more robust handling of unicode/non-unicode locales
	</li>

	<li><b>0.7a - 2006-03-01</b><br />
	- bugfix: non resolved IPs could not connect<br />
	- no changes to extension
	</li>

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

	<li><b>0.6 - 2006-02-12</b><br />
	- unicode support:<br />
		due to some issues with unicode and pydcop, the command line dcop is used for some actions<br />
	- reworked communication layer<br />
	- sliders for seek and volume, adapted from foxytunes (thanks to Alex Sirota)<br />
	- amarok message on new connections<br />
	- cover view

	<li><b>0.5 - 2006-02-05</b><br />
	- support for firefox 1.5.0.1
	</li>
	
	<li><b>0.4 - 2005-10-16</b><br />
	- drag and drop now works with albums and artists<br />
	- support for special characters
	</li>
	
	<li><b>0.3 - 2005-09-10</b><br />
	- support for firefox 1.5 (won't work anymore with 1.0.x)<br />
	- use the new firefox preferences system<br />
	- works with amaroK 1.3<br />
	- better layout<br />
	- collection browser handles compilations<br />
	- dropped the Dynamic mode switch
	</li>
	<li><b>0.2 - 2005-05-03</b><br />
	- Add a party mode enable/disable switch<br />
	- corrected bugs in the collection browser<br />
	- some cleanups
	</li>
</ul>
</div>



<div><h4>TODO</h4>
Goals for 1.0:
<ul>
	<li>Have an access list for allowed hosts, editable from amarok script manager</li>
	<li>remove tracks from playlist: a DCOP call is available in 1.4-SVN</li>
</ul>

(much) later:
<ul><li>use remote XUL instead of an extension (custom treeviews don't work remotely yet)</li></ul>
</div>

<p><b>LICENSE</b>: GPL V2</p>
<p><b>AUTHOR</b>: Matthieu Bedouet ( mbedouet at gmail dot com )</p>

