WordPress.org

The WordPress plugin and widget.

• Unpack the archive.

• Copy sgwhatsplaying.php and widget.php to a sgwhatsplaying directory in your WordPress plugins directory. Or just unpack the archive under your plugins directory - all the python stuff will be ignored.

• Activate the plugin.

• Goto Options->SGWhatsPlaying, and set the "password". Don't use a password you use for any real access - this is just key to keep random losers from screwing with your blog, and is not secure in any real way.

The updater program

• Unpack the archive on the machine with access to your music player.

• If you don't have Python installed, install it.

• (OPTIONAL) Run python setup.py install to install the program and module into your regular Python site directories. But you can skip this: sgwpupdate.py will run fine out of any directory.

• Copy sgwpupdate.conf to your $HOME/.sgwpupdate.conf, or /etc/sgwpupdate.conf.

• Edit the configuration file to set password and blog in the sgwpupdate section, and (if using MPD) mpdhost and mpdport in the sgwpmpd section. See later in this document for complete configuration documentation.

• Run sgwpupdate.py --debug to test. If you're not using MPD, you can test with sgwpupdate.py --debug --title 'Some Song Title' --artist 'Some Artist' --album 'Album Name' --state 'play'.

• To start in daemon mode, run sgwpupdate.py --daemon.

• The file sgwupdate.ini is a Debian-compatible initrc file. Copy it to /etc/init.d/sgwpupdate and create the desired links in /etc/rc?.d to have sgwpupdate.py automatically start on system boot.