From Audacity Wiki
Revision as of 13:24, 4 January 2012 by Arent (talk | contribs) (Diagram of Audacity System Architecture)
Jump to: navigation, search

If you have questions about the architectural design of Audacity, please post them here and the developers will answer them.
Related article(s):

Diagram of Audacity System Architecture

 Audio I/O
 File Formats
 Key Config
 *Smart Record

 Command Handler
 Menu Maker
 Keyboard Mapper
 Automation Interface


 Command Handler
 Xtra Widgets


 Automation Interface
 Scripting (Perl)




 Wave Track
 Spectrum Track
 Time Track
 Label Track

 File Trees
 Add Data
 Modify Data
 Delete Data


Audacity Architectural Diagram

Items marked with a * are not released yet and are only available from the latest version of Audacity in SVN HEAD by enabling experimental features.


Q: What are the components in the diagram?


Command Handler

A click on a menu or pressing a keyboard shortcut must dispatch to a routine somewhere. This kind of code is not at all specific to Audacity. Any editor of anything could benefit from it. Perhaps this code will become a reusable library? Some of the details:

  • We enable and disable commands, most particularly when audio is and is not selected.
  • We have an undo/history mechanism. This has an idea of 'summary' so that several consecutive commands may be lumped together.
  • The keyboard shortcuts are user configurable. That's set up in one of the preference panels.
  • The GUI is translatable - you'll see _("some text here") in many places in the code. That means we use wxgettext and .po files to translate it.
  • We additionally abuse the translation system slightly. Translating menu items to start with a '#' leads to those items being hidden from the menus. This is useful for simplified versions of Audacity.

Automation Interface

The automation interface started life as Lynn Allan's CleanSpeech variant of Audacity. This is/was a simplified interface to Audacity with a sequence of operations to remove noise, normalise, truncate silence and convert to mp3. Lynn's use case was conversion of large numbers of sermons from tape so that they could be featured on the internet.

  • The batch feature now has a list box to set up and modify chains of effects. The sequences though are still strictly linear.
  • Built on top of this is an experimental scripting feature. An optional dll module can be loaded, mod-script-pipe, that accepts commands over a named pipe and hands them on to Audacity. Due to the skeleton nature of this feature - no errors or dialogs are handled - it is only suitable for developers at this stage.


Audacity effects are NOT real time effects. You select audio, apply the effect, then listen to the result.

  • Built in: These are the easiest to work with. C++ code is in the Audacity project.
  • LADSPA: Loaded as dlls and following the Ladspa standard. (See also LV2).
  • Nyquist: These are Nyquist (LISP) scripts for audio processing.
  • Vamp: These effects are about analyzing audio. Vamp effects may produce a curve that measures some aspect of the audio, or they may produce labels to label certain features. Nothing stops a Vamp effect from producing a curve that happens also to be audio, i.e. like a regular effect, but that is not the usual use.
  • VST:

One could argue that the 'mixing', gain, panning and amplification envelopes are all effects too, and that these ARE real time.

Most audio editors make the distinction between real time effects (ones you can apply and listen to immediately, and even change the parameters of as you listen to them) and non real time effects.

In Audacity we plan to gradually transition to real time effects through a mechanism that supports both kinds. Whether an effect can be real time or not is largely a matter of the speed. On a slower machine fewer effects will be real time than on a faster machine. This is an important consideration for Audacity. Audacity will not always know in advance. One plan is that rendering can be 'given a head start'. As you listen to what has been rendered your playback cursor may start to catch up. On a fast machine the render will be faster than your playback.


The many audio formats that Audacity supports are provided by third party libraries. Most of these libraries are compiled into Audacity.

  • The LAME library which handles mp3, for licensing reasons, is not distributed with Audacity and is loaded separately.


wxWidgets provides some support for toolbars. With wxAUI its toolbar support has become more mature. We added our own code for docking and working with toolbars before that library existed.


We use many libraries.

Xtra Widgets

These widgets are enhancements to and built on the widgets provided by wxWidgets.

  • In the track panel we use some 'lightweight' widgets. In normal wxWidgets each widget has a windows object associated with it. In the track panel this doesn't hold (Flyweight pattern).


  • Tracks: There are several track types for displaying audio data.
  • Data: Audio is represented as a tree.


  • Wave Track:
  • Spectrum Track:
  • Time Track:
  • Label Track:


This is one of the most interesting subsystems in Audacity. The blockfiles represent a linear stream of audio data as a tree. The blocks are stored on disk. This makes it practical to make changes in the middle of audio, particularly changes that affect length, without the time cost of moving data around on disk for all the audio that comes later. This makes possible work with very long recordings.

The blockfile system also allows multiple versions of the same audio to share common data in the parts which agree.

The technique is closely related to 'unrolled linked list'.


These are the many dialogues that control parameters in Audacity.

We use ShuttleGui here. ShuttleGui is a wrapper around wxWidgets, to make the code more readable.

Cross Platform Library

Q: What widgets/controls library are you using, in order to be cross-platform?

A: wxwidgets:

Real Time Ability

Q: Are there any plans to add any real-time DSP (Digital Signal Processing) to Audacity? It really helps when you can tweak plug-in settings as the audio is playing.

A: Agree. I'd love to see 'Postfish' (written by Monty) integrated into Audacity. It's a big change and needs to happen in evolutionary steps. I have a proposed route to it, which would start by providing a single effect, echo, as a real time effect. James 8th-March-07

Architectural Overview

Q: How can I get an overview of Audacity's architecture?

A: Download the source from SVN. Run Doxygen to get the brief class descriptions. Look at the subdivision into libraries that are outside the GUI. Ask questions here or on the developers' list.

We're using Doxygen lightly, only at the level of classes, with no intention of covering the functions too, so don't expect a greater level of detail than the class list. The class list goes into more detail than the diagram above. You can get the same class information by browsing the source code. The class descriptions are all there in the source code. They are at the start of the cpp files. You don't need to run Doxygen to find this information. Use Doxygen if you already know it and like what it does.