Efficient tools to build your streaming infrastructure


Installing Live Transcoder

Nimble Streamer Live Transcoder installation

Please notice that Nimble Streamer Transcoder is only available for 64-bit systems.
If Nimble Streamer is not available in the system, it will be installed.


This is an installation procedure for Live Transcoder package for Nimble Streamer which is required to make transcoding work.
Nimble Streamer installation is described here as it's a separate procedure.

Obtain a license

Before installing the transcoder and server, you need to have WMSPanel account. Just sign up to get your account if you still don't have one.

Any Transcoder instance requires an active subscription which is available on a monthly basis. Check the pricing page for detailed description of the pricing terms.
Being logged into WMSPanel, click on "Transcoders" top menu and click on "Manage transcoder licenses" button. Follow instructions on that page to proceed with payments.

You will get a license key which will be used during further installation.

Choose your operating system to get proper instructions:


Run the following command to add Nimble Streamer repository:

sudo curl -o /etc/apt/sources.list.d/nimble.sources https://nimblestreamer.com/ubuntu/nimble-26.04.sources


Install Transcoder package

sudo apt-get update
sudo apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

sudo apt-get update
sudo apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -

Run the following command to add Nimble Streamer repository:

sudo curl -o /etc/apt/sources.list.d/nimble.sources https://nimblestreamer.com/ubuntu/nimble.sources


Install Transcoder package

sudo apt-get update
sudo apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

sudo apt-get update
sudo apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -

Run the following command to add Nimble Streamer repository:

sudo bash -c 'echo -e "deb http://nimblestreamer.com/ubuntu jammy/" > /etc/apt/sources.list.d/nimble.list'
wget -q -O - http://nimblestreamer.com/gpg.key | sudo tee /etc/apt/trusted.gpg.d/nimble.asc


Install Transcoder package

sudo apt-get update
sudo apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

sudo apt-get update
sudo apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -

Run the following command to add Nimble Streamer repository:

grep -qF "nimblestreamer" /etc/apt/sources.list || echo "deb http://nimblestreamer.com/ubuntu focal/" | sudo tee -a /etc/apt/sources.list
wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -


Install Transcoder package

sudo apt-get update
sudo apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

sudo apt-get update
sudo apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -

Run the following command to add Nimble Streamer repository:

grep -qF "nimblestreamer" /etc/apt/sources.list || echo "deb http://nimblestreamer.com/ubuntu bionic/" | sudo tee -a /etc/apt/sources.list
wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -


Install Transcoder package

sudo apt-get update
sudo apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

sudo apt-get update
sudo apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -

Run the following command to add Nimble Streamer repository:

grep -qF "nimblestreamer" /etc/apt/sources.list || echo "deb http://nimblestreamer.com/ubuntu xenial/" | sudo tee -a /etc/apt/sources.list
wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -


Install Transcoder package

sudo apt-get update
sudo apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

sudo apt-get update
sudo apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -

Run the following command to add Nimble Streamer repository:

grep -qxF "deb http://us.archive.ubuntu.com/ubuntu/ trusty main restricted" /etc/apt/sources.list || echo "deb http://us.archive.ubuntu.com/ubuntu/ trusty main restricted" | sudo tee -a /etc/apt/sources.list
grep -qF "nimblestreamer" /etc/apt/sources.list || echo "deb http://nimblestreamer.com/ubuntu trusty/" | sudo tee -a /etc/apt/sources.list
wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -


Install Transcoder package

sudo apt-get update
sudo apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

sudo apt-get update
sudo apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -

Run the following command to add Nimble Streamer repository:

sudo curl -o /etc/apt/sources.list.d/nimble.sources https://nimblestreamer.com/debian/nimble-bookworm.sources


Install Transcoder package

sudo apt-get update
sudo apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

sudo apt-get update
sudo apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -

Run the following command to add Nimble Streamer repository:

grep -qF "nimblestreamer" /etc/apt/sources.list || echo "deb http://nimblestreamer.com/debian/ stretch/" | sudo tee -a /etc/apt/sources.list
wget -q -O - http://nimblestreamer.com/gpg.key | apt-key add -


Install Transcoder package

apt-get update
apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

apt-get update
apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -

Create file /etc/yum.repos.d/nimble.repo with following content:

[nimble]
name= Nimble Streamer repository
baseurl=http://nimblestreamer.com/centos/7/$basearch
enabled=1
gpgcheck=1
gpgkey=http://nimblestreamer.com/gpg.key
Run:
sudo yum update
sudo yum install nimble-transcoder
The installer will prompt to install a signature key and a package. Just type "y".
Is this ok [y/N]: y


Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Installation error

You may get messages like this after launching "sudo yum install nimble-transcoder" command:

Error: Package: nimble-transcoder-1.0.8-1.el7.centos.x86_64 (nimble)
Requires: libva-drm.so.1()(64bit)
Error: Package: nimble-transcoder-1.0.8-1.el7.centos.x86_64 (nimble)
Requires: libva.so.1(VA_API_0.33.0)(64bit)
Error: Package: nimble-transcoder-1.0.8-1.el7.centos.x86_64 (nimble)
Requires: libva.so.1()(64bit)
You need to add EPEL repository to your server. Run these commands:
yum -y install epel-release
yum repolist
Then try to install Transcoder again.


Upgrading Transcoder

sudo yum makecache
sudo yum install nimble-transcoder
sudo service nimble restart

If you get an error about unknown GPG key import Nimble Repository public key, add the following line to /etc/yum.repos.d/nimble.repo:

gpgcheck=1 gpgkey=http://nimblestreamer.com/gpg.key

Run the following command to add Nimble Streamer repository:

sudo bash -c 'echo -e "[nimble]\nname= Nimble Streamer repository\nbaseurl=https://nimblestreamer.com/rocky/9/\$basearch\nenabled=1\ngpgcheck=1\ngpgkey=https://nimblestreamer.com/gpg-sha512.key\n" > /etc/yum.repos.d/nimble.repo'

Run installation commands:

sudo dnf makecache
sudo dnf install nimble-transcoder

The installer will prompt to install a signature key and a package. Just type "y".

Is this ok [y/N]: y

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.

Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo systemctl restart nimble

Upgrading Transcoder

sudo dnf makecache
sudo dnf install nimble-transcoder
sudo systemctl restart nimble

If you get an error about unknown GPG key import Nimble Repository public key, add the following line to /etc/yum.repos.d/nimble.repo:

gpgcheck=1 gpgkey=https://nimblestreamer.com/gpg-sha512.key

Add following rep into /etc/apt/sources.list

deb http://nimblestreamer.com/raspbian/ buster/

Run:

wget -q -O - http://nimblestreamer.com/gpg.key | apt-key add -
apt-get update
apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

apt-get update
apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | apt-key add -

Add following rep into /etc/apt/sources.list

deb http://nimblestreamer.com/raspbian/ stretch/

Run:

wget -q -O - http://nimblestreamer.com/gpg.key | apt-key add -
apt-get update
apt-get install nimble-transcoder

Register transcoder instance in WMSPanel

sudo /usr/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.

Later on you can move license between transcoder instances by re-registering license on a new server.


Optional: Restart server

If Nimble Streamer is already present in the system, you don't need to restart anything, the transcoder instance will be linked dynamically.

If Nimble has just been installed, you need to re-start it.

sudo service nimble restart

Upgrading Transcoder

apt-get update
apt-get install nimble-transcoder

If you get an error about unknown GPG key import Nimble Repository public key, use the following command:

wget -q -O - http://nimblestreamer.com/gpg.key | apt-key add -

Install Nimble Streamer if not installed

Follow Nimble Streamer installation instruction


Install Transcoder package


Launch the installer and follow setup wizard steps.


Register Transcoder in WMSPanel

Windows 8.1 / Windows 10:

Search for "Register Nimble Streamer Transcoder" in the Windows 8 Start menu

Windows 7 / Windows Server 2003/2008/2012/2016:

Use "Start" -> "All Programs" -> "Nimble Streamer" -> "Register Nimble Streamer Transcoder" menu

Transcoder will become available in the panel immediately.
If you got "Unable to find writable nimble.conf file" message than you need to right-click on "Register Nimble Streamer" and select "Run as Administrator".


Upgrading Transcoder

  1. Run this command to stop Nimble Streamer
    net stop NimbleStreamer
  2. Download and install the latest available Transcoder Windows package using instruction above.
  3. Run this command to start Nimble Streamer
    net start NimbleStreamer

Use Docker

Live Transcoder package is not available for macOS so we provide another approach based on Docker usage.
Install Nimble Streamer with SRT on MacOS using Docker describes the setup process.


Register transcoder instance in WMSPanel

Log into your Docker container and use this command:

sudo /usr/local/nimble/bin/nimble_regutil --transcoder-license <transcoder_license_key>

You will be asked for your WMSPanel login and password sent to you during sign up in WMSPanel.


Troubleshooting

Take a look at Troubleshooting Live Transcoder article to see some known corner cases and their resolution.




This software uses code of FFmpeg licensed under the LGPLv2.1 and its sources and build script can be downloaded here.
This software uses code of LAME MP3 licensed under the LGPL and its source and build script can be downloaded here.
This software uses libsvthevc library licensed under this license. Copyright (c) 2018 Intel Corporation
Covered by one or more claims of the patents listed at "patentlist.hevcadvance.com".
Read more on licensing page.