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

Install Transcoder for Nimble Streamer on Ubuntu

Add Transcoder repository

For Ubuntu 14.04 Trusty run:

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 -

For Ubuntu 15.04 Vivid Vervet and 15.10 Wily Werewolf run:
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 -

For Ubuntu 16.04 Xenial Xerus run:
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 -

For Ubuntu 18.04 Bionic Beaver run:
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 -

For Ubuntu 20.04 Focal Fossa run:
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 -

For Ubuntu 22.04 Jammy Jellyfish run:
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

For Ubuntu 24.04 run:
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 -

Install Transcoder for Nimble Streamer on Debian

Add Transcoder repository

Debian 7 wheezy:

grep -qF "nimblestreamer" /etc/apt/sources.list || echo "deb http://nimblestreamer.com/debian/ wheezy/" | sudo tee -a /etc/apt/sources.list
wget -q -O - http://nimblestreamer.com/gpg.key | apt-key add -
Debian 8 jessie:
grep -qF "nimblestreamer" /etc/apt/sources.list || echo "deb http://nimblestreamer.com/debian/ jessie/" | sudo tee -a /etc/apt/sources.list
wget -q -O - http://nimblestreamer.com/gpg.key | apt-key add -
Debian 9 stretch:
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 -
Debian 12 bookworm:
sudo curl -o /etc/apt/sources.list.d/nimble.sources https://nimblestreamer.com/debian/nimble-bookworm.sources

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 | apt-key add -

Install Transcoder for Nimble Streamer on CentOS 7

Install Transcoder package

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 installing 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

Install Transcoder for Nimble Streamer on Red Hat Enterprise Linux 6 / CentOS 6

Install Transcoder package

Install RHEL EPEL repository

wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
wget http://rpms.famillecollet.com/enterprise/remi-release-6.rpm
sudo rpm -Uvh remi-release-6*.rpm epel-release-6*.rpm
Create file /etc/yum.repos.d/nimble.repo with following content:
[nimble]
name= Nimble Streamer repository
baseurl=http://nimblestreamer.com/centos/6/$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

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

Install Transcoder for Nimble Streamer on Red Hat 9 / Rocky Linux 9 / AlmaLinux 9

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

Install Transcoder for Nimble Streamer on Raspbian at Raspberry Pi / Orange Pi

Install Transcoder package

Add following rep into /etc/apt/sources.list
For Raspbian 9 (Stretch) and Raspbian 10 (Buster) 32-bit (armhf):

deb http://nimblestreamer.com/raspbian/ stretch/
For Raspbian 10 (Buster) 64-bit (arm64):
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 -

Install Transcoder for Nimble Streamer on Windows

Install Nimble Streamer if not installed

Follow Nimble Streamer installation instruction

Install Transcoder package

Download Nimble Streamer Transcoder installer

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

Nimble Streamer 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.

Further usage

Please check Transcode documentation reference for more infromation about setup and usage.

Also take a look at Live Transcoder YouTube playlist to see some step-by-step instructions.

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.