This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

pumila is an image-to-sound converter. It transforms variations in color, brightness, saturation and opacity into different sounds.


pumila is free software under the terms of the GNU Affero General Public License version 3 (or any later version). This is version 0.1.0 of the program.


The author of pumila is Niels Serup. Bug reports and suggestions should be sent to for the time being.


Way #1

Get the newest version of pumila at or at

Extract pumila from the downloaded file, cd into it and run this in a terminal:

# python3 install

Examples are available in the examples directory.

Way #2

Just run this:

# pip-3.1 install pumila

Note that this will not make any examples available.


Python 3.1+

  • For DEB-based distros (Trisquel, Debian, etc.): run apt-get install python3
  • For RPM-based distros: run yum install python3
  • For other distros: do something similar or get it at


Under normal circumstances, you would do something like this:

  • For DEB-based distros: run apt-get install python-pygame
  • For RPM-based distros: run yum install pygame
  • For other distros: do something similar or get it at

However, the PyGame 1.9.1 release doesn’t work perfectly with Python 3, which means you’ll have to compile PyGame from svn yourself, see


It’s best to get the newest version from — pumila works with v0.15, but earlier versions haven’t been tested very much.


What affects what:

       bottom <-- frequency --> top
       bright <-- amplitude --> dark
no saturation <-- amplitude --> full saturation
  transparent <-- amplitude --> opaque

Wave types:

hue 0 to 90,        red to ······ chartreuse: sine to triangle
hue 90 to 180,      chartreuse to cyan:       triangle to square
hue 180 to 270,     cyan to ····· purple:     square to sawtooth
hue 270 to 360 (0), purple to ··· red:        sawtooth to sine


As a command-line tool

Run pumila to use it. Run pumila --help to see how to use it.

As a module

To find out how to use it, run:

$ pydoc3 pumila

And also:

$ pydoc3 pumila.core
$ pydoc3 pumila.primitives

And so on.


There are a few examples in the examples directory. All example images are available under the Creative Commons Zero 1.0 license.


pumila uses Git for code management. The newest (and sometimes unstable) code is available at:

$ git clone git://

This document

Copyright (C) 2011 Niels Serup

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This file is offered as-is, without any warranty.

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pumila-0.1.0.tar.gz (685.0 kB) Copy SHA256 Checksum SHA256 Source Aug 12, 2011

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting