README
changeset 65 35fe20340c91
parent 35 8040903d25de
equal deleted inserted replaced
64:ee64bb096f56 65:35fe20340c91
    13    Drewsen, André Kelpe, and Peter C. Ndikuwera. However unlike WebControl
    13    Drewsen, André Kelpe, and Peter C. Ndikuwera. However unlike WebControl
    14    Greyhound is written entirely in PHP, making it a bit more portable. This
    14    Greyhound is written entirely in PHP, making it a bit more portable. This
    15    script doesn't require an external web server to run, it has a relatively
    15    script doesn't require an external web server to run, it has a relatively
    16    basic built-in (but multi-threaded) server.</p>
    16    basic built-in (but multi-threaded) server.</p>
    17 <p>The script needs a browser with XmlHttpRequest (AJAX) support to work. It's
    17 <p>The script needs a browser with XmlHttpRequest (AJAX) support to work. It's
    18    been tested on Firefox 3.0.1, Safari, and Opera 9.5.</p>
    18    been tested on Firefox 3.0.5, Safari (Mac and Windows), Google Chrome, and
       
    19    Opera 9.5. It does not work (nor, in my opinion, need to work) under Internet
       
    20    Explorer.</p>
    19 <p>It uses Smarty templates so you should be able to customize the HTML to
    21 <p>It uses Smarty templates so you should be able to customize the HTML to
    20    your needs. The template file is /themes/funkymonkey/playlist.tpl. There's
    22    your needs. The template file is /themes/funkymonkey/playlist.tpl. There's
    21    also a theme called iphone which is optimized for use on Apple's touch
    23    also a theme called iphone which is optimized for use on Apple's touch
    22    screen based mobile devices. Now your iPod&reg; can control music other than
    24    screen based mobile devices. Now your iPod&reg; or iPhone&reg; can control music other than
    23    its own :-P</p>
    25    its own. :-P</p>
       
    26 <p>It advertises itself on your LAN using Avahi (if it's available on your computer).
       
    27    All of its control interfaces as well as authentication services are available via
       
    28    JSON, so it should be possible to write a custom (desktop) client. I have a script
       
    29    called grey-pidgin that I use internally that can update your Pidgin status to reflect
       
    30    the song currently playing <b>on your Greyhound server</b>. This means that if you're
       
    31    like me and you have to run your IM from one box and your music from another, you can
       
    32    still show off your music collection to all your buddies. The possibilities for clients
       
    33    are practically endless. I haven't released grey-pidgin because it lacks a GUI, but
       
    34    I may soon. We'll see. It's a bit rough around the edges for sure.</p>
    24 
    35 
    25 <p>
    36 <p>
    26   <b>License</b><br />
    37   <b>License</b><br />
    27   I was originally planning to place this into the public domain but decided to
    38   I was originally planning to place this into the public domain but decided to
    28   make it <b>GPLv2</b> because it uses so many GPLv2 components.
    39   make it <b>GPLv2</b> because it uses so many GPLv2 components.
    32   <b>Known issues</b><br />
    43   <b>Known issues</b><br />
    33   There are a few bugs in Greyhound that I haven't been able to iron out.
    44   There are a few bugs in Greyhound that I haven't been able to iron out.
    34 </p>
    45 </p>
    35 
    46 
    36 <ul>
    47 <ul>
    37   <li>The socket it listens on doesn't get fully closed until about a minute
    48   <li>Sometimes the server freezes up and requests either take forever or
    38       after you interrupt the script. This means that when you hit stop in
    49       partial pages are returned. I know this is due to a lack of experience with
    39       the script manager, you won't be able to start Greyhound again for about
    50       socket programming on my part, but it seems to be aggravated by slow
    40       60 seconds. I checked everything and socket_shutdown() and socket_close()
    51       and/or lossy connections. There's a fix for this but it isn't 100%
    41       are being called properly, so I don't know why it's failing.</li>
    52       reliable yet.</li>
    42   <li>As of version 0.1 alpha 3, the playlist should be updated properly. If
    53   <li>Reloading the configuration doesn't always work automatically yet.</li>      
    43       you change your playlist but don't see the changes show up in Greyhound
       
    44       after about 1-2 minutes, please report it as a bug. Please see
       
    45       <a href="http://forum.enanocms.org/post/14/#p14">this forum post</a>
       
    46       for more information.</li>
       
    47 </ul>
    54 </ul>
    48 
    55 
    49 <p>
    56 <p>
    50   <b>Author</b><br />
    57   <b>Author</b><br />
    51   Dan Fuhry &lt;<a href="mailto:dan@enanocms.org">dan@enanocms.org</a>&gt;<br />
    58   Dan Fuhry &lt;<a href="mailto:dan@enanocms.org">dan@enanocms.org</a>&gt;<br />