Generic shared library

Live555

You can check new version from Live555.

For documentation and instructions for building this software, see http://www.live555.com/liveMedia/

Generate build project using cmake

Actually, This command makes the shared library. If you do not want shared library, you should modify value to BUILD_SHARED_LIBS from ON to OFF.

make default Makefile build script using cmake

# mkdir build
# cd build
# export OUT_PATH=./install
# cmake .. -B linux -G "Unix Makefiles"

Build options

usage OpenSSL (default: on): -DLIVE555_ENABLE_OPENSSL=ON/OFF
- If the openssl library is not present in your toolchain, you need to add the disable option of OPENSSL.
- If your toolchain includes openssl, you need to create a cmake file for it.
usage test application (default: on): -DLIVE555_BUILD_EXAMPLES=ON/OFF
usage static/shared library (default: off):
- general shared library (Windows not supported): -DLIVE555_BUILD_SHARED_LIBS=ON/OFF
- usage shared library (Window only): -DLIVE555_MONOLITH_BUILD=ON

Generic shared library

# cmake .. -B linux -G "Unix Makefiles" \
  -DLIVE555_ENABLE_OPENSSL=ON \
  -DLIVE555_BUILD_EXAMPLES=OFF \
  -DLIVE555_BUILD_SHARED_LIBS=ON

Windows shared library with monolith

Windows share libbrary need to dllexport option on share library type, and application need to dllimport option. So, I added LIVEMDIA_API option on all hh files for shared library. So, you have to add the -DLIVE555_MONOLITH_BUILD option with ON.

# cmake .. -B vs2022 -G "Visual Studio 17 2022" \
  -DLIVE555_ENABLE_OPENSSL=OFF \
  -DLIVE555_BUILD_EXAMPLES=OFF \
  -DLIVE555_MONOLITH_BUILD=ON

If you want to use the OpenSSL library on windows for shared library, You have to use the OpenSSL library on vcpkg package from Microsoft. And you have to choose the architect option for win32 or win64 with -A option in windows over than Visual Studio 2019.

cmake -G "Visual Studio 17 2022" -A Win32
cmake -G "Visual Studio 17 2022" -A x64
cmake -G "Visual Studio 17 2022" -A ARM
cmake -G "Visual Studio 17 2022" -A ARM64

openssl on Windows environment

use the OpenSSL-Win32 or OpenSSL-Win64 binary

Reference: https://slproweb.com/products/Win32OpenSSL.html

If you should be OpenSSL-Win32 or OpenSSL-Win64 binary package. you have to change the lib files names on Preferences menu from Visual Studio IDE.

libssl32MD(d).lib or libcrypto32MD(d).lib (-A Win32 option selected)
libssl64MD(d).lib or libcrypto64MD(d).lib (-A Win64 option selected)

If you want automatically check the openssl on cmake. add OPENSSL path to system environment variables.

use the openssl on vcpkg

If you want automatically check the openssl on cmake. add OPENSSL path to system environment variables. or you can use the CMAKE_PREFIX_PATH option in cmake configuration command. But, you have to check the openssl version, it needs over the version 1.1.1.

# cmake -B x64 -G "Visual Studio 17 2022" -A x64 \
  -DCMAKE_VERBOSE_MAKEFILE=ON \
  -DLIVE555_ENABLE_OPENSSL=ON \
  -DCMAKE_TOOLCHAIN_FILE="[path to vcpkg]/scripts/buildsystems/vcpkg.cmake" \ # vcpkg cmake files location
  -DCMAKE_PREFIX_PATH="[path to vcpkg]/installed/x64-windows-static" \ # vcpkg prefix path
  -DVCPKG_TARGET_TRIPLET=x64-windows-static \
  -DCMAKE_CL_64=1

build live555 library and executable file.

#cmake --build linux --config Release

Add "--target install" option if you want the system to be installed together.

#cmake --build linux --config Release --target install

If you need to change options in other ways, you can set them manually as follows.

# mkdir build
# cd build
# export OUT_PATH=./install
# cmake .. -B linux -G "Unix Makefiles" \
  -DCMAKE_VERBOSE_MAKEFILE=ON \
  -DCMAKE_BUILD_TYPE=release \
  -DCMAKE_INSTALL_PREFIX=${OUT_PATH}
# make; make install

If you see the [required is at least "1.1.1"] on vcpkg, you have to change the version to 1.0.0 on CMakeFiles.

For Linux

# mkdir build
# cd build
# export OUT_PATH=./install
# cmake .. -B linux -G "Unix Makefiles" \
  -DCMAKE_VERBOSE_MAKEFILE=ON \
  -DCMAKE_INSTALL_PREFIX=${OUT_PATH}
# cmake --build linux --config Release --target install

For Windows 32 bit Windows from dos prompt

# mkdir build
# cd build
# cmake .. -B win_32 -G "Visual Studio 15 2017" \
  -DCMAKE_VERBOSE_MAKEFILE=ON \
  -DCMAKE_INSTALL_PREFIX=${OUT_PATH}
# cmake --build win_32 --config Release --target install

For Windows 64 bit Windows from dos prompt

# mkdir build
# cd build
# cmake .. -B win_64 -G "Visual Studio 15 2017 Win64" \
  -DCMAKE_VERBOSE_MAKEFILE=ON \
  -DCMAKE_INSTALL_PREFIX=${OUT_PATH}
# cmake --build win_64 --config Release --target install

For Windows ARM from from dos prompt

# mkdir build
# cd build
# cmake .. -B win_arm -G "Visual Studio 15 2017 ARM" \
  -DCMAKE_VERBOSE_MAKEFILE=ON \
  -DCMAKE_INSTALL_PREFIX=${OUT_PATH}
# cmake --build win_arm --config Release --target install

For Xcode

# mkdir build
# cd build
# cmake .. -B osx -G "XCode" \
  -DCMAKE_VERBOSE_MAKEFILE=ON \
  -DCMAKE_BUILD_TYPE=release \
  -DCMAKE_INSTALL_PREFIX=${OUT_PATH}
# cmake --build osx --config Release --target install

Emscripten

Install Emscripten from emsdk You will refer to install Emscripten environment from https://emscripten.org/docs/getting_started/downloads.html. And you have to set emsdk environment to your shell environment.

# export EMSCRIPTEN_PATH=/root/tools/emsdk // this is your install path of emsdk
# source ${EMSCRIPTEN_PATH}/emsdk_env.sh
# which emcc
# export EMSCRIPTEN_ROOT_PATH=${EMSCRIPTEN_PATH}/upstream/emscripten

And you change to into the live555 source path.

# mkdir emcc
# cd emcc
# export OUT_PATH=./install
# emconfigure cmake .. -G "Unix Makefiles" \
  -DLIVE555_ENABLE_OPENSSL=OFF \
  -DCMAKE_VERBOSE_MAKEFILE=ON \
  -DCMAKE_BUILD_TYPE=release \
  -DCMAKE_INSTALL_PREFIX=${OUT_PATH} \
  -DBUILD_EMSCRIPTEN=ON \
  -DCMAKE_TOOLCHAIN_FILE=${EMSCRIPTEN_ROOT_PATH}/cmake/Modules/Platform/Emscripten.cmake \
  -DEMSCRIPTEN_ROOT_PATH=${EMSCRIPTEN_ROOT_PATH}
# emmake make; emmake make install

For emscripten 2.x.x

# mkdir emcc
# cd emcc
# export OUT_PATH=./install
# emcmake cmake .. -B emcc -G "Unix Makefiles" \
  -DLIVE555_ENABLE_OPENSSL=OFF \
  -DCMAKE_VERBOSE_MAKEFILE=ON \
  -DCMAKE_BUILD_TYPE=release \
  -DCMAKE_INSTALL_PREFIX=${OUT_PATH} \
  -DBUILD_EMSCRIPTEN=ON \
  -DCMAKE_TOOLCHAIN_FILE=${EMSCRIPTEN_ROOT_PATH}/cmake/Modules/Platform/Emscripten.cmake \
  -DEMSCRIPTEN_ROOT_PATH=${EMSCRIPTEN_ROOT_PATH}
# emmake cmake --build emcc --config Release

Third-party toolchain

For Linux for arm or third-party toolchain {TOOLCHAIN_PATH} is toolchain path for ARM CPU from manufacture.

ref: https://github.com/raspberrypi/tools

TOOLCHAIN_PATH is ~/pri/tools/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64/bin.

For example, If you use the Raspberry PI 3 Model B arm board, If you installed the toolchain by referring to https://goo.gl/TtcjGb, you are installed toolchain path is pri.

# mkdir build
# cd build
# export OUT_PATH=./install
# export CROSS_COMPILE=${TOOLCHAIN_PATH}/arm-linux-gnueabihf-
# cmake .. -G "Unix Makefiles" \
  -DLIVE555_ENABLE_OPENSSL=OFF \
  -DCMAKE_VERBOSE_MAKEFILE=ON \
  -DCMAKE_BUILD_TYPE=release \
  -DCMAKE_C_COMPILER=${CROSS_COMPILE}gcc \
  -DCMAKE_CXX_COMPILER=${CROSS_COMPILE}g++ \
  -DCMAKE_INSTALL_PREFIX=${OUT_PATH} \
  -DCMAKE_STRIP=${CROSS_COMPILE}strip \
  -DCMAKE_AR=${CROSS_COMPILE}ar \
  -DCMAKE_LD=${CROSS_COMPILE}ld \
  -DCMAKE_RANLIB=${CROSS_COMPILE}ranlib  \
  -DCMAKE_NM=${CROSS_COMPILE}nm \
  -DCMAKE_OBJCOPY=${CROSS_COMPILE}objcopy \
  -DCMAKE_OBJDUMP=${CROSS_COMPILE}objdump \
  -DCMAKE_LINKER=${CROSS_COMPILE}ld
# make; make install

or If you have already toolchain file for cmake. You can be simplify with cmake file like this:

# cmake -B toolchain -G "Unix Makefiles" \
  -DLIVE555_BUILD_EXAMPLES=ON \
  -DCMAKE_TOOLCHAIN_FILE=/mnt/e/live555/toolchains/aarch64-linux-gnu.toolchain.cmake \
  -DLIVE555_ENABLE_OPENSSL=OFF
# cmake --build toolchain

Build with examples

If you want to build with RTSP Example from testProgs, you have to insert LIVE555_BUILD_EXAMPLES=ON option from cmake command like this:

# cmake .. -G "Visual Studio 15 2017" -DLIVE555_BUILD_EXAMPLES=ON

You can test with examples application. This examples connect to RTSP server with testRTSPClient application.

# ./testRTSPClient rtsp://admin:1@192.168.123.37/profile5/media.smp

Build using cmake file without Visual Studio IDE

You want to build without Visual Studio IDE or You want to build shared or static mode.

Visual Studio 2017

# mkdir build
# cd build
# cmake .. -B vs2017 -G "Visual Studio 15 2017"
# cmake --build vs2017 --config Release

Visual Studio 2019

# mkdir build
# cd build
# cmake .. -B vs2019 -G "Visual Studio 16 2019"
# cmake --build vs2019 --config Release

Visual Studio 2022

# mkdir build
# cd build
# cmake .. -B vs2022 -G "Visual Studio 17 2022"
# cmake --build vs2022 --config Release

Name		Name	Last commit message	Last commit date
Latest commit History 286 Commits
.github/workflows		.github/workflows
.vscode		.vscode
BasicUsageEnvironment		BasicUsageEnvironment
EpollTaskScheduler		EpollTaskScheduler
UsageEnvironment		UsageEnvironment
WindowsAudioInputDevice		WindowsAudioInputDevice
cmake		cmake
groupsock		groupsock
hlsProxy		hlsProxy
liveMedia		liveMedia
mediaServer		mediaServer
proxyServer		proxyServer
testProgs		testProgs
toolchains		toolchains
#config.macosx#		#config.macosx#
.gitattributes		.gitattributes
.gitignore		.gitignore
.project		.project
.travis.yml		.travis.yml
CMakeLists.txt		CMakeLists.txt
CMakeSettings.json		CMakeSettings.json
COPYING		COPYING
COPYING.LESSER		COPYING.LESSER
Makefile.head		Makefile.head
Makefile.tail		Makefile.tail
README		README
README.md		README.md
config.armeb-uclibc		config.armeb-uclibc
config.armlinux		config.armlinux
config.avr32-linux		config.avr32-linux
config.bfin-linux-uclibc		config.bfin-linux-uclibc
config.bfin-uclinux		config.bfin-uclinux
config.bsplinux		config.bsplinux
config.cris-axis-linux-gnu		config.cris-axis-linux-gnu
config.cygwin		config.cygwin
config.cygwin-for-vlc		config.cygwin-for-vlc
config.freebsd		config.freebsd
config.freebsd-no-openssl		config.freebsd-no-openssl
config.iphone-simulator		config.iphone-simulator
config.iphoneos		config.iphoneos
config.linux		config.linux
config.linux-64bit		config.linux-64bit
config.linux-gdb		config.linux-gdb
config.linux-gdb-sanitize		config.linux-gdb-sanitize
config.linux-no-openssl		config.linux-no-openssl
config.linux-with-shared-libraries		config.linux-with-shared-libraries
config.macosx-bigsur		config.macosx-bigsur
config.macosx-catalina		config.macosx-catalina
config.macosx-no-openssl		config.macosx-no-openssl
config.mingw		config.mingw
config.openbsd		config.openbsd
config.qnx4		config.qnx4
config.solaris-32bit		config.solaris-32bit
config.solaris-64bit		config.solaris-64bit
config.uClinux		config.uClinux
configure		configure
dummy.cpp		dummy.cpp
fix-makefile		fix-makefile
genMakefiles		genMakefiles
genWindowsMakefiles		genWindowsMakefiles
genWindowsMakefiles.cmd		genWindowsMakefiles.cmd
win32config		win32config
win32config.Borland		win32config.Borland

License

Licenses found

melchi45/live555

Folders and files

Latest commit

History

Repository files navigation

Live555

Generate build project using cmake

Build options

Generic shared library

Windows shared library with monolith

openssl on Windows environment

use the OpenSSL-Win32 or OpenSSL-Win64 binary

use the openssl on vcpkg

For Linux

For Windows 32 bit Windows from dos prompt

For Windows 64 bit Windows from dos prompt

For Windows ARM from from dos prompt