Installation¶
Linux and BSD packages¶
Distribution | Installing |
---|---|
Arch Linux | # pacman -S streamlink
|
Arch Linux (aur, git) | # pacaur -S streamlink-git
|
Fedora | # dnf install streamlink
|
Gentoo Linux | # emerge net-misc/streamlink
|
NetBSD (pkgsrc) | $ cd /usr/pkgsrc/multimedia/streamlink
# make install clean
|
NixOS | Installing NixOS packages |
Solus | # eopkg install streamlink
|
Ubuntu | # add-apt-repository ppa:nilarimogard/webupd8
# apt update
# apt install streamlink
|
Void | # xbps-install streamlink
|
Other platforms¶
Platform | Installing |
---|---|
Mac OS X | # easy_install -U streamlink
|
Homebrew | # brew install streamlink
|
Microsoft Windows | See Windows binaries and Windows portable version. |
Chocolatey | C:\> choco install streamlink
|
Package maintainers¶
Distribution/Platform | Maintainer |
---|---|
Arch | Giancarlo Razzolini <grazzolini at archlinux.org> |
Arch (aur, git) | Josip Ponjavic <josipponjavic at gmail.com> |
Chocolatey | Scott Walters <me at scowalt.com> |
Fedora | Mohamed El Morabity <melmorabity at fedoraproject.org> |
Gentoo | soredake <fdsfgs at krutt.org> |
NetBSD | Maya Rashish <maya at netbsd.org> |
NixOS | Tuomas Tynkkynen <tuomas.tynkkynen at iki.fi> |
Solus | Bryan T. Meyers <bmeyers at datadrake.com> |
Ubuntu | Alin Andrei <andrew at webupd8.org> |
Void | wkuipers <wietse at kuiprs.nl> |
Windows binaries | beardypig <beardypig at protonmail.com> |
Windows port. version | RosadinTV |
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.
Note
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+https://github.com/streamlink/streamlink.git
|
Development version (git) | $ git clone git://github.com/streamlink/streamlink.git
$ cd streamlink
# python setup.py install
|
Dependencies¶
To install Streamlink from source you will need these dependencies.
Name | Notes |
---|---|
Python | At least version 2.7 or 3.3. |
python-setuptools | |
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 |
Optional | |
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.
$ export STREAMLINK_USE_PYCRYPTO="true"
$ export STREAMLINK_USE_PYCOUNTRY="true"
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 enviroment
(myenv)$ streamlink ...
Deactivating the enviroment
(myenv)$ deactivate
Using streamlink without activating the environment
$ ~/myenv/bin/streamlink ...
Note
This may also be required on some OS X versions that seems to have weird permission issues (see issue #401).
Windows binaries¶
Important
Windows XP is not supported. Windows Vista requires at least SP2 to be installed.
A Windows installer of the latest stable release can be found on the GitHub releases page.
Alternatively, a Windows installer of the latest development build for testing purposes is available, with a summary of the changes in the release notes. This development build is updated once per day, and a list of previous builds is provided.
This is an installer which contains:
- A compiled version of Streamlink that does not require an existing Python installation
- RTMPDump for viewing RTMP streams
- ffmpeg for muxing streams
and performs the following tasks:
- Adds Streamlink to your
$PATH
(making it possible to use streamlink directly from the command prompt without specifying its directory)
To build the installer, you need to have NSIS
and pynsist
installed on your
system.
Windows portable version¶
Instructions:
- Download https://github.com/streamlink/streamlink-portable/archive/master.zip
- Extract the “Streamlink for Windows (Compiled)” folder from the ZIP file
- Check README.txt file for requirements and run “Streamlink for Windows.exe”