Setup

Table of Contents

• Install from the source
• Standalone setup
• CMake FetchContent
• Setup with CPM

Install from the source

Code source of TTS is available on GitHub and can be retrieved via the following command:

$ git clone https://github.com/jfalcou/tts.git

Once retrieved, you should have a tts folder which contains the whole source code.

Create a build directory here and enter it. Once in the build directory, you can use CMake to generate the build system for TTS. We recommend using Ninja but any build system is fine.

$ mkdir build
$ cd build
$ cmake .. -G Ninja

Once CMake completes, you can use the install target to build and install TTS. By default, the library will be installed in the /usr/local directory, thus requiring root privileges.

$ sudo ninja install

You can select an alternative installation path by specifying the CMAKE_INSTALL_PREFIX option at configuration time.

$ cmake .. -G Ninja -DCMAKE_INSTALL_PREFIX=path/to/install
$ ninja install

Once installed, TTS is usable directly by providing the path to its installed files.

Standalone setup

You can also use TTS via a single standalone file that can be vendored in your own project without having to deal with TTS as a dependency.

Simply use wget to fetch the latest version and place it where you want:

wget https://raw.githubusercontent.com/jfalcou/tts/refs/heads/standalone/tts.hpp

Use TTS by just compiling your code with the include path pointing to the location of this single file.

CMake FetchContent

You can also use CMake FetchContent operation and use the tts::tts library target that our CMake exports.

##==================================================================================================
## Your project setup
##==================================================================================================
cmake_minimum_required(VERSION 3.22)
project(tts-fetch LANGUAGES CXX)
 
include(FetchContent)
FetchContent_Declare(tts GIT_REPOSITORY "https://github.com/jfalcou/tts.git")
FetchContent_MakeAvailable(tts)
 
add_executable(test_tts ../main.cpp)
target_link_libraries(test_tts PUBLIC tts::tts)

Setup with CPM

The TTS library can be setup using CPM:

##==================================================================================================
## Your project setup
##==================================================================================================
cmake_minimum_required(VERSION 3.18)
project(tts-cpm LANGUAGES CXX)
 
# Setup CPM - See https://github.com/cpm-cmake/CPM.cmake#adding-cpm
include(cpm.cmake)
 
CPMAddPackage ( NAME tts
                GIT_REPOSITORY "https://github.com/jfalcou/tts.git"
                OPTIONS "TTS_BUILD_TEST OFF"
              )
 
add_executable(test_tts ../main.cpp)
target_link_libraries(test_tts PUBLIC tts::tts)