README
author Dan
Tue, 23 Sep 2008 23:26:18 -0400
changeset 50 1b4288399b1f
parent 35 8040903d25de
child 65 35fe20340c91
permissions -rw-r--r--
Added graphical configuration, at this point only for the grey theme but others will follow soon. (This has been nearly done for two weeks or more but was on hold due to the bugs with multithreading)

<div align="center">
  <b>Greyhound</b><br />
  A PHP-based web interface for Amarok<br />
  <br />
  &gt;&gt;&gt; <b>To access this script once started navigate to: &lt;&lt;&lt;<br />
  &gt;&gt;&gt; <a href="http://localhost:7447/">http://localhost:7447/</a> &lt;&lt;&lt;
</div>
<p>I wrote Greyhound because of some issues I was having with other web
   interface scripts freezing and not working right. Greyhound is my first
   shot at writing Amarok scripts but it seems to work pretty well.
   </p>
<p>Greyhound's interface is based on the WebControl script by Jonas Christian
   Drewsen, Andr&#0233; Kelpe, and Peter C. Ndikuwera. However unlike WebControl
   Greyhound is written entirely in PHP, making it a bit more portable. This
   script doesn't require an external web server to run, it has a relatively
   basic built-in (but multi-threaded) server.</p>
<p>The script needs a browser with XmlHttpRequest (AJAX) support to work. It's
   been tested on Firefox 3.0.1, Safari, and Opera 9.5.</p>
<p>It uses Smarty templates so you should be able to customize the HTML to
   your needs. The template file is /themes/funkymonkey/playlist.tpl. There's
   also a theme called iphone which is optimized for use on Apple's touch
   screen based mobile devices. Now your iPod&reg; can control music other than
   its own :-P</p>

<p>
  <b>License</b><br />
  I was originally planning to place this into the public domain but decided to
  make it <b>GPLv2</b> because it uses so many GPLv2 components.
</p>

<p>
  <b>Known issues</b><br />
  There are a few bugs in Greyhound that I haven't been able to iron out.
</p>

<ul>
  <li>The socket it listens on doesn't get fully closed until about a minute
      after you interrupt the script. This means that when you hit stop in
      the script manager, you won't be able to start Greyhound again for about
      60 seconds. I checked everything and socket_shutdown() and socket_close()
      are being called properly, so I don't know why it's failing.</li>
  <li>As of version 0.1 alpha 3, the playlist should be updated properly. If
      you change your playlist but don't see the changes show up in Greyhound
      after about 1-2 minutes, please report it as a bug. Please see
      <a href="http://forum.enanocms.org/post/14/#p14">this forum post</a>
      for more information.</li>
</ul>

<p>
  <b>Author</b><br />
  Dan Fuhry &lt;<a href="mailto:dan@enanocms.org">dan@enanocms.org</a>&gt;<br />
  If you like this script be sure to check out my other projects:
    <a href="http://enanocms.org/">Enano CMS</a> and
    <a href="http://lifecodeidiocy.enanocms.org/">my blog</a>.
</p>