1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
Metadata-Version: 2.4
Name: streamlink
Version: 8.2.0
Summary: Streamlink is a command-line utility that extracts streams from various services and pipes them into a video player of choice.
Author: Streamlink
Author-email: streamlink@protonmail.com
License-Expression: BSD-2-Clause
Project-URL: Homepage, https://github.com/streamlink/streamlink
Project-URL: Documentation, https://streamlink.github.io/
Project-URL: Tracker, https://github.com/streamlink/streamlink/issues
Project-URL: Source, https://github.com/streamlink/streamlink
Project-URL: Funding, https://streamlink.github.io/latest/support.html
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: certifi
Requires-Dist: exceptiongroup; python_version < "3.11"
Requires-Dist: isodate
Requires-Dist: lxml<7,>=4.6.4
Requires-Dist: pycountry
Requires-Dist: pycryptodome<4,>=3.4.3
Requires-Dist: PySocks!=1.5.7,>=1.5.6
Requires-Dist: requests<3,>=2.30.0
Requires-Dist: trio<1,>=0.25.0; python_version >= "3.13"
Requires-Dist: trio<1,>=0.22.0; python_version < "3.13"
Requires-Dist: trio-websocket<1,>=0.9.0
Requires-Dist: typing-extensions>=4.1.0; python_version < "3.11"
Requires-Dist: urllib3<3,>=2.0.0
Requires-Dist: websocket-client<2,>=1.2.1
Provides-Extra: decompress
Requires-Dist: urllib3[brotli]<3,>=2.0.0; python_version >= "3.14" and extra == "decompress"
Requires-Dist: urllib3[brotli,zstd]<3,>=2.0.0; python_version < "3.14" and extra == "decompress"
Dynamic: license-file
<h1 align="center"><a href="https://streamlink.github.io/">Streamlink<br><img height="150" alt="Streamlink" src="https://raw.githubusercontent.com/streamlink/streamlink/master/icon.svg"></a></h1>
<p align="center">
<a href="https://streamlink.github.io/install.html"><img alt="Supported Python versions" src="https://img.shields.io/pypi/pyversions/streamlink.svg?style=flat-square&maxAge=86400"></a>
<a href="https://streamlink.github.io/changelog.html"><img alt="Latest release" src="https://img.shields.io/github/release/streamlink/streamlink.svg?style=flat-square&maxAge=86400"></a>
<a href="https://github.com/streamlink/streamlink"><img alt="License" src="https://img.shields.io/github/license/streamlink/streamlink.svg?style=flat-square&maxAge=86400"></a>
<a href="https://github.com/streamlink/streamlink/issues"><img alt="Open issues" src="https://img.shields.io/github/issues/streamlink/streamlink.svg?style=flat-square&maxAge=86400"></a>
<a href="https://github.com/streamlink/streamlink/actions?query=event%3Apush"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/streamlink/streamlink/test.yml?branch=master&event=push&style=flat-square&maxAge=86400"></a>
<a href="https://codecov.io/github/streamlink/streamlink?branch=master"><img alt="Overall code coverage" src="https://img.shields.io/codecov/c/github/streamlink/streamlink.svg?branch=master&style=flat-square&maxAge=86400"></a>
</p>
<p align="center">
A Python library and command-line interface which pipes streams from various services into a video player.<br>
Avoid resource-heavy and unoptimized websites, and still enjoy streamed content.
</p>
<p align="center">
Streamlink was forked in 2016 from the abandoned <em>Livestreamer</em> project.
</p>
# 📦 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](https://www.twitch.tv), [YouTube](https://www.youtube.com), 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
|
