Skip to main content
Help us improve Python packaging – donate today!

a simple web-based, multi-platform music/mp3 player written in python, HTML/CSS and javascript

Project Description


blast is a simple web-based, multi-platform music/mp3 player written in python, HTML/CSS and javascript.


the easiest way to install blast is by using python setuptools “easy_install” command:

$ easy_install blast

you can also install using ez_setup, pip or installing the package directly using

$ python install


$ cd ~/Music
$ blast

then you can connect to the blast frontend at http://localhost:5000 (or via IP if you’re binding externally with -x).

NOTE: if you use flashblock, make sure to whitelist your blast server (otherwise the URLs will simply open as if you clicked them)

blast is primarily keystroke driven. here’s a list of the available key commands:

v         Play
c         Toggle Pause
x         Stop
j k       Next / Previous Track (Google Reader style)
n         Next Track (same as j, Google Reader style)
b z       Next / Previous Track (Winamp Style)
, .       Reverse or Skip Ahead 1 second
{ }       Reverse or Skip Ahead 5 seconds
[ ]       Reverse or Skip Ahead 30 seconds
0         Reset to 0 position
s         Toggle Shuffle
m         Toggle Mute
?         Toggle Help
r         Randomize List
d         Debug Mode

when in doubt, you can also hit the “?” key in the UI to see this same help information.

in addition to key commands, you can click on tracks to play/pause and seek around in tracks by clicking on the duration bar.

platform support

blast is written with portability in mind. currently the server (the blast CLI) should run anywhere that python can be installed (pretty much everywhere) and the UI should run in most browsers. the UI is also known to work under iOS (e.g. for iPhone/iPad playback) - which means you can stream your large computer-based library to your iOS device over wifi.

tested/verified platforms

  • blast server
    • OSX python
    • Cygwin (Windows) python
    • Linux python
  • front-end/UI
    • OSX chrome
    • OSX safari
    • OSX firefox
    • iOS safari (iPhone/iPad)
    • Windows chrome
    • Windows firefox

untested, but might work on

  • Windows python (non-cygwin) and/or ActiveState python
  • Other UNIXs (BSD, Solaris etc) python
  • Windows Internet Explorer
  • Opera
  • Android

open source

blast currently leverages the following open source components to speed development:


blast is open sourced under a simple BSD license. you can find the source code on github:

Release history Release notifications

This version
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
blast-0.3.0.tar.gz (183.3 kB) Copy SHA256 hash SHA256 Source None Aug 10, 2012

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