Linphone Desktop
Linphone is an open source softphone for voice and video over IP calling and instant messaging.
It is fully SIP-based, for all calling, presence and IM features.
General description is available from Linphone web site
License
Copyright © Belledonne Communications
Linphone is dual licensed, and is available either :
-
under a GNU/GPLv3 license, for free (open source). Please make sure that you understand and agree with the terms of this license before using it (see LICENSE file for details).
-
under a proprietary license, for a fee, to be used in closed source applications. Contact Belledonne Communications for any question about costs and services.
Documentation
Getting started
Here are the general instructions to build Linphone for desktop. The specific instructions for each build platform is described just below. You will need the tools :
cmake
>= 3.15 : download it in https://cmake.org/download/python
: https://www.python.org/downloads/release/python-381/pip
: it is already embedded inside Python, so there should be nothing to do about ityasm
: https://yasm.tortall.net/Download.htmlnasm
: https://www.nasm.us/pub/nasm/releasebuilds/doxygen
(required for the Cxx Wrapper)Perl
Pystache
: use 'pip install pystache --user'six
: use 'pip install six --user'git
For Desktop : you will need Qt5 (5.12 or newer). C++11
support is required!
Set your environment
-
It's necessary to install the
pip
command and to execute:pip install pystache six
-
You have to set the environment variable
Qt5_DIR
to point to the path containing the cmake folders of Qt5, and thePATH
to the Qt5bin
. Example:Qt5_DIR="~/Qt/5.12.5/gcc_64/lib/cmake" PATH="~/Qt/5.12.5/gcc_64/bin/:$PATH"
Note: If you have qtchooser
set in your PATH
, the best use is :
eval "$(qtchooser -print-env)"
export Qt5_DIR=${QTLIBDIR}/cmake/Qt5
export PATH=${QTTOOLDIR}:$PATH
- For specific requirements, see platform instructions sections below.
Summary of Building steps
`git clone https://gitlab.linphone.org/BC/public/linphone-desktop.git --recursive`
`cd linphone-desktop`
`mkdir build`
`cd build`
`cmake .. -DCMAKE_BUILD_PARALLEL_LEVEL=10 -DCMAKE_BUILD_TYPE=RelWithDebInfo`
`cmake --build . --target install --parallel 10 --config RelWithDebInfo`
`./OUTPUT/bin/linphone --verbose` or `./OUTPUT/Linphone.app/Contents/MacOS/linphone --verbose`
Get sources
-
Clone repository:
git clone https://gitlab.linphone.org/BC/public/linphone-desktop.git --recursive
-
Update sub-modules
git submodule update --init --recursive
Building : General Steps
The build is done by building the SDK and the application. Their targets are sdk
and linphone-qt
.
-
Create your build folder at the root of the project :
mkdir build
Go to this new folder and begin the build process :cd build
-
Prepare your options :
cmake ..
. By default, it will try compile all needed dependencies. You can remove some by adding-DENABLE_<COMPONENT>=NO
to the command. You can usecmake-gui ..
if you want to have a better access to them. You can add-DCMAKE_BUILD_PARALLEL_LEVEL=<count>
to do<count>
parallel builds for speeding up the process. Also, you can add-DENABLE_BUILD_VERBOSE=ON
to get more feedback while generating the project.
Note : For Makefile or Ninja, you have to add -DCMAKE_BUILD_TYPE=<your_config>
if you wish to build in a specific configuration (for example RelWithDebInfo
).
- Build and install the whole project :
cmake --build . --target <target> --parallel <count>
(replace<target>
with the target name and<count>
by the number of parallel builds).
Note : For XCode or Visual Studio, you have to add --config <your_config>
if you wish to build in a specific configuration (for example RelWithDebInfo
).
When all are over, the files will be in the OUTPUT folder in the build directory. When rebuilding, you have to use cmake --build . --target install
(or cmake --install .
) to put the application in the correct configuration.
-
When doing some modifications in the SDK, you can rebuild only the SDK with the target
sdk
and the same for the application withlinphone-qt-only
-
In order to get packages, you can use
cmake .. -DENABLE_APP_PACKAGING=YES
. The files will be inOUTPUT/packages
folder.
Update your project
-
Update your project with :
git fetch git pull --rebase
-
Update sub-modules from your current branch
git submodule update --init --recursive
Then simply re-build using cmake.
General Troubleshooting
- The latest version of Doxygen may not work with the SDK. If you some build issues and have a specific version of Doxygen that is not in your PATH, you can use
-DLINPHONESDK_DOXYGEN_PROGRAM
.
Eg on Mac : -DLINPHONESDK_DOXYGEN_PROGRAM=/Applications/Doxygen.app/Contents/Resources/doxygen
-
If the build of the SDK crash with something like "cmd.exe failed" and no more info, it can be a dependency that is not available. You have to check if all are in your PATH. Usually, if it is about VPX or Decaf, this could come from your Perl installation.
-
If the application doesn't start and create an empty file with a random name, it could be come from a bad configuration between your application and others sub-modules. Check your configurations and force them with
-DCMAKE_BUILD_TYPE=<your_config>
or--config <your_config>
.
Specific instructions for the Mac Os X platform
To install the required dependencies on Mac OS X, you can use Homebrew. Before you install packages with Brew, you may have to change directories permissions (if you can't change permissions with sudo on a MacOS >= High Sierra, get a look at this StackOverflow answer).
-
Install XCode from the Apple store. Run it at least once to allow it to install its tools.
-
Install Homebrew by following the instructions here https://brew.sh/
-
Install dependencies:
brew install cmake qt git
-
First ensure you have installed pip. You can get it for python 2.7 there.
-
Then, you can install a pip package with the following command:
pip install [package]
For instance, if you don't have pystache and the dot package (contained in graphviz), enter the following commands:
pip install pystache
pip install graphviz
- Build as usual (General Steps) :
cmake .. -DCMAKE_BUILD_PARALLEL_LEVEL=10 -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build . --target all --parallel 10 --config RelWithDebInfo
-
The project folder will be in the build directory and binaries should be in the OUTPUT folder.
-
When updating the project, the next build steps are a bit different:
cmake --build . --target all --parallel 10 --config RelWithDebInfo
cmake --install .
ORcmake --build . --target install --parallel 10 --config RelWithDebInfo
Specific instructions for the Windows platform
64-bit version is not fully supported at this moment by Linphone Desktop and wasn't tested.
If a build for 64bits is needed, replace all mingw32
by mingw64
, i686
by x86_64
, -A Win32
by -A x64
or simply remove it.
- Install main tools:
MinGW/MSYS2
: download- Follow instructions on their "Getting Started" page.
- Install toolchains and prepare python:
pacman -Sy --needed base-devel mingw-w64-i686-toolchain
pacman -S python3-pip
inMSYS2 MSYS
consolepython3 -m pip install pystache six
incmd
- In this order, add
C:\msys64\
,C:\msys64\usr\bin
andC:\msys64\mingw32\bin
in your PATH (the last one is needed by cmake to know where gcc is) to the PATH environement variable from windows advanced settings.
When building the SDK, it will install automatically from MSYS2 : perl
, yasm
, gawk
, bzip2
, nasm,
sed,
patch,
pkg-config,
gettext,
glib2and
intltool` (if needed)
-
git
: use MSYS2 :pacman -S git
or download -
Visual Studio must also be properly configured with addons. Under "Tools"->"Obtain tools and features", make sure that the following components are installed:
- Tasks: Select Windows Universal Platform development, Desktop C++ Development, .NET Development
- Under "Installation details". Go to "Desktop C++ Development" and add "SDK Windows 8.1 and SDK UCRT"
- Individual component: Windows 8.1 SDK
-
Ensure that you have downloaded the
Qt msvc2015 version
orQt msvc2017 version
(32-bit). -
Or open a Command line with Visual Studio
Developer Command Prompt for VS 2017
and call qtenv2.bat that is in your qt binaries eg:C:\Qt\<version>\msvc2017\bin\qtenv2.bat
-
Build as usual with adding
-A Win32
tocmake ..
(General Steps) :
cmake .. -DCMAKE_BUILD_PARALLEL_LEVEL=10 -DCMAKE_BUILD_TYPE=RelWithDebInfo -A Win32
The default build is very long. It is prefered to use the Ninja generator-G "Ninja"
cmake --build . --target ALL_BUILD --parallel 10 --config RelWithDebInfo
-
The project folder will be in the build directory and binaries should be in the OUTPUT folder.
-
When updating the project, the next build steps are a bit different:
cmake --build . --target ALL_BUILD --parallel 10 --config RelWithDebInfo
cmake --install .
ORcmake --build . --target install --parallel 10 --config RelWithDebInfo
Specific instructions for the Mac Os X platform
- Build as usual (General Steps) :
cmake .. -DCMAKE_BUILD_PARALLEL_LEVEL=10 -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build . --target all --parallel 10 --config RelWithDebInfo
-
The project folder will be in the build directory and binaries should be in the OUTPUT folder.
-
When updating the project, the next build steps are a bit different:
cmake --build . --target all --parallel 10 --config RelWithDebInfo
cmake --install .
ORcmake --build . --target install --parallel 10 --config RelWithDebInfo
Installing Linux dependencies
Dependencies from 4.1 version of Desktop (refer it only if you have issues):
apt-get install libqt53dcore5:amd64 libqt53dextras5:amd64 libqt53dinput5:amd64 libqt53dlogic5:amd64 libqt53dquick5:amd64 libqt53dquickextras5:amd64 libqt53dquickinput5:amd64 libqt53dquickrender5:amd64 libqt53drender5:amd64 libqt5concurrent5:amd64 libqt5core5a:amd64 libqt5dbus5:amd64 libqt5designer5:amd64 libqt5designercomponents5:amd64 libqt5gui5:amd64 libqt5help5:amd64 libqt5multimedia5:amd64 libqt5multimedia5-plugins:amd64 libqt5multimediawidgets5:amd64 libqt5network5:amd64 libqt5opengl5:amd64 libqt5opengl5-dev:amd64 libqt5positioning5:amd64 libqt5printsupport5:amd64 libqt5qml5:amd64 libqt5quick5:amd64 libqt5quickcontrols2-5:amd64 libqt5quickparticles5:amd64 libqt5quicktemplates2-5:amd64 libqt5quicktest5:amd64 libqt5quickwidgets5:amd64 libqt5script5:amd64 libqt5scripttools5:amd64 libqt5sensors5:amd64 libqt5serialport5:amd64 libqt5sql5:amd64 libqt5sql5-sqlite:amd64 libqt5svg5:amd64 libqt5svg5-dev:amd64 libqt5test5:amd64 libqt5webchannel5:amd64 libqt5webengine-data libqt5webenginecore5:amd64 libqt5webenginewidgets5:amd64 libqt5webkit5:amd64 libqt5widgets5:amd64 libqt5x11extras5:amd64 libqt5xml5:amd64 libqt5xmlpatterns5:amd64 qt5-default:amd64 qt5-doc qt5-gtk-platformtheme:amd64 qt5-qmake:amd64 qt5-qmltooling-plugins:amd64
Contributing
Code
In order to submit a patch for inclusion in Linphone's source code:
-
First make sure that your patch applies to the latest Git sources before submitting : patches made to old versions can't and won't be merged.
-
Fill out and send the contributor agreement for your patch to be included in the Git tree by following links there. The goal of this agreement is to grant us the peaceful exercise of our rights to the Linphone source code, without losing your rights over your contribution.
-
Then go to the github repository and make a Pull Requests based on your code.
Please note that we don't offer free support and these contributions will be addressed on our free-time.
Languages
Linphone is getting a full internationalization support, using Transifex platform. If you want you can contribute at: https://www.transifex.com/belledonne-communications/linphone-desktop/languages/
Feedback or bug reporting
Launch the application with --verbose
parameter to get full logs and send it with your request. You can use the "Send logs" button in settings to upload log files and share it by email or with a post in the corresponding Github project :
On some OS (like Fedora 22 and later), they disable Qt debug output by default. To get full output, you need to create ~/.config/QtProject/qtlogging.ini
and add :
[Rules]
*.debug=true
qt.*.debug=false