Skip to content

Quick Start

The primary goal of this quick start tutorial is to introduce you to Flussonic Media Server. By the end of this tutorial you will learn how to:

Note

In this documentation, we will use placeholder IP addresses (or URLs) of the Flussonic server (such as FLUSSONIC-IP). Please replace placeholder IP addresses with the actual IP addresses used on your server.

Flussonic Media Server

Flussonic Media Server is software for video streaming server capable of a wide variety of tasks including mass storage, transcoding, live and on-demand video delivery and control over video consuming and video streams.

We will demonstrate all main scenarios using Flussonic web interface. However, if you prefer to use API, please refer to Flussonic API reference.

Installing Flussonic Media Server

Installation

This section briefly describes how to install Flussonic Media Server so that you can install it quickly.

To install and configure Flussonic Media Server, you will need a computer with Linux connected to the Internet, and a license or trial key. A trial key can be requested on this page.

The main requirement is that the system must be 64-bit. We strongly recommend using Ubuntu Server. You can find the whole list of system requirements here.

Note

Despite the fact that Flussonic Media Server will work on Ubuntu Desktop, we do not recommend using it, because Ubuntu Desktop has its own features with power management, energy saving, Network-manager and background updates, and other differences that may affect on performance. It is also possible that some third-party software and drivers may not work on it.

If you don't have an available suitable system at hand, you could rent a small cloud instance at Digital Ocean for the time needed to try out our software.

To install Flussonic Media Server you will need access to a Linux console as the 'root' user on your server.

Run the following command in the Linux console (command line):


curl -sSf https://flussonic.com/public/install.sh | sh

Then start Flussonic Media Server:


service flussonic start

Now you can open the Flussonic administrator's web interface in a web browser.

The first run of the Flussonic user interface (UI)

The Flussonic user interface is available at http://FLUSSONIC-IP:80/ (replace FLUSSONIC-IP with the real IP address of your server).

On the start page Flussonic asks you to enter the administrator's username and password and the license key that you have received.

Caution

Both login and password must NOT include any of the following characters: @, ;, #, [, \, /, =

flussonic ui

Checking the installation

You can check whether your Flussonic installation is correct by visiting http://FLUSSONIC-IP:80/, where FLUSSONIC-IP is the address of the server on which you installed the software. The Flussonic administrator's web interface opens if the installation was correct.

If the web interface failed to open, please check the details in the Installation section or contact Flussonic technical support.

See also:

Live streaming

Flussonic can receive streaming video in two main ways: acting as a client or a server.

When acting as a client, Flussonic connects to a video source to retrieve the data. When acting as a server, Flussonic waits for external systems to connect and then it receives video for publication. Here, we will describe ingesting video when Flussonic acts as a client.

A video source can be an IP camera, other video streaming server, a specialized program working with a DVB card, and almost any system that can stream video over the network. Flussonic supports all major video transfer protocols.

In addition, Flussonic can generate a sample video stream fake://fake. This stream can be used, for example, to test the system health.

To add a live stream, go to Media > click Add stream. Specify a stream name (demo) and a source URL (fake://fake). Click Create.

Creating live stream

Now open the address http://IP:80/demo/embed.html in the browser and see the result.

To view all the links for playing the stream via various protocols, go to Media > click the name of the created stream (demo) > go to the Output tab.

Live stream output

See also:

Publishing video

Publication is a process where an external system connects to Flussonic Media Server and initiates the transmission of streaming video to Flussonic Media Server. To make this possible, you will need to configure a stream or a publishing location on the Flussonic server where you allow publication.

This can be done in two ways depending on whether you know the stream name in advance or not.

You know the stream name

Let’s assume you know the name of the published stream in advance (e.g., published).

To allow the publication into a certain separate stream, go to Media > click Add stream. Specify a stream name (published) and a special publish:// option as a source URL. Click Create.

Adding a published stream

In this case you can publish the video stream via RTMP to this URL:

rtmp://FLUSSONIC-IP:1935/static/published

To view all the links for publishing video, go to Media > click the name of the created stream (published) > see the Published section on the Overview tab.

Publish links

Let's publish the video by using the RTMP protocol. We will use the file /opt/flussonic/priv/bunny.mp4 as a source (this file is already included into the distribution package). We will publish video by using a special command-line utility for working with video streams. This tool is installed as the rtmp_push package and located in the /opt/flussonic/contrib directory.

Run the following command:

/opt/flussonic/contrib/rtmp_push /opt/flussonic/priv/bunny.mp4 rtmp://FLUSSONIC-IP:1935/static/published

Publishing of the video will start. Play it back at the URL:

http://FLUSSONIC-IP:80/publishdemo/embed.html

You don't know the stream name

You will need to configure a template with a publication prefix where you allow publication. A single publishing location will be used to publish one or more streams. The prefix is used to form a stream name. The general structure for a stream name is as follows: PREFIX/STREAM_NAME.

To create a template go to Media > Templates > click Add template. Specify a template name (live-mylive) and a special publish:// option as a source URL. Click Create.

Template creation

Then click the name of the created template, and in Template settings specify a prefix (mylive). Then click Save and apply to streams.

Template prefix

If you configured the prefix mylive, then you must specify the stream name that starts with mylive/ in the URL, for example, mylive/bunny. The stream name that goes after the prefix is defined by the client app that publishes video.

Let's transmit video by using the RTMP protocol. We will use the file /opt/flussonic/priv/bunny.mp4 as a source (this file is already included into the distribution package). Run the following command:

/opt/flussonic/contrib/rtmp_push /opt/flussonic/priv/bunny.mp4 rtmp://FLUSSONIC-IP:1935/mylive/bunny

Publishing will start. On the Media tab, you can see a stream for publishing that is automatically generated from the template:

Published template stream

To see the result, open this address in the browser:

http://FLUSSONIC-IP:80/mylive/bunny/embed.html

See also:

  • Refer to the Publishing section to learn more about publishing video streams to Flussonic.

File playback

In this section you will learn how to play a video file using Flussonic. For playing files, Flussonic uses VOD (Video On Demand) service — an integral part of services based on video delivery. To play a file, you will need to:

  • Set up file location
  • Upload a file
  • Open the file in a player

Setting up a file location

Flussonic doesn't have a predefined location for files. You can store video files in different paths on your disk. And you will need to explicitly specify where the system should find them.

For this, you need to add a VOD location and to specify how the path in requests for the file playback should match the real file on the disk or in an HTTP repository. Based on these settings, Flussonic defines the path to a file. This path will be used in requests for playing back the file via various protocols.

To add a VOD location, go to Media > VODs > click Add VOD > enter VOD name (vod1) and File directory path (/storage) > click Create.

Add VOD location

Now Flussonic knows that when clients request vod1/movies/bunny.mp4, it will need to access the file /storage/movies/bunny.mp4. In other words, everything after the prefix vod1 will be cut and added to the specified path on the disk (that starts with /storage in our example).

Uploading a file

Now you can upload the file you have prepared to the directory /storage.

The Flussonic distribution package includes a test file /opt/flussonic/priv/bunny.mp4.

If you do not have this video, you can download freely available Big Buck Bunny video clip:


mkdir -p /storage
cd /storage
curl -o bunny.mp4 https://download.atmark-techno.com/sample/bbb/big-buck-bunny-30sec-fullhd.mp4

To upload the file via Flussonic UI, go to Media > VODs > click the name of the created VOD location (vod1) > click browse > click Upload Files > select the file to upload (bunny.mp4).

Upload file

Playing the file

Open this link: http://FLUSSONIC-IP:80/vod1/bunny.mp4/embed.html and watch the video.

To view all other links for playing the file, go to Media > VODs > click the name of the created VOD location (vod1) > click browse > click the name of the file. Below you will see the embedded player for playing the file, the HTML code for using in a player on your site or in your application, and the list of the links for playing the file via various protocols.

Play file

See also:

  • Learn more about video files in the VOD Files page.