Skip to content

Latest commit

 

History

History
686 lines (401 loc) · 20.2 KB

BUILD.md

File metadata and controls

686 lines (401 loc) · 20.2 KB
Raw

Csound Build Instructions

Build instructions for building Csound from the source packages for the following operating systems

Instructions for RPI compiled by Dominic Melville contact via dcamelville at gmail.com for amendments and updates

Debian/Ubuntu

The following instructions will explain how to configure, compile, and install Csound 6 on Debian and Ubuntu systems.

Requirements

You will need root access, primarily to allow installation of dependencies required for building Csound, as well as for installing into /usr/local.

Building Csound 6

The following instructions are written for those getting a copy of the source code from Git. You will need to adjust the steps accordingly when using the source tarball from the files section.

The first thing to do is make sure you have all of the required dependencies for building Csound. In a terminal, do the following:

  1. Edit, as root, /etc/apt/sources.list and ensure that each line beginning with deb has another line below it that is identical except that deb is replaced with deb-src. Then run sudo apt-get update.

  2. sudo apt-get build-dep csound

  3. sudo apt-get install cmake

  4. sudo apt-get install git

The following numbered steps are to be done in a terminal for building and installing Csound:

  1. cd ~

  2. mkdir csound

  3. cd csound

  4. git clone https://github.com/csound/csound.git csound

  5. mkdir cs6make

  6. cd cs6make

  7. cmake ../csound

  8. make -j6

  9. sudo make install

  10. sudo ldconfig

At this point, Csound 6 should now be compiled and installed into the /usr/local set of folders.

macOS using Homebrew

Introduction

Homebrew is a package manager for macOS. It is able to download, build, and install applications, including their dependencies. The following sections will describe what you will need to do to use Homebrew to install Csound 6.

Requirements

Installing Homebrew

You will first need to have a working Homebrew setup. This requires installing Xcode and the Xcode Command-Line tools. More information on installing Homebrew is available on the Homebrew website as well as their wiki.

In particular, you will need to be mindful to enable user read/write for three directories: "/usr/local", "/Library/Python/2.7/site-packages", and "/Library/Java/Extensions". These need to be writable by the user as Csound will need to install packages into each of those folders. Running the following commands at a Terminal prompt should allow you to do this:

sudo chmod +a 'user:YOUR_NAME_HERE allow add_subdirectory,add_file,delete_child,directory_inherit' /Library/Python/2.7/site-packages

sudo chmod +a 'user:YOUR_NAME_HERE allow add_subdirectory,add_file,delete_child,directory_inherit' /Library/Java/Extensions

where YOUR_NAME_HERE refers to your system username.

Installing Csound

Once Homebrew is setup, run the following command at the commandline to install Csound:

brew install csound

You can install the latest from the develop branch using:

brew install --HEAD csound

If you have a HEAD version already installed and you want to rebuild with newly updated code in the develop branch, use:

brew reinstall csound

Building Csound using Homebrew-supplied dependencies

If you would like to compile csound on macOS, you need to have its dependencies installed. You can do this manually picking out various packages from Homebrew or you can use the csound formula to install the dependencies using

brew install --only-dependencies csound

This installs all of the tools and libraries that is required to build csound and various plugins. After installing dependencies, you can use cmake to build:

  1. Clone the csound source from github and cd into the root of the csound folder.
  2. mkdir build
  3. cd build
  4. cmake ..
  5. make -j6
  6. make install

For step 4, you can use cmake .. -G Xcode if you then want to build Csound with XCode. Step 6 may require the use of sudo depending on permissions. Note that building from source installs into different paths on the system compared to where the Homebrew-built version of Csound is installed to. It is recommended to brew uninstall csound prior to building, installing, and using your self-compiled version of Csound.

General Linux without Root access

These are generic instructions to build on any Linux system with no root access. These instructions require a full development system (compilers, flex, bison, cmake). For RT audio you need to make sure you have the alsa headers / lib installed.

1) set up your local directory

This creates three directories in your HOME directory and adds your local lib directory to dynamic library path. Note that this last step needs to be performed every time you open a new terminal, otherwise the installed Csound will not find its dynamic library dependencies. If you add that line to your HOME/.profile script, it will be run automatically when you start a new terminal. $ $

  • cd

  • mkdir include

  • mkdir lib

  • mkdir bin

  • mkdir src

  • export LD_LIBRARY_PATH=$HOME/lib:LD_LIBRARY_PATH

(this last command can be added to your $HOME/.profile file for convenience)

2) get and install libsndfile

Libsndfile is the only required dependency for a basic Csound build.

Ubuntu users: it appears the libsndfile binaries come as default in your installation, so this step might not be required. However, there is no harm in doing it.

  • cd src

  • wget http://www.mega-nerd.com/libsndfile/files/libsndfile-1.0.28.tar.gz

  • tar xf libsndfile-1.0.28.tar.gz

  • cd libsndfile-1.0.28

  • ./configure --prefix=$HOME

  • make install

3) get Csound (latest from git)

The latest Csound sources are kept in the develop branch. For the latest released sources, you do not need to change branches.

  • cd ..

  • git clone https://github.com/csound/csound.git csound

  • cd csound

  • git checkout develop

  • mv Custom.cmake.ex Custom.cmake

4) set the include path for the build

Cmake needs to find your locally-installed headers in HOME/bin. You can add custom commands to Cmake by using a Custom.cmake file, which Cmake will read if it exists.

Open or create the Custom.cmake file in the top level Csound sources directory and add the following line: include_directories("ENV{HOME}/include")

5) build and install Csound

The recommended method is to create a separate build directory and run cmake there.

  • mkdir build

  • cd build

  • cmake -DCMAKE_INSTALL_PREFIX=$HOME ..

  • make install

Notes

This builds a basic system. If you add dependencies to your HOME directories, then you can run make again to build them. The csound command-line frontend will be installed in $HOME/bin, the libraries in $HOME/lib and the include files in $HOME/include. The plugin dir is in $HOME/lib/csound/plugins64-6.0.

Dependencies List

If the dependency you are adding uses ./configure, you can use the same parameters to it as explained in step 2. If it uses cmake, you can use the same parameters as in step 5. After adding dependencies to your $HOME directories, you can run cmake again to re-build Csound. Check the printed output to see if the added dependency has switched on the build of the desired component.

NB: Since the EOL for Python 2, the Python opcodes have been removed from the main library repository. A new set of opcodes for Python 3 is found in the plugin opcodes repository.

OSC opcodes

liblo - http://liblo.sourceforge.net/ NB: the build for version 0.28 seems to be broken.

Fluid opcodes

Fluidsynth - http://sourceforge.net/apps/trac/fluidsynth/ NB: cmake might need to be coerced into finding the fluidsynth headers once it is built. For that, you can use the following cmake command (see step 5):

cmake -DCMAKE_INSTALL_PREFIX=$HOME -DFLUIDSYNTH_H=$HOME/include ..

Portaudio module

portaudio - http://www.portaudio.com/

Portmidi module

portmidi - http://portmedia.sourceforge.net/portmidi/

JACK module

Jack connection kit - http://jackaudio.org/

Python bindings

Python headers / library - http://www.python.org

Java bindings

swig - http://www.swig.org/ Java SDK - http://www.oracle.com/technetwork/java/javase/downloads/index.html

Raspberry Pi Standard Distro

(Raspian Wheezy)

Preliminary step:

sudo apt-get build-dep csound

If you get the following error:

E: You must put some 'source' URIs in your sources.list

then add the following line to /etc/apt/sources.list:

deb-src http://mirrordirector.raspbian.org/raspbian/ wheezy main contrib non-free rpi

(This can be done with nano)

It might appear that this repository is not available anymore. In this case, you can try adding the following repository (and equivalent deb-src) to /etc/apt/sources.list : deb http://legacy.raspbian.org/raspbian/ wheezy main contrib non-free rpi

After adding that to the sources.list, you should run sudo apt-get update and retry the sudo apt-get build-dep csound command.

Following this, you can build as in other linux systems,

  1. mkdir csound

  2. cd csound

  3. git clone https://github.com/csound/csound.git csound

  4. mkdir cs6make

  5. cd cs6make

  6. cmake ../csound -DCMAKE_BUILD_TYPE="Release"

  7. make -j6

If this last step fails, check he section "NEON support for PFFFT lib" below. Once you are past it, you can complete the installation,

  1. sudo make install

  2. sudo ldconfig

If you want to use the csnd6 Python library, add the following line to .bashrc:

export PYTHONPATH=/usr/local/lib

Enabling the Python Bindings requires swig and python-dev packages to be installed with

sudo apt-get install swig python-dev

NEON support for PFFFT lib

From 6.07, Csound includes a choice of FFT libraries. One of these is PFFFT, which can avail of NEON vector operations on arm, where these exist. This can lead to a compilation error if the correct options are not set. If a build error occurs in the compilation of pffft.c, two options exist.

  1. Try to add the correct flags for NEON compilation. This can be made by editing the top-level file Custom.cmake.ex, and saving it as Custom.cmake. In that file, the line

    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -W -Wall -mtune=core2")

    should be changed to

    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -mfloat-abi=hard -mfpu=neon")

  2. If this step fails, there might be no NEON support for your arm chip, or there might be a compiler issue, in which case, you need to change the line above to

    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DPFFFT_SIMD_DISABLE")

    in order to disable the vectorial code and use standard C scalar operations.

There is no support for NEON on rpi 1 or zero. This is available for rpi 2 and 3, though.

  1. Remember to run cmake again (step 6 above) after any changes to Custom.cmake

Fedora 18

Introduction

This shows how to download the source code from Sourceforge, and build Csound 6 from sources.

Requirements

For some steps, you'll need root access. You may need to install additional packages - the example shows installing a number of additional packages, but the exact requirements depend on your system.

You'll need to make sure Cmake, flex, bison, and libsndfile are installed. If you're logged in as a non-root user, you can execute root commands using su -c. So here's how to make sure the basic required packages for building are installed:

su -c "yum install cmake libsndfile libsndfile-devel flex bison"

You'll be prompted for your root password.

Downloading

Download the latest Csound 6 sources from

https://sourceforge.net/projects/csound/files/csound6/

At the time this was written, the downloaded file was Csound6.00.1.tar.gz

Compiling

First uncompress and untar the source code:

gunzip Csound6.00.1.tar.gz

tar xf Csound6.00.1.tar.gz

Change into the source directory

cd Csound6.00.1

In the source directory what gets compiled is controlled by the file CMakeLists.txt. By default lots of stuff will get built, as long as you have the required dependencies installed.

The following commands will add most required packages:

su -

yum install ladspa ladspa-devel

yum install fluidsynth fluidsynth-devel

yum install boost boost-devel java-devel

yum install jack-audio-connection-kit-devel

yum install fltk fltk-devel

yum install swig swig-devel

yum install pulseaudio-libs-devel

yum install portaudio portmidi portaudio-devel portmidi-devel

yum install fltk-fluid

yum install stk stk-devel

yum install python-libs

yum install python-devel

yum install liblo liblo-devel

yum install lua lua-devel

yum install eigen3-devel eigen3

yum install gmm-devel

yum install wiiuse wiiuse-devel

yum install bluez-libs-devel

exit

The building process takes two steps

  1. use cmake to create a Makefile

  2. use make to build Csound 6

To create the Makefile:

cmake ./

At this point you may see messages saying that something can't be built - in that case use your skill and judgement to work out which packages are missing. For instance if you get a message saying fltk cannot be built, you could install the fltk-devel package.

If you install a new package, you'll need to run cmake again:

rm CMakeCache.txt

cmake ./

When you're happy, run make

make

This builds the csound library.

Installing

By default, Csound 6 will install in /usr/local, so you'll need root permissions:

su -c "make install"

Finally you need to make sure the library can be found by the linker

su -

cd /etc/ld.so.conf.d

touch csound6.conf

gedit csound6.conf

In the editor, add one line

/usr/local/lib

and close the file.

Finally update the linker search path

ldconfig

and log out of root

exit

Testing As a basic test, just try typing csound at a command prompt, and you should get the help message.

Windows 32/64 Bit (msys2)

Csound for Windows can now be built using MSYS2. This is the recommeneded way to build Csound for Windows. Please follow the instruction posted here.

Windows 32 Bit (mingw32)

A basic working knowledge of the Windows command prompt is assumed. Further instructions for Windows can be found in their own document at the following link Csound Windows Build Doc

Steps (Vanilla build)

  1. Download and install MSYS (http://downloads.sourceforge.net/mingw/MSYS-1.0.11.exe)
  2. Download and install MinGW (http://sourceforge.net/projects/mingwbuilds). -When installing choose architecture i686, or x32.
  3. Download and install Git(http://git-scm.com/download/win)
  4. Download and install libsndfile (32bit) (http://www.mega-nerd.com/libsndfile/)
  5. Download and install cmake (http://www.cmake.org/download/)

Open the Windows command prompt and cd to a folder you wish to create your Csound repository in. Then run:

git clone https://github.com/csound/csound.git cd csound mkdir build cd build

Then run cmake-gui from the command line:

cmake-gui

To the right of 'Where is the source code:' in cmake-gui browse for the Csound source directory. Underneath it, at the "Where to build the binaries" select the newly created build directory. Now type sndfile into the search field and you should see a few cmake entries concerned with libsndfile. Browse for the correct include folder and library file; libsndfile-1.dll. With this done hit configure. At this point you may be greeted with a cmake-gui dialogue asking which generator to use. Select the "MinGW Makefiles" generator. If the configuration command fails you may need to set the CMAKE_C_COMPILER and CMAKE_CXX_COMPILER entries. Simply click the add entry button and add two new FILEPATH entries, CMAKE_C_COMPILER should point towards your installed gcc.exe, and CMAKE_CXX_COMPILER should point towards g++.exe. These files are found in your MinGW/bin directory.

Go back to the command prompt and from your build directory run:

mingw32-make

If everything went Ok, you will now have binaries for most vanilla build of Csound possible. Keep reading if you wish to extend this basic build.

Steps (adding realtime audio and MIDI)

  1. Download portaudio (http://portaudio.com/).
  2. Open MSYS shell and cd to portaudio directory. Then run
  3. './configure'
  4. 'make'

If you wish to build with support for ASIO run the following command, replacing the path to your ASIO SDK with your own.

'./configure --with-host_os=mingw --with-winapi=asio [--with-asiodir=/usr/local/asiosdk2]' 'make'

If make has any problems, you can try adding the following directories to your ASIOSDK folders: ASIOSDK2.3\host\pc.libs C:\SDKs\ASIOSDK2.3\host.libs ASIOSDK2.3\common.libs

  1. Download and portmidi (http://portmedia.sourceforge.net.), Open command prompt and cd to portmidi directory

  2. mkdir build

  3. cd build

  4. cmake ../ -G "Mingw Makefiles"

  5. mingw32-make

  6. Open up cmake once more and make sure the Csound cmake configuration is open. Then search for entries with portaudio and portmidi in them. Browse for the correct include directories for each, and select the libportaudio-2.dll, and libportmidi.dll libraries. Then run configure and generate.

  7. Open the command prompt and cd to the Csound build directory. Then run mingw32-make

Download and install cmake Run cmake from the csound dir and configure Csound to build using MinGW Makefiles. For this minimal you'll need to disable quite a few features. Run generate. cd to csound build directory and run mingw32-make

Windows Visual Studio

Instructions can be found here.

Android

Requirements

  1. SWIG (www.swig.org)
  2. libsndfile sources for android (https://bitbucket.org/kunstmusik/libsndfile-android.git)
  3. boost (www.boost.org)
  4. Android NDK

Steps

  1. Download, build and install SWIG (or install from your distro package system)
  2. Clone the libsndfile sources for android repo,e.g.:

$ cd $HOME

$ mkdir android

$ cd android

$ git clone https://bitbucket.org/kunstmusik/libsndfile-android.git

  1. Set the NDK_MODULE_PATH variable to point to the top directory where the libsndfile sources are located,e.g.

$ export NDK_MODULE_PATH=$HOME/android

  1. Download boost and install (headers only) in your include path (e.g. /usr/local/include). There is no need to build the library.

  2. Download the Android NDK and place it somewhere (e.g. $HOME), set the ANDROID_NDK_ROOT to point to it

$ export ANDROID_NDK_ROOT=$HOME

  1. Get Csound, and go to the ./android/CsoundAndroid directory, run

$ sh build.sh

The Java files and NDK libraries will be under CsoundAndroid.