INSTALL

Build & Installation
====================

1. cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release
2. cmake --build build -j4
3. sudo cmake --install build

Mac/Windows
-----------
See README


CMake Options
=============

The following options may be passed to CMake:

    -DCMAKE_INSTALL_PREFIX=/usr
        Specify install location prefix.

    -DCMAKE_BUILD_TYPE=Release|Debug
        Specify which type of build. Debug builds will be *much* larger, as
        they will contain extra debugging information.

    -ENABLE_CATEGORIZED_VIEW=ON
        Enable categorized view. Disabled due to reported crash - #1530
        Default: OFF

    -DENABLE_HTTP_STREAM_PLAYBACK=ON
        Enable support for playing back MPD HTTP streams via QtMultiMedia or
        lib VLC (see below)
        Default: ON

    -DENABLE_LIBVLC=ON
        Enable usage of libVLC for MPD HTTP stream playback. Bug report 493
        (https://github.com/nullobsi/cantata/issues/493) contains
        more information.
        Default: OFF

    -DENABLE_HTTP_SERVER=ON
        Enable usage of internal HTTP server for non-MPD file playback.
        Default: ON

    -DENABLE_PROXY_CONFIG=OFF
        Enable support for proxy settings in config dialog. If disabled,
        system proxy settings are used.
        Default: ON

    -DENABLE_SCROBBLING=OFF
        Enable scrobbling.
        Default: ON

    Linux specific:

    -DENABLE_DEVICES_SUPPORT=ON
        Support external devices (UMS, MTP, AudioCD)
        Default: ON

    -DENABLE_REMOTE_DEVICES=OFF
        Support remote devices (accessed via sshfs, or samba). This requires
        ENABLE_DEVICES_SUPPORT to also be enabled.
        Default: ON

    -DENABLE_UDISKS2=ON
        Build UDisks2 backend for solid-lite.
        Default: ON

    -DINSTALL_UBUNTU_ICONS=ON
        Install Yaru icons for Ubuntu.
        Default: OFF

    -DENABLE_SIMPLE_MPD_SUPPORT=OFF
        Enable support for basic, Cantata controlled, MPD instance.
        Default: ON

    -DENABLE_AVAHI=ON
        Enable avahi support (automatic mpd discovery)
        Default: ON
	
	Windows specific:

	-DNO_MSYS2_BUNDLEDLLS=TRUE
		If not using MSYS2, the script that copies needed libraries to the
		final install directory might not work because it needs Bash and
		LDD. Set this flag to skip that part of the install, though the
		final build might not work without manually copying the required
		DLLs.