Developer Guide

From Audacity Wiki
Revision as of 16:07, 26 August 2007 by James (talk | contribs) (New page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Getting audacity building on Linux is usually trouble-free because the right tools are there in the environment, or can be found and installed easily. The same isn't really true for Windows and the win/compile.txt file provided with the audacity source code assumes you know quite a lot about how stuff works under the bonnet, and about visual studio.


Windows Set Up

Edit-hint: Please help us improve this text.

It can help to work in stages. It's probably not advisable to try to do all four steps in one session:

  • First get comfortable with Micorosft's visual studio, MSVC 2005. It's a free download from Microsoft's website. To develop in C/C++ for windows you also need a second download from the Microsoft site, which is the 'platform SDK'. The instructions are on Microsoft's website. With MSVC set up you can write 'hello world' and similar small programs just to check things out, or use some of the examples that Microsoft provide.
  • Next get a recent version of wxWidgets. If you want to work with cutting edge code in Audacity, use wxWidgets 2.8.4. Follow the instructions in the wxWidgets documentation to get some of the wxWidgets samples to compile. wxWidgets has excellent documentation on its API. Time spent reading that documentation and trying things out is time well spent. There is one detail in setting up wxWidgets which is very important. It's setting up the $(WXWIN) environment variable. It's not set by the installer. It must be set correctly to your wxWidgets directory if you're to compile Audacity. wxWidgets has be compiled in many different modes, e.g. Unicode and ansi, debug and release, library or dll. If you want to work with the latest Audacity code, make sure that amongst the versions you compile is the unicode - debug - dll version.
  • Set up for CVS. For windows get tortoisecvs from sourceforge. This adds extra menu items to your file explorer windows. When you right click on a folder you get additional items in the menu. These are used for synchronising your local copy of the files with the files at sourceforge. Any user can read the files at sourceforge via cvs, and that's all you need at this stage. If you have problems with accessing audacity CVS from windows send a message about it to the audacity developer list. If we can't help you sort it out then we can at least send you an up to date snapshot of the code which will get you started.

Don't try moving onto this next step until you have at least one sample wxWidgets program compiled and running!

  • If you have done all the steps above, this step should go smoothly. Open the project file for Audacity in MSVC, select the wx284Debug build of Audacity and click compile. Problems? Try cutting and pasting the error message into a google search box. Many of the compiler and linker error messages are fairly cryptic unless you've seen them before. Fortunately there's a lot of people out there who have, and there are messages in web searchable e-mail lists explaining what they mean and what to do.

Linux/Mac Set Up

See:


More about Audacity

See:

More about Digital Sound

There are articles on the web ranging from beginners guides on how sound is represented in a computer to research papers on DSP algorithms.