PrevInstallationNext

Invocation of cmake

Since version 0.7.10 Kwave uses cmake, a make system that is also used by KDE itself. So if you know how to build other KDE applications, you should not have any difficulties in building Kwave.

In order to compile and install Kwave on your system, it is best practice to do a out-of-tree build. This means that you hold the sources of Kwave in one directory and build the package in another (temporary) directory.

For example, assuming that your sources are already unpacked in $HOME/src/kwave, you can do the following: 

% mkdir /tmp/kwave-build
% cd /tmp/kwave-build
% cmake $HOME/src/kwave [build options]

Specifying build options is a way to enable or disable specific features. Please see the following section for a list of options!

Build options

By specifying build options, you can enable or disable some features of Kwave, like excluding some components or plugins from the generated package. Here is a list of the available options:

  • CMAKE_INSTALL_PREFIX installation prefix of your KF5 installation [on/off, default=/usr/local]

    You can find out the correct value with the following command: 

        % kf5-config --prefix

  • WITH_ALSA enable playback/recording via ALSA [on/off, default=on]

  • WITH_DEBUG build a debug version [on/off, default=off]

  • WITH_DOC build online documentation [on/off, default=on]

  • WITH_FLAC enable support for FLAC files [on/off, default=on]

  • WITH_MP3 enable support for mp3 files [on/off, default=on]

  • WITH_OGG_OPUS enable support for Ogg/Opus files [on/off, default=on]

  • WITH_OGG_VORBIS enable support for Ogg/Vorbis files [on/off, default=on]

  • WITH_OPTIMIZED_MEMCPY use an optimized version of memcpy, available for X86, X86_64 and PPC platforms [on/off, default=on]

  • WITH_OSS enable playback/recording via OSS [on/off, default=on]

  • WITH_PULSEAUDIO enable playback/recording via PulseAudio [on/off, default=on]

  • WITH_QT_AUDIO enable playback via Qt Multimedia [on/off, default=on]

These options can be passed to cmake with -Doption=value. For example, if you want to disable MP3 support, you can pass the corresponding option as follows: 

    % cmake [source directory] -DCMAKE_INSTALL_PREFIX=`kf5-config --prefix` -DWITH_MP3=OFF [other options...]