Linux and BSD packages

Distribution Installing
Arch Linux
# pacman -S streamlink
Arch Linux (aur, git)
# pacaur -S streamlink-git

Installing AUR packages

Debian (sid, testing)
# apt update
# apt install streamlink
Debian (stable)
# wget -qO- "" | apt-key add -
# echo "deb stretch-backports main" | tee "/etc/apt/sources.list.d/streamlink.list"
# apt update
# apt install streamlink
# dnf install streamlink
Gentoo Linux
# emerge net-misc/streamlink
NetBSD (pkgsrc)
$ cd /usr/pkgsrc/multimedia/streamlink
# make install clean
$ nix-env -iA nixos.streamlink

NixOS channel

$ sudo eopkg install streamlink
$ sudo add-apt-repository ppa:nilarimogard/webupd8
$ sudo apt update
$ sudo apt install streamlink
# xbps-install streamlink

Other platforms

Platform Installing
Mac OS X
# easy_install -U streamlink
# brew install streamlink

Installing Homebrew packages

Microsoft Windows See Windows binaries and Windows portable version.
C:\> choco install streamlink

Installing Chocolatey packages

Package maintainers

Distribution/Platform Maintainer
Arch Giancarlo Razzolini <grazzolini at>
Arch (aur, git) Josip Ponjavic <josipponjavic at>
Chocolatey Scott Walters <me at>
Debian Alexis Murzeau <amubtdx at>
Fedora Mohamed El Morabity <melmorabity at>
Gentoo soredake <fdsfgs at>
NetBSD Maya Rashish <maya at>
NixOS Tuomas Tynkkynen <tuomas.tynkkynen at>
Solus Bryan T. Meyers <bmeyers at>
Ubuntu Alin Andrei <andrew at>
Void wkuipers <wietse at>
Windows binaries beardypig <beardypig at>
Windows port. version RosadinTV <RosadinTV at>
beardypig <beardypig at>

Source code

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

There are a few different methods to do this, pip the Python package manager, or by checking out the latest code with Git. Using easy_install is no longer recommended.


For some Linux distributions the Python headers package needs to be installed before installing streamlink (python-devel in RedHat, Fedora, etc.).

Ensure that you are using an up-to-date version of pip, at least version 6 is recommended.

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

Version Installing
Latest release (pip)
# pip install -U streamlink
Latest release (easy_install)
# easy_install -U streamlink
Development version (pip)
# pip install -U git+
Development version (git)
$ git clone git://
$ cd streamlink
# python install


To install Streamlink from source you will need these dependencies.

Name Notes
Python At least version 2.7 or 3.4.
Automatically installed by the setup script
python-argparse Only needed on Python versions older than 2.7.
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.
pycryptodome Required to play some encrypted streams
iso-639 Used for localization settings, provides language information
iso3166 Used for localization settings, provides country information
isodate Used for MPEG-DASH streams
PySocks Used for SOCKS Proxies
websocket-client Used for some plugins
shutil_get_terminal_size Only needed on Python versions older than 3.3
shutil_which Only needed on Python versions older than 3.3
RTMPDump Required to play RTMP streams.
ffmpeg Required to play streams that are made up of separate audio and video streams, eg. YouTube 1080p+

Using pycrypto and pycountry

With these two environment variables it is possible to use pycrypto instead of pycryptodome and pycountry instead of iso-639 and iso3166.


Installing without root permissions

If you do not wish to install Streamlink 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 streamlink into the environment
(myenv)$ pip install streamlink

Using streamlink in the environment
(myenv)$ streamlink ...

Deactivating the environment
(myenv)$ deactivate

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


This may also be required on some OS X versions that seems to have weird permission issues.

Windows binaries


Windows XP is not supported.
Windows Vista requires at least SP2 to be installed.

Release Notes
Stable release Download the installer from the GitHub releases page.
Development build For testing purposes only! Updated once per day.
Download the installer from Bintray.
See the list of recent changes since the last stable release.

These installers contain:

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

and perform the following tasks:

  • Add Streamlink to the system's list of installed applications.
    An uninstaller will automatically be created during installation.
  • Add Streamlink's installation directory to the system's PATH environment variable.
    This allows the user to run the streamlink command globally from the command prompt or powershell without specifying its directory.

To build the installer on your own, NSIS and pynsist need to be installed.