Build_instructions

Build instructions

MesonCast is written in C++ using Qt framework. It also uses BASS and BASSmix audio libraries.

Some important notes:

• Below, SRC_ROOT means source distribution directory. For example, if you've downloaded/unpacked the sources to /home/user/mesoncast, then SRC_ROOT will be /home/user/mesoncast.

• Before downloading any libraries, make sure they are all have the same architecture. If you want to build MesonCast as 64-bit application, then you'll have to use only 64-bit third-party libraries. Same for 32-bit app.

• Also, note that sources are distributed under GNU GPL v3, so you cannot use them in closed-source projects.

Steps to build MesonCast:

• First of all, get the latest sources.

• Get a compiler of your choice:

  • For Linux, GNU C++
  • For Windows, MS Visual Studio, MinGW compilers or MinGW compilers for 64-bit
  • For OS X, do the following:
    • Install Xcode
    • Run Xcode, open from menu: Xcode > Preferences > Downloads > Components
    • Click "Install" button against "Command Line Tools"

• Install Qt libraries. Use only version 4.8.x!

• BASS and BASSmix audio libraries are already included for Windows and OS X, but you may want to get a new version (or version for Linux) from the BASS official website. In that case, you must do the following:

  • For Windows, put bass.dll from the archive to SRC_ROOT/mesoncast folder; also put c/bass.lib from the archive to SRC_ROOT/lib folder.

  • For OS X, put libbass.dylib from the archive to SRC_ROOT/mesoncast folder.

  • For Linux, put libbass.so from the archive to a folder where libraries are usually placed. Try this command to get your library paths:
    ldconfig -v 2>/dev/null | grep /
    
    
    After that, you may need to run ldconfig again (without parameters) to rebuild libraries cache.

• Build the app. Main project file is located in SRC_ROOT/mesoncast/mesoncast.pro. The easiest way to run a build process is to use Qt Creator. Alternatively, you may use command line only. In that case, make sure the compiler binaries are in PATH and other environment variables set (use appropriate shell scripts to setup your build invironment, if needed). Descend into SRC_ROOT/mesoncast then use the following commands:

  • For Windows:

    • qmake CONFIG+=release && mingw32-make - if you're using Qt built with MinGW
    • qmake CONFIG+=release && nmake - if you're using Qt built with MS Visual Studio

  • For Linux and OS X: qmake CONFIG+=release && make

After, you've built the application, you must also install some additional libraries. See "Setup the prerequisites" article.