streamlink 7.1.3__tar.gz → 7.2.0__tar.gz

{streamlink-7.1.3 → streamlink-7.2.0}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## streamlink 7.2.0 (2025-04-04)
+
+- Added: `decompress` extras marker to Streamlink's optional dependencies for installing `brotli` and `zstandard`, which were previously implied optional dependencies via the transitive dependency `urllib3` ([#6451](https://github.com/streamlink/streamlink/pull/6451))
+- Changed: `--retry-streams` to allow a value of `0`, so it can be unset again if set previously ([#6455](https://github.com/streamlink/streamlink/pull/6455))
+- Changed: `--quiet` to suppress all text output including errors, not just log output ([#6461](https://github.com/streamlink/streamlink/pull/6461))
+- Fixed: `--logfile` affecting the console output stream ([#6461](https://github.com/streamlink/streamlink/pull/6461))
+- Fixed: broken user input prompt behavior on missing or non-interactive I/O streams ([#6461](https://github.com/streamlink/streamlink/pull/6461))
+- Fixed: `Plugin` classes not requiring a matching matcher ([#6466](https://github.com/streamlink/streamlink/pull/6466))
+- Fixed: `--hls-audio-select` not being case-insensitive and only comparing input values rather than resolved language codes ([#6469](https://github.com/streamlink/streamlink/pull/6469), [#6479](https://github.com/streamlink/streamlink/pull/6479))
+- Updated: Chrome Devtool Protocol interfaces, to match recent Chromium versions ([#6481](https://github.com/streamlink/streamlink/pull/6481))
+- Updated plugins:
+  - euronews: rewritten and fixed plugin ([#6452](https://github.com/streamlink/streamlink/pull/6452))
+  - kick: refactored plugin, fixed clip matcher and 403 API responses ([#6491](https://github.com/streamlink/streamlink/pull/6491))
+  - nicolive: fixed plugin not loading cookies from WebSocket messages ([#6441](https://github.com/streamlink/streamlink/pull/6441))
+  - nicolive: made the plugin always filter out blank HLS segments ([#6476](https://github.com/streamlink/streamlink/pull/6476))
+  - nowtvtr: removed plugin ([#6488](https://github.com/streamlink/streamlink/pull/6488))
+  - okru: canonicalize mobile URLs ([#6444](https://github.com/streamlink/streamlink/pull/6444))
+  - tf1: fixed stream matcher ([#6439](https://github.com/streamlink/streamlink/pull/6439))
+
+[Full changelog](https://github.com/streamlink/streamlink/compare/7.1.3...7.2.0)
+
+
 ## streamlink 7.1.3 (2025-02-14)
 
 - Fixed: `validate.contains()` to allow all kinds of `Container` object inputs ([#6421](https://github.com/streamlink/streamlink/pull/6421))

{streamlink-7.1.3 → streamlink-7.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: streamlink
-Version: 7.1.3
+Version: 7.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
@@ -44,6 +44,9 @@ Requires-Dist: trio<1,>=0.22.0; python_version < "3.13"
 Requires-Dist: trio-websocket<1,>=0.9.0
 Requires-Dist: urllib3<3,>=1.26.0
 Requires-Dist: websocket-client<2,>=1.2.1
+Provides-Extra: decompress
+Requires-Dist: urllib3[brotli,zstd]<3,>=1.26.0; 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>
 

{streamlink-7.1.3 → streamlink-7.2.0}/completions/zsh/_streamlink

@@ -128,9 +128,7 @@ _shtab_streamlink_cli_options=(
               \$\{XDG_STATE_HOME\:-\$\{HOME\}\/.local\/state\}\/streamlink\/logs
         ]:logfile:"
   {-Q,--quiet}"[
-            Hide all log output.
-
-            Alias for --loglevel\=none.
+            Suppress all console and log output, and also disable user prompts.
         ]"
   {-j,--json}"[
             Output JSON representations instead of the normal text output.
@@ -368,16 +366,19 @@ _shtab_streamlink_cli_options=(
         ]"
   "--retry-streams[
             Retry fetching the list of available streams until streams are found
-            while waiting \`DELAY\` second(s) between each attempt. If unset, only one
-            attempt will be made to fetch the list of streams available.
+            while waiting \`DELAY\` second(s) between each attempt.
+
+            The number of retry attempts can be capped with --retry-max.
+            A default value of \`\`1\`\` is implied for non-zero values of --retry-max.
 
-            The number of fetch retry attempts can be capped with --retry-max.
+            If both --retry-streams and --retry-max are set to \`0\`, then only one attempt will be made
+            to fetch the list of available streams. This is the default behavior.
         ]:retry_streams:"
   "--retry-max[
-            When using --retry-streams, stop retrying the fetch after \`COUNT\` retry
-            attempt(s). Fetch will retry infinitely if \`COUNT\` is zero or unset.
+            Stop fetching the list of available streams after \`COUNT\` retry attempt(s).
 
-            If --retry-max is set without setting --retry-streams, the delay between retries will default to 1 second.
+            A value of \`0\` makes Streamlink fetch streams indefinitely if --retry-streams is set to a non-zero value.
+            If --retry-streams is unset, then the default delay between fetching available streams is 1 second.
         ]:retry_max:"
   "--retry-open[
             After a successful fetch, try \`ATTEMPTS\` time(s) to open the stream until giving up.

{streamlink-7.1.3 → streamlink-7.2.0}/dev-requirements.txt

@@ -14,7 +14,7 @@ pytest-cov
 coverage[toml]
 
 # code-linting / code-formatting
-ruff ==0.9.5
+ruff ==0.11.2
 
 # typing
 mypy[faster-cache] ==1.15.0

{streamlink-7.1.3 → streamlink-7.2.0}/docs/_build/man/streamlink.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "STREAMLINK" "1" "Feb 14, 2025" "7.1.3" "Streamlink"
+.TH "STREAMLINK" "1" "Apr 04, 2025" "7.2.0" "Streamlink"
 .SH NAME
 streamlink \- extracts streams from various services and pipes them into a video player of choice
 .SH SYNOPSIS
@@ -267,9 +267,7 @@ ${XDG_STATE_HOME:\-${HOME}/.local/state}/streamlink/logs
 .B \-Q
 .TP
 .B \-\-quiet
-Hide all log output.
-.sp
-Alias for \fI\%\-\-loglevel=none\fP\&.
+Suppress all console and log output, and also disable user prompts.
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -639,18 +637,21 @@ If possible, translate the resolved stream to a URL and print it.
 .TP
 .B \-\-retry\-streams DELAY
 Retry fetching the list of available streams until streams are found
-while waiting \fBDELAY\fP second(s) between each attempt. If unset, only one
-attempt will be made to fetch the list of streams available.
+while waiting \fBDELAY\fP second(s) between each attempt.
+.sp
+The number of retry attempts can be capped with \fI\%\-\-retry\-max\fP\&.
+A default value of \fB1\fP is implied for non\-zero values of \fI\%\-\-retry\-max\fP\&.
 .sp
-The number of fetch retry attempts can be capped with \fI\%\-\-retry\-max\fP\&.
+If both \fI\%\-\-retry\-streams\fP and \fI\%\-\-retry\-max\fP are set to \fB0\fP, then only one attempt will be made
+to fetch the list of available streams. This is the default behavior.
 .UNINDENT
 .INDENT 0.0
 .TP
 .B \-\-retry\-max COUNT
-When using \fI\%\-\-retry\-streams\fP, stop retrying the fetch after \fBCOUNT\fP retry
-attempt(s). Fetch will retry infinitely if \fBCOUNT\fP is zero or unset.
+Stop fetching the list of available streams after \fBCOUNT\fP retry attempt(s).
 .sp
-If \fI\%\-\-retry\-max\fP is set without setting \fI\%\-\-retry\-streams\fP, the delay between retries will default to 1 second.
+A value of \fB0\fP makes Streamlink fetch streams indefinitely if \fI\%\-\-retry\-streams\fP is set to a non\-zero value.
+If \fI\%\-\-retry\-streams\fP is unset, then the default delay between fetching available streams is 1 second.
 .UNINDENT
 .INDENT 0.0
 .TP

{streamlink-7.1.3 → streamlink-7.2.0}/docs/api_guide/quickstart.rst

@@ -17,7 +17,7 @@ The simplest use of the Streamlink API looks like this:
 
 This simply attempts to find a plugin and use it to extract streams from
 the URL. This works great in simple cases but if you want more
-fine tuning you need to use a `session object`_ instead.
+fine tuning you need to use a `session object`_ instead and `fetch streams <fetching streams_>`_ manually.
 
 The returned value is a dict containing :py:class:`Stream <streamlink.stream.Stream>` objects:
 
@@ -80,19 +80,55 @@ when extracting streams more than once. You start by creating a
 .. code-block:: python
 
     >>> from streamlink import Streamlink
-    >>> session = Streamlink()
+    >>> session = Streamlink({"optional-session-option": 123})
 
-You can then set options like this:
+On the session instance, you can set additional options like so:
 
 .. code-block:: python
 
     >>> session.set_option("stream-timeout", 30)
+    >>> session.options.set("stream-timeout", 30)
 
-and extract streams like this:
+See :py:class:`StreamlinkOptions <streamlink.session.options.StreamlinkOptions>` for all available session options.
+
+
+Fetching streams
+^^^^^^^^^^^^^^^^
+
+Streams can be fetched in two different ways.
+
+The first example will automatically try to find a matching plugin and available streams from the input URL:
 
 .. code-block:: python
 
     >>> streams = session.streams("URL")
 
+See :py:meth:`Streamlink.streams() <streamlink.session.Streamlink.streams>` for more.
+
+``Streamlink.streams()`` however doen't allow you to set any plugin options which might be necessary in order to access streams,
+e.g. when authentication data is required, or plugin options which may alter the plugin's behavior.
+Be aware that plugin options are distinct from the session options, and since these options depend on the plugin in use,
+plugin options can't be set without resolving the matching plugin first.
+
+Plugins can therefore be resolved and initialized manually from the input URL, so plugin options can be passed to the plugin:
+
+.. code-block:: python
+
+    >>> plugin_name, plugin_class, resolved_url = session.resolve_url("URL")
+    >>> plugin = plugin_class(session, resolved_url, options={"plugin-option": 123})
+    >>> streams = plugin.streams()
+
+See :py:meth:`Streamlink.resolve_url() <streamlink.session.Streamlink.resolve_url>`
+and :py:class:`Plugin <streamlink.plugin.Plugin>` for more.
+
+Alternatively, the plugin class can be imported directly from the respective module of the ``streamlink.plugins`` package.
+The input URL then must match the plugin's URL matchers.
+
+.. code-block:: python
+
+    >>> from streamlink.plugins.twitch import __plugin__ as Twitch
+    >>> plugin = Twitch(session, "https://twitch.tv/CHANNEL", options={"disable-ads": True, "low-latency": True})
+    >>> streams = plugin.streams()
 
-See :py:meth:`Streamlink.set_option() <streamlink.session.Streamlink.set_option>` to see which options are available.
+Available plugin options are defined using the :py:meth:`@pluginargument <streamlink.plugin.pluginargument>`
+Plugin class decorator in each plugin's module.

{streamlink-7.1.3 → streamlink-7.2.0}/docs/changelog.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## streamlink 7.2.0 (2025-04-04)
+
+- Added: `decompress` extras marker to Streamlink's optional dependencies for installing `brotli` and `zstandard`, which were previously implied optional dependencies via the transitive dependency `urllib3` ([#6451](https://github.com/streamlink/streamlink/pull/6451))
+- Changed: `--retry-streams` to allow a value of `0`, so it can be unset again if set previously ([#6455](https://github.com/streamlink/streamlink/pull/6455))
+- Changed: `--quiet` to suppress all text output including errors, not just log output ([#6461](https://github.com/streamlink/streamlink/pull/6461))
+- Fixed: `--logfile` affecting the console output stream ([#6461](https://github.com/streamlink/streamlink/pull/6461))
+- Fixed: broken user input prompt behavior on missing or non-interactive I/O streams ([#6461](https://github.com/streamlink/streamlink/pull/6461))
+- Fixed: `Plugin` classes not requiring a matching matcher ([#6466](https://github.com/streamlink/streamlink/pull/6466))
+- Fixed: `--hls-audio-select` not being case-insensitive and only comparing input values rather than resolved language codes ([#6469](https://github.com/streamlink/streamlink/pull/6469), [#6479](https://github.com/streamlink/streamlink/pull/6479))
+- Updated: Chrome Devtool Protocol interfaces, to match recent Chromium versions ([#6481](https://github.com/streamlink/streamlink/pull/6481))
+- Updated plugins:
+  - euronews: rewritten and fixed plugin ([#6452](https://github.com/streamlink/streamlink/pull/6452))
+  - kick: refactored plugin, fixed clip matcher and 403 API responses ([#6491](https://github.com/streamlink/streamlink/pull/6491))
+  - nicolive: fixed plugin not loading cookies from WebSocket messages ([#6441](https://github.com/streamlink/streamlink/pull/6441))
+  - nicolive: made the plugin always filter out blank HLS segments ([#6476](https://github.com/streamlink/streamlink/pull/6476))
+  - nowtvtr: removed plugin ([#6488](https://github.com/streamlink/streamlink/pull/6488))
+  - okru: canonicalize mobile URLs ([#6444](https://github.com/streamlink/streamlink/pull/6444))
+  - tf1: fixed stream matcher ([#6439](https://github.com/streamlink/streamlink/pull/6439))
+
+[Full changelog](https://github.com/streamlink/streamlink/compare/7.1.3...7.2.0)
+
+
 ## streamlink 7.1.3 (2025-02-14)
 
 - Fixed: `validate.contains()` to allow all kinds of `Container` object inputs ([#6421](https://github.com/streamlink/streamlink/pull/6421))

{streamlink-7.1.3 → streamlink-7.2.0}/docs/install.rst

@@ -501,6 +501,14 @@ Streamlink defines a `build system <pyproject.toml_>`__ according to `PEP-517`_
 
         - DASH streams with video and audio content always have to get remuxed.
         - HLS streams optionally need to get remuxed depending on the stream selection.
+    * - optional
+      - | `brotli`_
+        | ``decompress`` extras marker
+      - Used for decompressing HTTP responses
+    * - optional
+      - | `zstandard`_
+        | ``decompress`` extras marker
+      - Used for decompressing HTTP responses
 
 .. _pyproject.toml: https://github.com/streamlink/streamlink/blob/master/pyproject.toml
 .. _PEP-517: https://peps.python.org/pep-0517/
@@ -524,6 +532,9 @@ Streamlink defines a `build system <pyproject.toml_>`__ according to `PEP-517`_
 .. _urllib3: https://urllib3.readthedocs.io/en/stable/
 .. _websocket-client: https://pypi.org/project/websocket-client/
 
+.. _brotli: https://pypi.org/project/Brotli/
+.. _zstandard: https://pypi.org/project/zstandard/
+
 .. _FFmpeg: https://www.ffmpeg.org/
 .. _muxing: https://en.wikipedia.org/wiki/Multiplexing#Video_processing
 

{streamlink-7.1.3 → streamlink-7.2.0}/pyproject.toml

@@ -70,6 +70,13 @@ dependencies = [
   "websocket-client >=1.2.1,<2",
 ]
 
+[project.optional-dependencies]
+decompress = [
+  # don't define brotli or zstandard library versions here
+  # and instead rely on urllib3's version requirements
+  "urllib3[brotli,zstd] >=1.26.0,<3"
+]
+
 [project.urls]
 Homepage = "https://github.com/streamlink/streamlink"
 Documentation = "https://streamlink.github.io/"
@@ -166,7 +173,6 @@ src = [
   "src",
   "tests",
 ]
-target-version = "py39"
 fix = false
 line-length = 128
 output-format = "full"

{streamlink-7.1.3 → streamlink-7.2.0}/setup.py

@@ -97,5 +97,5 @@ if __name__ == "__main__":
         cmdclass=get_cmdclasses(cmdclass),
         entry_points=entry_points,
         data_files=data_files,
-        version="7.1.3",
+        version="7.2.0",
     )

streamlink-7.2.0/src/streamlink/_version.py

@@ -0,0 +1 @@
+__version__ = "7.2.0"

{streamlink-7.1.3 → streamlink-7.2.0}/src/streamlink/logger.py

@@ -5,7 +5,6 @@ import sys
 import warnings
 from collections.abc import Iterator
 from logging import CRITICAL, DEBUG, ERROR, INFO, WARNING
-from os import devnull
 from pathlib import Path
 from sys import version_info
 from threading import Lock
@@ -146,8 +145,6 @@ class StreamHandler(logging.StreamHandler):
         return res
 
     def _stream_reconfigure(self):
-        if not self.stream:
-            return
         # make stream write calls escape unsupported characters (stdout/stderr encoding is not guaranteed to be utf-8)
         self.stream.reconfigure(errors="backslashreplace")
 
@@ -216,27 +213,25 @@ def basicConfig(
     stream: IO | None = None,
     remove_base: list[str] | None = None,
     capture_warnings: bool = False,
-) -> logging.StreamHandler:
+) -> logging.StreamHandler | None:
     with _config_lock:
-        handler: logging.StreamHandler
+        handler: logging.StreamHandler | None = None
         if filename is not None:
             handler = logging.FileHandler(filename, filemode, encoding="utf-8")
-        else:
+        elif stream is not None:
             handler = StreamHandler(stream)
-            # logging.StreamHandler internally falls back to sys.stderr if stream is None
-            # sys.stderr however can also be None if fd2 doesn't exist, so use a devnull FileHandler in this case instead
-            if not handler.stream:
-                handler = logging.FileHandler(devnull)
-
-        formatter = StringFormatter(
-            fmt=format,
-            datefmt=datefmt,
-            style=style,
-            remove_base=remove_base or REMOVE_BASE,
-        )
-        handler.setFormatter(formatter)
-
-        root.addHandler(handler)
+
+        if handler is not None:
+            formatter = StringFormatter(
+                fmt=format,
+                datefmt=datefmt,
+                style=style,
+                remove_base=remove_base or REMOVE_BASE,
+            )
+            handler.setFormatter(formatter)
+
+            root.addHandler(handler)
+
         if level is not None:
             root.setLevel(level)
 

{streamlink-7.1.3 → streamlink-7.2.0}/src/streamlink/plugin/plugin.py

@@ -315,6 +315,8 @@ class Plugin(metaclass=PluginMeta):
         self.session: Streamlink = session
         self.matches = Matches()
         self.url: str = url
+        if self.matchers and not self.match:
+            raise PluginError("The input URL did not match any of this plugin's matchers")
 
         self.load_cookies()
 

streamlink-7.2.0/src/streamlink/plugins/euronews.py

@@ -0,0 +1,130 @@
+"""
+$description French television news network, covering world news from the European perspective.
+$url euronews.com
+$type live, vod
+$notes Euronews ignores the HTTP client's data decompression capabilities.
+$notes Streamlink's optional brotli dependency is therefore strictly required.
+"""
+
+import logging
+import re
+
+from streamlink.plugin import Plugin, pluginmatcher
+from streamlink.plugin.api import validate
+from streamlink.stream.hls import HLSStream
+from streamlink.stream.http import HTTPStream
+
+
+log = logging.getLogger(__name__)
+
+
+@pluginmatcher(
+    name="live",
+    pattern=re.compile(r"https?://(?:(?P<subdomain>\w+)\.)?euronews\.com/live[?#]?"),
+)
+@pluginmatcher(
+    name="vod",
+    pattern=re.compile(r"https?://(?:\w+\.)?euronews\.com/(?!live)\S+"),
+)
+class Euronews(Plugin):
+    API_URL = "https://{subdomain}.euronews.com/api/live/data"
+
+    def _get_live(self):
+        log.debug("Querying live API")
+        subdomain = self.match["subdomain"] or "www"
+        streamtype, streamdata = self.session.http.get(
+            self.API_URL.format(subdomain=subdomain),
+            params={"locale": subdomain},
+            schema=validate.Schema(
+                validate.parse_json(),
+                validate.any(
+                    validate.all(
+                        {
+                            "videoPrimaryUrl": validate.url(path=validate.endswith(".m3u8")),
+                        },
+                        validate.transform(lambda data: ("hls", data["videoPrimaryUrl"])),
+                    ),
+                    validate.all(
+                        {
+                            "player": "pfp",
+                            "videoId": str,
+                        },
+                        validate.transform(lambda data: ("youtube", data["videoId"])),
+                    ),
+                ),
+            ),
+        )
+
+        if streamtype == "hls":
+            return HLSStream.parse_variant_playlist(self.session, streamdata)
+        if streamtype == "youtube":
+            return self.session.streams(f"https://www.youtube.com/watch?v={streamdata}")
+
+    def _get_vod(self):
+        log.debug("Looking for VOD")
+        videotype, videodata = self.session.http.get(
+            self.url,
+            schema=validate.Schema(
+                validate.parse_html(),
+                validate.any(
+                    validate.all(
+                        validate.xml_xpath_string(".//meta[@property='og:video'][1]/@content"),
+                        validate.url(),
+                        validate.transform(lambda d: ("httpstream", d)),
+                    ),
+                    validate.all(
+                        validate.xml_xpath_string(
+                            ".//iframe[@id='pfpPlayer'][starts-with(@src,'https://www.youtube.com/')][1]/@src",
+                        ),
+                        validate.url(),
+                        validate.transform(lambda d: ("plugin", d)),
+                    ),
+                    validate.all(
+                        validate.xml_xpath_string("""
+                            .//div
+                            [@data-video]
+                            [contains(@data-video, //head/meta[@rel='canonical'][@href][1]/@href)]
+                            [1]
+                            /@data-video
+                        """),
+                        str,
+                        validate.parse_json(),
+                        validate.any(
+                            validate.all(
+                                {"url": validate.url()},
+                                validate.transform(lambda d: ("httpstream", d["url"])),
+                            ),
+                            validate.all(
+                                {
+                                    "player": "dailymotion",
+                                    "id": str,
+                                },
+                                validate.transform(lambda d: ("plugin", f"https://www.dailymotion.com/embed/video/{d['id']}")),
+                            ),
+                            validate.all(
+                                {
+                                    "player": "pfp",
+                                    validate.optional("videoId"): str,
+                                    validate.optional("id"): str,
+                                },
+                                validate.transform(lambda d: d.get("videoId") or d.get("id")),
+                                str,
+                                validate.transform(lambda d: ("plugin", f"https://www.youtube.com/watch?v={d}")),
+                            ),
+                        ),
+                    ),
+                    validate.transform(lambda *_: ("error", None)),
+                ),
+            ),
+        )
+
+        if videotype == "httpstream":
+            return dict(vod=HTTPStream(self.session, videodata))
+        if videotype == "plugin":
+            return self.session.streams(videodata)
+
+    def _get_streams(self):
+        return self._get_live() if self.matches["live"] else self._get_vod()
+
+
+__plugin__ = Euronews