Amdroid – Ampache on your Android Phone

May 12, 2009

It’s official! A native Ampache client for the Android phones (Amdroid) written by Kevin Purdy is now on the Android Market!!. If you’ve got an android phone and would like to be able to stream music from your ampache instance anywhere go get it now! The current stable release, 3.5, is required for the use of Amdroid. Check it out!!!

You can find Ampache-3.5 on my ppa


Amarok + Ampache Backend

April 15, 2009

Taking advantage of Ampache’s XML-API you can browse and play from one or many remote Ampache catalog(s) directly from Amarok.



Ampache Setup Instructions

In order to use the API we will need to enable and configure the Ampache Access Control Lists. This requires Admin access to your Ampache installation and access to the /etc/ampache/ampache.cfg.php file. Ampache defaults to a DENY FROM ALL behavior so you will need to setup your ACL’s before you enable the Access Control in your Config file. In the below example all of the computers running Amarok are on your local network (

New Installs of Ampache (3.5.x) will come with 4 default ACL’s to make configuration easier


If your ampache does not already have these ACL’s please see Configuring Access Control Lists for more information about how to create them.

Creating the Needed ACL Entries

We need to allow API access to Ampache from our local network. To do this go to the Admin tab and then click on Show Acls. Find Add API / RPC Host and click on it.

Name your ACL Entry, in this example I’ve called it “My Network” There are three choices for the type of ACL to create. The default will allow you to access Ampache’s catalog using Amarok but it will not allow you to login through the web interface. If you want API + Streaming + Web Interface access pick RPC + All under type.


You’ll notice these first two ACL’s do not have a Key. Key’s are only required for XML-RPC communication between Ampache servers. Your users will use their Web Interface Usernames and Passwords to access the API. Now that we’ve created a few ACL’s we need to make sure that Access Control is enabled. Open up your /etc/ampache/ampache.cfg.php in a text editor and find the access_control line and enabled it as seen below

; Use Access List
; Toggle this on if you want ampache to pay attention to the access list
; and only allow streaming/downloading/xml-rpc from known hosts by default
; xml-rpc will not work without this on.
; DEFAULT: false
access_control = "true"

Log out of your Ampache instance, and then log back in. If that works then go ahead and try playing some music. If either one of these things fails disable Access Control and double check your ACL entries. If you still aren’t sure why it’s failing then Enable Logging and see what the Logs report.

Configuring Amarok

At this point we assume that you have Amarok2 installed and working correctly.

Enable And Configure Service

Go to Settings and then Services. Make sure the Ampache Service is enabled.


and then click Settings button on Ampache plugin. Enter the details for your server and click add.


Ampache Service Settings

  • Name – This is an internal name for Amarok, up to you.
  • Server – This is the fully qualified address for your Ampache server including the http://. For example, a valid server would look like
  • Username – This is your username to the Ampache web interface. If you specified a User in your RPC ACL then this username must match that specified in the ACL.
  • Password – This is your password to the Ampache web interface

Ampache-3.5 (due out early March, or so) will be able to stream video. I will explain how to stream your favorite content to Rhythmbox or Totem using Python-Coherence (UPnP).

Ampache-3.5-svn2029 (beta2) can be found in my PPA
Additional Ampache Resources

A Special Thanks

April 14, 2009

I would like to send out a special thank you to Andreas Moog, James Westby, Nathan Handler, Sebastien Bacher, Richard Johnson and Sander Jonkers, for helping to fix #338963 and #352653 while I attended my uncles funeral.  If I ever make it to UDS the beer (or your favorite beverage) is on me.

You guys ROCK

Charlie Smotherman

PS. If I have forgotten anyone please forgive, it was not intentional.

Off The Grid

April 2, 2009

Due to a death in the family I will be off the grid for about a week or so. I will probably not be back before April 9 which is Final Freeze. So would someone from the MOTU community please step up and help me out by looking after bugs #352653 and #338963 as I will be unavailable to look after them.

Thank You
Charlie Smotherman

Ampache-3.5-Beta1 Released

March 17, 2009

In the spirit of my previous post, 3.5-Beta1 has been released. This release initiates a string freeze for the 3.5 branch. It also includes new API functionality for Democratic play and Localplay, a Democratic Play configuration wizard, Improved Video browsing, changes to make album art more compatible with DLNA devices. There are also numerous minor little tweaks / fixes.

The goal is to have a Stable version released in 6 weeks, with at least one more beta before then. There will be no changes made to the strings to make it easier for the translators to complete their work. If you are interested in helping with the translations please visit

The Lonely Speaker

February 19, 2009

The guys at released some more Ampache hotness today. Retrievil Knievil let loose the “Lonely Speaker” theme.


grab the tarball, unpack it, and then place it in



Coming Soon Ampache-3.5-Alpha2

February 14, 2009

Hello Planet,

The big news today is the expected release of Lenny. WoooHooo! And speaking of Lenny, it will be the first stable release of Debian with Ampache included in it.  Ampache has been in Ubuntu since Hardy 8.04. I have, what I consider a rather large music collection, and Ampache is by far the best solution that I have found to manage and stream my music to me anywhere. Thanks to Kevin Purdy and his porting of Quickplay (which he also wrote) you can now stream your Ampache music collection to your Android Phone. Quickplay makes use of Ampache’s new XML-API and ACL’s to connect to and communicate with your Ampache server. Quickplay is written in python, and is a light mp3 player frontend for your Ampache server (great for older hardware).  The XML-API also allows you to use Amarok2 (media player) and Coherence (python UPnP framework) with Ampache. Quickplay is currently up on REVU and

Vollmer, Ampache’s Lead Dev has informed me that he is pushing to have Ampache-3.5-alpha2 released in the next couple of weeks or so. Some of the new features which will be included into the alph2 release will be improvements to the XML-API, the addition of an ACL creation wizard, IPv6 support, and some video support (which is very much still in it’s infancy) but it’s a start, and momo-i has been all over translations so our international users should see an improvement.

Well it is Valintines Day, so I better get off this thing and go spend some time with my sweetheart.

Happy Valintines Day everyone.

Hello world!

January 25, 2009

Welcome to This is your first post. Edit or delete it and start blogging!