Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install timeside

How to install TimeSide

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install timeside
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
0.4.5Never BuiltWhy not?
0.3.1 Available View build log
Windows (64-bit)
0.4.5Never BuiltWhy not?
0.3.1 Available View build log
Mac OS X (10.5+)
0.4.5Never BuiltWhy not?
0.3.1 Available View build log
Linux (32-bit)
0.4.5Never BuiltWhy not?
0.3.3 Available View build log
0.3.2 Available View build log
0.3.1 Available View build log
Linux (64-bit)
0.4.5 Available View build log
0.3.3 Available View build log
0.3.2 Available View build log
0.3.1 Available View build log
Gnu Public License V2
Depended by
Lastest release
version 0.4.5 on Jan 9th, 2014

TimeSide is a set of python components enabling easy audio processing, transcoding, imaging and streaming. Its simple architecture and high-level API have been design to process serial pipelines.

It includes a powerful HTML5 interactive player which can be embedded in any web application to provide fancy waveforms, various analyzer results, synced time metadata display during playback (time-marking) and remote indexing.

The engine (server side) is fully written in Python, the player (client side) in HTML, CSS and JavaScript.


We just need a python library to:

  • build a python framework to do asynchronous audio processing,
  • decode audio frames from ANY format to numpy arrays,
  • stream the frames in processors and do numpy data analyzing,
  • create various waveforms, spectrograms, etc.. with numpy and PIL,
  • transcode the processed frames in various media formats and stream it,
  • provide a high-level HTML5 UI to stream the results on demand through the web,
  • remote metadata indexing and time marking (JSON RPC, needs a server system like Telemeta).

Here is a schematic diagram of the TimeSide engine architecture:




  • (re)fix Pillow support (#12)
  • fix some python package rules
  • add a Debian package directory (thanks to piem, in git repo only)


  • Only minor setup bugfixes
  • Last compatible version with Python 2.6
  • Next version 0.5 will integrate serious new analyzer features (aubio, yaafe and more)


  • finally fix decoder leaks and de-synchronizations (thanks to piem)
  • this also fixes bad variable encoder file lengths
  • fix OGG and FLAC encoders (closes: #8)
  • fix multi-channels streaming (closes: #13)
  • add support for Pillow (closes: #12)
  • temporally desactivate AAC and WebM encoders (need to add some limits for them)
  • WARNING : we now need to add overwrite=True to encoder kwargs instances in order to overwrite the destination file, i.e. e=Mp3Encoder(path, overwrite=True)


  • many releases these days, but there are some patches which are really worth to be HOT released : we just need them in production..
  • finally fix FFT window border leaks in the streaming spectrum process for really better spectrograms and smoother spectral centroid waveforms
  • mv gstutils to timeside.gstutils
  • cleanup various processes
  • Ogg, Aac and Flac encoders not really working now (some frames missing) :( Will be fixed in next release.


  • move UI static files from ui/ to static/timeside/ (for better django compatibility)
  • upgrade js scripts from telemeta 1.4.4
  • upgrade SoundManager2 to v297a-20120916


  • finally fixed an old decoder bug to prevent memory leaks during hard process (thanks to piem)
  • add blocksize property to the processor API
  • add many unit tests (check tests/alltests.py)
  • re-add UI files (sorry, was missing in the last packages)
  • various bugfixes
  • encoders not all much tested on big files, please test!
  • piem is now preparing some aubio analyzers :P


  • mostly a transitional developer and mantainer version, no new cool features
  • but add "ts-waveforms" script for waveform batching
  • fix some tests
  • removed but download audio samples
  • fix setup
  • update README


  • move mainloop to its own thread to avoid memory hogging on large files
  • add condition values to prepare running gst mainloop in a thread
  • add experimental WebM encoder
  • duration analysis goes to decoder.duration property
  • bugfixes

Dive in

Define some processors:

>>> import timeside
>>> decoder  =  timeside.decoder.FileDecoder('source.wav')
>>> grapher  =  timeside.grapher.Waveform()
>>> analyzer =  timeside.analyzer.MaxLevel()
>>> encoder  =  timeside.encoder.Mp3Encoder('output.mp3')

then, the magic pipeline:

>>> (decoder | grapher | analyzer | encoder).run()

get the results:

>>> grapher.render(output='image.png')
>>> print 'Level:', analyzer.result()

and finally see image.png and play output.mp3 ;)

More examples


The TimeSide engine is intended to work on all Unix / Linux platforms, but MacOS X and Windows versions will soon be explorated.

The player should work on any modern HTML5 enabled browser. Flash is needed for MP3 if the browser doesn't support it.


TimeSide needs some other python modules to run. The following methods explain how to install all dependencies on various Linux based systems.

On Debian, Ubuntu, etc:

$ sudo apt-get update
$ sudo apt-get install gcc python python-dev python-pip python-setuptools
                       python-gobject gobject-introspection \
                       python-gst0.10 gstreamer0.10-plugins-base gir1.2-gstreamer-0.10 \
                       gstreamer0.10-plugins-good gstreamer0.10-plugins-bad \

On Fedora and Red-Hat, etc:

$ sudo yum update
$ sudo yum install gcc python python-devel gstreamer pygobject2 gstreamer-python  \
                   gstreamer gstreamer-plugins-bad-free gstreamer-plugins-bad-free-extras \
                   gstreamer-plugins-base gstreamer-plugins-good

And then:

$ sudo pip install timeside

To get non-free (MP3, MP4, AAC, etc) decoding and encoding features, add Debian Multimedia repository and install the modules:

$ echo "deb http://www.deb-multimedia.org stable main non-free" | sudo tee -a /etc/apt/sources.list
$ sudo apt-get update
$ apt-get install gstreamer0.10-lame gstreamer0.10-plugins-really-bad gstreamer0.10-plugins-ugly


TimeSide provides ts-waveforms, a waveform rendering batch script. Usage:

$ ts-waveforms /path/to/media_dir /path/to/img_dir

Please use absolute paths. For example:

$ ts-waveforms /home/$user/music/mp3/ /home/$USER/images/

To change the color scheme or the size of the waveforms, edit the script from the source and change the variables of the GrapherScheme object:

$ git clone git://github.com/yomguy/TimeSide.git
$ cd timeside/scripts/
$ vi ts-waveforms
$ ./ts-waveforms /home/$user/music/mp3/ /home/$USER/images/

Packages included


TimeSide is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

TimeSide is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

See LICENSE for more details.


  • Copyright (c) 2006, 2012 Parisson SARL
  • Copyright (c) 2006, 2012 Guillaume Pellerin
  • Copyright (c) 2010, 2012 Paul Brossier
  • Copyright (c) 2006, 2010 Samalyse SARL

Subscribe to package updates

Last updated Jan 9th, 2014

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.