Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

a minimalistic mp3 player

Project description


This program was written out of frustration with larger music players. Pretty much all I’ve ever wanted out of a music player was one that played random albums by picking a random artist, then picking a random album, then playing that album, then picking another random artist.

For some reason,I’ve never run into a music player that played random albums that way, which led to me often ending up having to skip past multiple albums by a particular artist, especially when the artist has a large discography.

While I call this player minimalist, that’s not set in stone – I’ll probably add scrobbling capability and other various features. These features will, however, be ones that I find useful. I highly doubt this app will ever be incredibly bloated.


Pyrana WILL NOT WORK if you do not install what is outlined below.

You’ll need PyGTK, available from . (last version I teseted on was 2.22 ) Its throws a big old warning if you try to install it via setuputils, and I’ve never actually had it successfully install that way. On the plus side, your package manager probably provides a package, if it’s not already on your system.

You’ll also need to install python-notify >= 1.1, available from . I’ll probably try to move away from this dependency in the near future.

ALSO, you’ll need to install gst-python >= 0.10.0, available from . This is another dependency I’ll be most likely removing at some point…

Your music directory has to be arranged in a artist/album heirarchy. Something like:

Underpowered Umpires/
Third Strike/
Robby and the Revoltors/
William S. Burroughs Was My Father/


Pyrana stores its configuration in ~/.pyrana/pyrana.cfg. It currently accepts 3 options:

use_notify :: whether or not to use libnotify to pop up little messages about what’s playing, defaults to True

music_dir :: where your music is located, defaults to ~/music

seen_file :: where to store the file containing hashes of seen songs

update_pidgin_status :: whether you want Pyrana to update your pidgin status for you when a track updates, defaults to True


Credit is due to Shel from for the sweet tray icons. Thanks, Shel!


Questions? Comments? Suggestions? Hate-mail? Hit me up at

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
Pyrana-2.0.0-py2.7.egg (33.6 kB) Copy SHA256 hash SHA256 Egg 2.7 Jul 10, 2011
Pyrana-2.0.0.tar.gz (17.1 kB) Copy SHA256 hash SHA256 Source None Jul 10, 2011

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page