内容简介:NymphCast is a software solution which turns your choice of Linux-capable hardware into an audio and video source for a television or powered speakers. It enables the streaming of audio and video over the network from a wide range of client devices, as wel
NymphCast
NymphCast is a software solution which turns your choice of Linux-capable hardware into an audio and video source for a television or powered speakers. It enables the streaming of audio and video over the network from a wide range of client devices, as well as the streaming of internet media to a NymphCast server, controlled by a client device.
In addition, it supports powerful apps (NymphCast apps) written in AngelScript to extend the functionality of NymphCast with a variety of online services.
Goals
-
Server (receiver) works on mainstream Linux-capable Single-Board Computers (SBCs), tested on Raspberry Pi 2 (v1.1).
-
Streaming of local media to a NymphCast server.
-
Sending of URLs, for streaming by the server without client interaction.
-
Sending of commands, to control volume, open and control NymphCast apps.
Project layout
The layout of relevant folders in the project is as follows:
/ |- player (the NymphCast demonstration client) |- src/ | |- client (basic NymphCast client, for testing) | |- client_lib (NymphCast SDK files) | |- server (the NymphCast server and NymphCast app files) |- tools (shell scripts for creating releases, in progress)
Player
The NymphCast Player is provided as a demonstration of the NymphCast SDK (see details on the SDK later in the document), allowing one to make use of the basic NymphCast functionality. It is designed to run on any mainstream desktop OS, as well as Android-based smartphones and tablets.
An APK has been made available for installation on Android in the 'releases' section. A desktop release for Windows (x64) is available as well.
Quick Start
This quick start guide assumes building the receiver ( server ) project on a system (like a Raspberry Pi) running a current version of Debian (Buster) or equivalent. The player application can be built on Linux/BSD/MacOS with a current GCC toolchain, or MSYS2 on Windows with MinGW toolchain.
Server
Here two options are possible:
setup.sh install_linux.sh
Or:
- Follow the instructions in the 'Building' section.
Player
For Windows (x64):
- Download and extract the binary release.
Or (Windows & other platforms):
- Build the libnymphcast library in the
src/client_lib
folder using the Makefile in that folder:make lib
. - Install the newly created library under
lib/
into/usr/local/lib
or equivalent. - Copy the
nymphcast_client.h
header to/usr/local/include
or equivalent. - Ensure the Qt5 dependency is installed.
- Create
player/NymphCastPlayer/build
folder and change into it. - Execute
qmake ..
followed bymake
. - Binary is created either in the same build folder or in a
debug/
sub-folder. - Execute the binary to open the player.
- Connect to the server instance using its IP address.
- Cast a media file or URL.
Platforms
The server targets SBCs, but like the client (and SDK) should work on any platform that supports a C++17 toolchain and is supported by the LibPoco dependency:
- Windows XP+
- MacOS
- Linux (desktop & embedded)
- Solaris
- *BSD
- HP-UX
- AIX
- QNX
- VxWorks
- Android
- iOS
- Windows Embedded
The server relies on the FFmpeg library, which is supported on a wide variety of platforms, with Linux, MacOS and Windows being the primary platforms.
Releases
NymphCast is currently in Alpha stage, with experimental releases being made available on Github (see the ' releases ' section).
Building
To build NymphCast, one needs the following dependencies in addition to a C++ toolchain with C++17 support.
Run the Makefile in the client
and server
folders, which should output a binary into the newly created bin/
folder.
Server:
Dependencies:
On Debian & derivatives:
- Install the needed dependencies:
sudo apt -y install libsdl2-image-dev libsdl2-dev libpoco-dev
andsudo apt -y install libswscale-dev libavcodec-dev libavdevice-dev libavformat-dev libavutil-dev libpostproc-dev libswresample-dev
- Check-out NymphRPC elsewhere and build the library with
make lib
. - Copy the NymphRPC library from
NymphRPC/lib/
to/usr/local/lib
. - Create
/usr/local/include/nymph
folder. Performsudo cp src/*.h /usr/local/include/nymph
. - Change to
NymphCast/src/server
and executemake
command. - The server binary is found under
bin/
. Copy the *.jpg images into the bin folder for the screensaver feature. - Copy the
nymphcast_config.ini
file intobin/
as well. - Copy the
apps/
folder into thebin/
' folder. - Simply execute the binary to have it start listening on port 4004:
./nymphcast_server -c nymphcast_config.ini
.
Client dependencies
- NymphRPC
- LibPOCO (1.5+)
Running
The server binary can be started as-is, and will listen on all network interfaces for incoming connections.
The client binary has to be provided with the filename of a media file that should be sent to the remote server, with an optional IP address of the remote server:
$ nymphcast_client <filename> $ nymphcast_client <IP> <filename>
Limitations
- The server is assumed to have 100 MB heap space free for caching.
- Remote seeking support is not enabled yet, meaning MP4 files <100 MB with the header at the end do not work yet.
SDK
An SDK has been made available in the src/client_lib/
folder. The player project under player/
uses the SDK as part of a Qt5 project to implement a NymphCast client which exposes all of the NymphCast features to the user.
To use the SDK, the Makefile in the SDK folder can be executed with a simple make
command, after which a library file can be found in the src/client_lib/lib
folder.
Note:to compile the SDK, both NymphRPC and LibPOCO (1.5+) must be installed.
After this the only files needed by a client project are this library file and the nymphcast_client.h
header file.
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
Linux内核完全剖析
赵炯 / 机械工业出版社 / 2006-1 / 79.00元
本书对早期Linux操作系统内核全部代友文件进行了详细的剖析,旨在让读者在尽量短的时间内对Linux的工作机理获得全面而深刻的理解,为进一步学习和研究Linux系统打下坚实的基础。虽然选择的版本较低,但该内核已能够正常编译运行,并且其中已包括了Linux工作原理的精髓。书中首先以Linux源代码版本的变迁为主线,简要介绍了Lin-ux系统的发展历史,同时着重说明了各个内核版本之间的主要区别和改进方......一起来看看 《Linux内核完全剖析》 这本书的介绍吧!