Installation

Linux and BSD packages

Distribution Installing
Arch Linux (package)
# pacman -S livestreamer
Arch Linux (aur, git) Installing AUR packages
CRUX
$ cd /usr/ports/contrib/livestreamer
# pkgmk -d -i
Debian Jessie (testing)
# apt-get install livestreamer
Debian Sid (unstable)
# apt-get install livestreamer
Exherbo Linux  
FreeBSD (package)
# pkg install multimedia/livestreamer
FreeBSD (ports)
$ cd /usr/ports/multimedia/livestreamer
# make install clean
Gentoo Linux
# emerge net-misc/livestreamer
OpenBSD (package)
# pkg_add livestreamer
OpenBSD (ports)
$ cd /usr/ports/multimedia/livestreamer
# make install clean
Slackware Linux Installing Slackbuilds
Ubuntu Utopic
# apt-get install livestreamer

Other platforms

Platform Installing
Mac OS X
# easy_install -U livestreamer
Microsoft Windows See Windows binaries.

Source code

If a package is not available for your platform (or it’s out of date) you can install Livestreamer via source.

There are a few different methods to do this, pip the Python package manager, easy_install the older package manager included with python-setuptools or by checking out the latest code with Git.

The commands listed here will also upgrade any existing version of Livestreamer.

Version Installing
Latest release (pip)
# pip install -U livestreamer
Latest release (easy_install)
# easy_install -U livestreamer
Development version (pip)
# pip install -U git+https://github.com/chrippa/livestreamer.git
Development version (git)
$ git clone git://github.com/chrippa/livestreamer.git
$ cd livestreamer
# python setup.py install

Dependencies

To install Livestreamer from source you will need these dependencies.

Name Notes
Python At least version 2.6 or 3.3.
python-setuptools  
Automatically installed by the setup script
python-argparse Only needed on Python 2.6.
python-futures Only needed on Python 2.x.
python-requests At least version 1.0.
python-singledispatch Only needed on Python versions older than 3.4.
Optional
RTMPDump Required to play RTMP streams.
PyCrypto Required to play some encrypted streams.
python-librtmp Required by the ustreamtv plugin to be able to use non-mobile streams.

Installing without root permissions

If you do not wish to install Livestreamer globally on your system it’s recommended to use virtualenv to create a user owned Python environment instead.

Creating an environment
$ virtualenv ~/myenv

Activating the environment
$ source ~/myenv/bin/activate

Installing livestreamer into the environment
(myenv)$ pip install livestreamer

Using livestreamer in the enviroment
(myenv)$ livestreamer ...

Deactivating the enviroment
(myenv)$ deactivate

Using livestreamer without activating the environment
$ ~/myenv/bin/livestreamer ...

Note

This may also be required on some OS X versions that seems to have weird permission issues (see issue #401).

Windows binaries

Installer

This is a installer which contains:

  • A compiled version of Livestreamer that does not require an existing Python installation
  • RTMPDump for viewing RTMP streams

and performs the following tasks:

  • Generates a default configuration file
  • Adds Livestreamer to your $PATH (making it possible to use livestreamer directly from the command prompt without specifying its directory)

Zip archive

This is minimal zip archive containing a compiled version of Livestreamer that does not require an existing Python installation.

Nightly build

This is an automatically generated build of the latest development code from the git repo.

Note

The binaries requires Microsoft Visual C++ 2008 Redistributable Package to be installed.