-
Notifications
You must be signed in to change notification settings - Fork 349
Home
C++11 evented IO for real-time video streaming and high performance networking applications
Language: C++
Homepage: http://sourcey.com/libsourcey
LibSourcey is a collection of open source cross platform C++11 modules and classes which provide developers with a flexible high performance arsenal for the rapid development of real-time messaging and live media streaming applications.
LibSourcey was been used in private production by Sourcey since 2005, and was open sourced in 2013 under the LGPL licence to promote development of real-time native and web applications.
Since version 0.92, C++11 and event-based asynchronous IO powered by Node.js's underlying libuv library are utilised throughout LibSourcey in to maximise performance and minimise concurrency reliance for building mission critical server-side applications.
LibSourcey provides a simple and flexible method of capturing live audio/video streams (OpenCV/FFmpeg), processing, filtering and encoding them using any video format (FFmpeg), and broadcasting the result over the Internet (libuv). This is made possible by implementing a thin layer over the top of some brilliant open source projects, such as FFmpeg, OpenCV and libuv. The only required third-party dependency is libuv, and that is included in the local source and compiled automatically. All others dependencies are optional.
LibSourcey has full support for the following protocols: TCP, SSL, UDP, HTTP, JSON, XML, STUN, SDP, SocketIO. Partial or non-standard support is implemented for the following protocols: WebSockets, TURN, ICE, RTP, and XMPP.
Required: libuv, cmake, C++11 compiler Optional: FFmpeg, OpenCV, WebRTC, OpenSSL (> 1.0.1g), RtAudio, JsonCpp
The following modules are included in the public LibSourcey repository:
dependencies: libuv Re-usable utility classes and interfaces used throughout LibSourcey.
dependencies: libuv, OpenSSL TCP, SSL and UDL socket implementation build on top of libuv architecture.
dependencies: libuv, JsonCpp HTTP server and client stack including support for WebSockets, multipart streaming, and file transfers.
dependencies: libuv, OpenCV, FFmpeg, RtAudio Wrappers around FFmpeg and OpenCV for device capture, encoding, recording and streaming. The Media API makes extensive use of the PacketStream classes so that encoders, processors and packetisers can be dynamically added and removed from a media source.
RFC 5389 implementation which includes support for ICE and TURN and TURN TCP messages.
dependencies: libuv Server and client stack which supports both RFC 5766 (Traversal Using Relays around NAT) and RFC 6062 (Traversal Using Relays around NAT Extensions for TCP Allocations) specifications.
RFC 4566 implementation which includes extra support for ICE headers.
dependencies: libuv, JsonCpp SocketIO C++ client. Read more about SocketIO.
dependencies: libuv, JsonCpp Client implementation of Sourcey's home grown real time messaging and presence protocol. More about Symple.
dependencies: libuv UVPP is a set of C++ wrappers for Joyent's fantastic libuv library.
dependencies: JsonCpp Thin wrappers and helper functions for the JsonCpp library.
The following closed source modules are available. Please contact us if you are interested in using any of them in your projects.
dependencies: libuv The ICE module is a complete implementation of RFC 5245 (Interactive Connectivity Establishment) based on LibSourcey architecture. ICE is a protocol for Network Address Translator (NAT) Traversal for Offer/Answer protocols. This module is currently not open source. Please contact us if you are interested in using it.
dependencies: libuv Our RTP module is quite basic. At this point it only supports RTP and RTCP packetisation. RTCP session management still needs to implemented. If anyone happens to make a project of this we would be very happy to improve our RTP module.
dependencies: pugixml Very thin wrappers around the pugixml XML library to better support LibSourcey architecture.
dependencies: pugixml, libstrophe Our XMPP module includes a client with full Jingle session support. This module has been neglected for a while now in favor of other projects. Any bugfixes and improvements are welcome.
The following LibSourcey modules are available in external repositories.
dependencies: libuv, OpevCV The Anionu SDK includes a C++ API, tools, and client implementation for building Spot plugins and applications that integrate with the Anionu cloud surveillance serivice.
dependencies: libuv, JsonCpp Pacm is an embeddable package manager which speaks JSON with the server. More about Pacm.
Install Git : * Windows users: Install TortoiseGit, a convenient git front-end, which integrates right into Windows Explorer. MinGW users can use msysgit.
Linux users: Install command-line git utility using your package manager, e.g. apt-get install git on Ubuntu and Debian. You can use SmartGit as a GUI client. SmartGit is cross-platform, btw.
Mac users: If you installed Xcode (which you will need anyway) then you already have git. You can use SourceTree, which is a very good GUI client.
Install CMake : CMake generates the LibSourcey project files so you can build on most platforms and compilers. CMake is also required to generate makefiles for OpenCV. Download CMake
Install OpenSSL : * Windows users: download and install the Windows OpenSSL binaries.
Linux users: Install the openssl package (if you don't already have it), ensuring the get the libssl-dev package which contains the developemnt headers: apt-get install openssl libssl-dev
Download LibSourcey : Clone the repository: git clone https://github.com/sourcey/libsourcey.git. If you haven't got Git for some reason you can download and extract the package archive from Github.
Depending on your platform, you may choose run CMake from the command line, or use the CMake GUI.
#dependencies: openssl libssl-dev cmake pkg-config
#optional: libjack-jackd2-dev
git clone https://github.com/sourcey/libsourcey.git
cd libsourcey
mkdir -p build
cmake .. -DCMAKE_BUILD_TYPE=RELEASE # extra cmake commands here...
make
make install
If you use CMake GUI, execute "Configure" to do the initial configuration, then adjust any options, then press "Configure" again and then press "Generate".
The main build options you will want to configure are as follows:
- BUILD_SHARED_LIBS: Build shared libraries (.dll/.so) instead of static ones (.lib/.a). default: NOT (WIN32 OR ANDROID OR IOS)
- BUILD_DEPENDENCIES: Build LibSourcey in source third-party dependencies. default: ON
- BUILD_MODULES: Build LibSourcey modules. default: ON
- BUILD_MODULE_xxx: Enable or disable a specific module replacing xxx with the module name.
- BUILD_APPLICATIONS: Build LibSourcey modules default: ON
- BUILD_APPLICATION_xxx: Enable or disable a specific applications replacing xxx with the module name.
- BUILD_MODULE_TESTS: Build module test applications default: OFF
- BUILD_MODULES_xxx: Enable or disable a specific module replacing xxx with the module name.
- BUILD_MODULE_SAMPLES: Build module sample applications default: OFF
If you are using third-party libraries is custom locations then make sure you update the CMake include paths: CMAKE_SYSTEM_PREFIX_PATH and CMAKE_LIBRARY_PATH. The only third-party libraries that may need configuring if you're using them are FFmpeg, OpenCV and WebRTC.
For an exhaustive list of options check the CMakeLists.txt in the main directory.
Compiling with Visual Studio
- Generate solutions using CMake, as described above. Make sure, you chose the proper generator (32-bit or 64-bit)
- Launch Visual Studio, locate and open the "LibSourcey.sln" solution file in your generated build folder (eg: C:\LibSourcey\build\LibSourcey.sln). Select "Debug" configuration, build the solution (Ctrl-Shift-B), and/or select "Release" and build it.
- Add {CMAKE_BINARY_DIR}\bin\Release, {CMAKE_BINARY_DIR}\bin\Debug (containing "LibSourcey.dll" and "LibSourceyd.dll", respectively) to the system path (My Computer--[Right button click]->Properties->Advanced->Environment Variables->Path)
Compiling with GCC (MinGW, MSYS, Linux)
- Generate makefiles using CMake (choose "MinGW Makefiles" generator on Windows, "Unix Makefiles" on other OSes) as described above.
- Enter the output CMake directory (denoted as {CMAKE_BINARY_DIR} further) and type make -j [optional_number_of_threads] on Unix, or mingw32-makeon for MinGW. Windows users can also run parallel build of LibSourcey. To do that, please, define "SHELL" environment variable (My Computer--[Right button click]->Properties->Advanced->Environment Variables->Path) and set it to "cmd.exe" (without quotes). Then you can run mingw32-make -j (note that "-j" must go without any numerical parameter).
- Linux, MacOSX Then you can optionally run sudo make install (on Linux or MacOSX). Note, that if you are using CMake for your projects, it is not necessary to run make install. Just use LibSourcey from where you built it. This is actually the recommended approach, since it does not pollute system directories with potentially conflicting LibSourcey versions.
- Windows If you built LibSourcey as dynamic libraries (DLLs), you may want to add {CMAKE_BINARY_DIR}\bin to the system path (My Computer--[Right button click]->Properties->Advanced->Environment Variables->Path) to let Windows find "scy*.dll" etc.)
Compile with Xcode
- Generate Xcode project using CMake, as described above.
- Launch Xcode, locate and open LibSourcey.xcodeproj. Select "Debug", build the BUILD_ALL target (Cmd-B), select "Release" and build it too.
There is also plenty of examples available in the samples and tests folder of each module for you to sink your teeth into. Also, check out the PacketStream API article to get a feel for the LibSourcey way of doing things.
- Fork LibSourcey on Github
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create new Pull Request
If you find any bugs or issues please use the new Github issue tracker..