Streamlink

A Python library and command-line interface which pipes streams from various services into a video player.
Avoid resource-heavy and unoptimized websites, and still enjoy streamed content.

Streamlink was forked in 2016 from the abandoned Livestreamer project.

📦 Installation

Please take a look at the documentation for different ways of installing Streamlink:

• [Windows][streamlink-installation-windows]
• [macOS][streamlink-installation-macos]
• [Linux and BSD][streamlink-installation-linux-and-bsd]
• [PyPI package and source code][streamlink-installation-pypi-source]

👍 Features

Streamlink is built on top of a plugin system which allows support for new services to be added easily.
Most of the popular streaming services are supported, such as Twitch, YouTube, and many more.

A list of all plugins currently included can be found on the [plugins page][streamlink-plugins].

💡 Quickstart

After installing, simply run:

sh
streamlink "STREAMURL" best

The default behavior of Streamlink is to play back streams in the [VLC player][player-vlc], but a lot of other options and output methods are available, such as writing the stream to the filesystem, reading stream metadata, etc.

For more in-depth usage, please refer to the [CLI documentation][streamlink-documentation-cli].

An [API guide][streamlink-documentation-apiguide] and [API reference][streamlink-documentation-apiref] is available for Python implementors of Streamlink.

🙏 Contributing

All contributions are welcome.
Feel free to open a new thread on the issue tracker or submit a new pull request.
Please read [CONTRIBUTING.md][contributing] first. Thanks!

❤️ Support

If you think that Streamlink is useful and if you want to keep the project alive, then please consider supporting its maintainers by sending a small and optionally recurring tip via the [available options][support].
Your support is very much appreciated, thank you!

[streamlink-installation-windows]: https://streamlink.github.io/install.html#windows
[streamlink-installation-macos]: https://streamlink.github.io/install.html#macos
[streamlink-installation-linux-and-bsd]: https://streamlink.github.io/install.html#linux-and-bsd
[streamlink-installation-pypi-source]: https://streamlink.github.io/install.html#pypi-package-and-source-code
[streamlink-documentation-cli]: https://streamlink.github.io/cli.html
[streamlink-documentation-apiguide]: https://streamlink.github.io/api_guide.html
[streamlink-documentation-apiref]: https://streamlink.github.io/api.html
[streamlink-plugins]: https://streamlink.github.io/plugins.html
[player-vlc]: https://www.videolan.org/vlc/
[contributing]: https://github.com/streamlink/streamlink/blob/master/CONTRIBUTING.md
[support]: https://streamlink.github.io/latest/support.html

Collapse