Click to download Greyhound v0.1a4

Do I have what I need?

Greyhound's system requirements go off the beaten path a little bit. Many users will have to install some packages before Greyhound will run properly.

  • Amarok 1.4. Greyhound doesn't work on Amarok 2.0 yet. Do not try to run Greyhound under Amarok 2.0, it will not work. This is because in Amarok 2.0, DCOP was replaced with DBUS (along with the rest of KDE4). I'm working on adding Amarok 2.0 support, but there are a few hurdles to jump over (read: a way to get the current playlist).
  • PHP, at least version 5.1.0. The simplest way to check is by typing this at a terminal:
    echo '<?php echo PHP_VERSION . "\n";' | php
  • Apache or another web server is not required
  • PHP's stream functions. The vast majority of Linux distributions bundle these.
  • Support for POSIX functions in PHP. This should not be required, but it allows Greyhound to perform faster because it can respond to multiple HTTP requests simultaneously. Again, bundled most of the time.
  • The GD image library and its associated bindings for PHP. Greyhound uses this to generate album artwork thumbnails. This doesn't usually come bundled with PHP, but it can usually be easily enabled by installing php5-gd under Ubuntu and Debian or php-gd under Red Hat®, Fedora, CentOS, and OpenSUSE.
  • XML support in PHP. Amarok's playlist file is in XML format, so Greyhound needs PHP's SimpleXML library in order to read your playlist. This comes bundled with PHP in most Linux distributions.
  • If Avahi is available on your system, Greyhound will publish itself on your local Avahi/Bonjour™ network.

Still having trouble?

Greyhound checks your PHP installation for all of the requirements above before it loads, so don't worry if you don't know what's installed and what's not. If you've met all the dependencies listed above but Greyhound still won't start, drop by #enano on Freenode for support.

How to install

Greyhound can be installed using the traditional method of installing Amarok scripts from the disk:

  1. In the main window, go to Tools -> Script Manager
  2. Click Install Script
  3. Navigate to the file you downloaded
  4. Double-click, sit back, wait a few seconds
  5. Hit Start and navigate to http://localhost:7447/
Categories: (Uncategorized)