User Guide

Concepts of the application

Pumilio is built to manage soundfiles, therefore, the unit in which it works at is the soundfile (wav, flac, mp3, etc.). Each soundfile is assigned to a collection, which could be a project, a year, or any other way to organize the data in a way that makes sense to the group.

Main menu (Application homepage)

Note: Depending on the options selected by your administrator, some of the following may not appear.

Browse sound archive

Side-to-side comparison

Tag Cloud

Sample the archive

Upload a file

Add files

Users that are listed as administrators can add files to the archive using several ways. (To add files using other options, even from other computers, check the Auxiliary Scripts)


There are three categories of users: guests, regular users and administrators.

Browsing the archive

There are several ways to browse the archive:

All those ways result in a page with similar options, so they are explained below together.

On the top-right side two icons let you select how to browse the results, either a summary view or a gallery view. The summary view will show a player window next to some of the metadata of the soundfile. A gallery view will only show the spectrogram, the name of the file and the date. From either view you can click on the soundfile name to view the details.

View file details

The fide details page will display the medatada of the soundfile, technical data, location data, as well as a player that shows the spectrogram and the waveform. Click on the filename to open the file in the Pumilio viewer (see below).

Pumilio Viewer

The application has a viewer that allows you to zoom in, filter, cut, select and mark regions, convert, and other manipulations to the soundfile.


The viewer uses a Flash mp3 player controlled by JavaScript to play, pause and stop listening to the soundfile. Zooming in a sound is controlled by a JQuery plugin, just select a region of the soundfile and click the "Zoom in" button. To use a band-pass filter, select the "Filter" box to filter out the frequencies lower and higher than the selected region using SoX.

If the sound is in stereo, you can change the channel displayed by selecting the pulldown menu. The default channel is the left.