streamlink 7.1.2__tar.gz → 7.2.0__tar.gz

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

@@ -1,5 +1,46 @@
 # 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))
+- Updated plugins:
+  - ceskatelevize: rewritten and fixed plugin ([#6397](https://github.com/streamlink/streamlink/pull/6397))
+  - nos: fixed validation schema, updated matcher ([#6420](https://github.com/streamlink/streamlink/pull/6420))
+  - pandalive: fixed user\_id retieval, updated matcher ([#6433](https://github.com/streamlink/streamlink/pull/6433))
+  - pluzz: fixed video ID schemas ([#6428](https://github.com/streamlink/streamlink/pull/6428))
+  - streamable: removed plugin ([#6435](https://github.com/streamlink/streamlink/pull/6435))
+  - tv4play: removed plugin ([#6399](https://github.com/streamlink/streamlink/pull/6399))
+  - twitch: refactored TwitchAPI class and access token retrieval ([#6403](https://github.com/streamlink/streamlink/pull/6403))
+  - wwenetwork: rewritten and fixed plugin ([#6404](https://github.com/streamlink/streamlink/pull/6404))
+- Docs: replaced Windows and Linux AppImage nightly builds with preview builds triggered on each commit to `master` ([#6425](https://github.com/streamlink/streamlink/pull/6425))
+- Docs: added optional/secondary Linux AppImage builds with FFmpeg being bundled ([#6415](https://github.com/streamlink/streamlink/pull/6415))
+- Tests: bumped `freezegun` requirement to `>=1.5.0` ([#6406](https://github.com/streamlink/streamlink/pull/6406))
+
+[Full changelog](https://github.com/streamlink/streamlink/compare/7.1.2...7.1.3)
+
+
 ## streamlink 7.1.2 (2025-01-08)
 
 - Updated plugins:

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: streamlink
-Version: 7.1.2
+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.2 → streamlink-7.2.0}/completions/zsh/_streamlink

@@ -82,7 +82,13 @@ _shtab_streamlink_cli_options=(
             See the Python standard library\'s \`logging.Formatter\` docs for more information about the logging format
             and the available \`LogRecord\` attributes. Streamlink\'s formatter uses the curly brace style.
 
-            The default format depends on the chosen log level (may include the \`asctime\` attribute).
+            The default format depends on the chosen log level.
+
+            For verbose levels (\`trace\` and \`all\`)\:
+
+            Default is \"\[\{asctime\}\]\[\{name\}\]\[\{levelname\}\] \{message\}\".
+
+            Otherwise\:
 
             Default is \"\[\{name\}\]\[\{levelname\}\] \{message\}\".
         ]:logformat:"
@@ -91,7 +97,13 @@ _shtab_streamlink_cli_options=(
 
             This formats the \`LogRecord\`\'s \`asctime\` attribute via \`strftime()\`.
 
-            The default date format depends on the chosen log level (may include fractions).
+            The default date format depends on the chosen log level.
+
+            For verbose levels (\`trace\` and \`all\`)\:
+
+            Default is \"\%H\:\%M\:\%S.\%f\".
+
+            Otherwise\:
 
             Default is \"\%H\:\%M\:\%S\".
         ]:logdateformat:"
@@ -116,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.
@@ -356,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.
@@ -737,7 +750,7 @@ _shtab_streamlink_cli_options=(
   "--steam-password[A Steam account password to use with --steam-email.]:steam_password:"
   "--streann-url[Source URL where the iframe is located, only required for direct URLs of ott.streann.com]:streann_url:"
   "--tf1-email[The email address used to register with tf1.fr.]:tf1_email:"
-  "--tf1-password[A tf1.fr account password to use with --tf1-username.]:tf1_password:"
+  "--tf1-password[A tf1.fr account password to use with --tf1-email.]:tf1_password:"
   "--tf1-purge-credentials[Purge cached tf1.fr credentials to initiate a new session and reauthenticate.]"
   "--twitcasting-password[Password for private Twitcasting streams.]:twitcasting_password:"
   "--twitch-disable-ads[

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

@@ -7,17 +7,17 @@ versioningit >=2.0.0,<4  # required for being able to run editable installs
 pytest >=8.0.0
 pytest-trio
 requests-mock
-freezegun >=1.0.0
+freezegun >=1.5.0
 
 # code-coverage
 pytest-cov
 coverage[toml]
 
 # code-linting / code-formatting
-ruff ==0.8.6
+ruff ==0.11.2
 
 # typing
-mypy[faster-cache] ==1.14.1
+mypy[faster-cache] ==1.15.0
 typing-extensions >=4.0.0
 lxml-stubs
 trio-typing

{streamlink-7.1.2 → 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" "Jan 08, 2025" "7.1.2" "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
@@ -195,7 +195,13 @@ Set a custom logging format.
 See the Python standard library\(aqs \fBlogging.Formatter\fP docs for more information about the logging format
 and the available \fBLogRecord\fP attributes. Streamlink\(aqs formatter uses the curly brace style.
 .sp
-The default format depends on the chosen log level (may include the \fBasctime\fP attribute).
+The default format depends on the chosen log level.
+.sp
+For verbose levels (\fBtrace\fP and \fBall\fP):
+.sp
+Default is: \fB\(dq[{asctime}][{name}][{levelname}] {message}\(dq\fP\&.
+.sp
+Otherwise:
 .sp
 Default is: \fB\(dq[{name}][{levelname}] {message}\(dq\fP\&.
 .UNINDENT
@@ -206,7 +212,13 @@ Set a custom logging date format.
 .sp
 This formats the \fBLogRecord\fP\(aqs \fBasctime\fP attribute via \fBstrftime()\fP\&.
 .sp
-The default date format depends on the chosen log level (may include fractions).
+The default date format depends on the chosen log level.
+.sp
+For verbose levels (\fBtrace\fP and \fBall\fP):
+.sp
+Default is: \fB\(dq%H:%M:%S.%f\(dq\fP\&.
+.sp
+Otherwise:
 .sp
 Default is: \fB\(dq%H:%M:%S\(dq\fP\&.
 .UNINDENT
@@ -255,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
@@ -627,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
@@ -1281,7 +1294,7 @@ The email address used to register with tf1.fr.
 .INDENT 0.0
 .TP
 .B \-\-tf1\-password PASSWORD
-A tf1.fr account password to use with \-\-tf1\-username.
+A tf1.fr account password to use with \fI\%\-\-tf1\-email\fP\&.
 .UNINDENT
 .INDENT 0.0
 .TP

{streamlink-7.1.2 → streamlink-7.2.0}/docs/_static/styles/custom.css

@@ -304,7 +304,6 @@ table.table-custom-layout.table-custom-layout-dependencies tbody td {
 
 .grid-with-icons .sd-card-body .fas {
   padding-right: 0.1em;
-  font-size: 1.75em;
   vertical-align: middle;
 }
 

{streamlink-7.1.2 → 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.2 → streamlink-7.2.0}/docs/changelog.md

@@ -1,5 +1,46 @@
 # 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))
+- Updated plugins:
+  - ceskatelevize: rewritten and fixed plugin ([#6397](https://github.com/streamlink/streamlink/pull/6397))
+  - nos: fixed validation schema, updated matcher ([#6420](https://github.com/streamlink/streamlink/pull/6420))
+  - pandalive: fixed user\_id retieval, updated matcher ([#6433](https://github.com/streamlink/streamlink/pull/6433))
+  - pluzz: fixed video ID schemas ([#6428](https://github.com/streamlink/streamlink/pull/6428))
+  - streamable: removed plugin ([#6435](https://github.com/streamlink/streamlink/pull/6435))
+  - tv4play: removed plugin ([#6399](https://github.com/streamlink/streamlink/pull/6399))
+  - twitch: refactored TwitchAPI class and access token retrieval ([#6403](https://github.com/streamlink/streamlink/pull/6403))
+  - wwenetwork: rewritten and fixed plugin ([#6404](https://github.com/streamlink/streamlink/pull/6404))
+- Docs: replaced Windows and Linux AppImage nightly builds with preview builds triggered on each commit to `master` ([#6425](https://github.com/streamlink/streamlink/pull/6425))
+- Docs: added optional/secondary Linux AppImage builds with FFmpeg being bundled ([#6415](https://github.com/streamlink/streamlink/pull/6415))
+- Tests: bumped `freezegun` requirement to `>=1.5.0` ([#6406](https://github.com/streamlink/streamlink/pull/6406))
+
+[Full changelog](https://github.com/streamlink/streamlink/compare/7.1.2...7.1.3)
+
+
 ## streamlink 7.1.2 (2025-01-08)
 
 - Updated plugins:

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

@@ -63,7 +63,7 @@ Windows
       - See the `Windows binaries`_ section below
     * - :octicon:`verified` Portable
       - See the `Windows binaries`_ section below
-    * - :octicon:`verified` Nightly builds
+    * - :octicon:`verified` Preview builds
       - See the `Windows binaries`_ section below
     * - :octicon:`verified` Python pip
       - See the `PyPI package and source code`_ section below
@@ -132,7 +132,7 @@ Linux and BSD
       - Installing
     * - :octicon:`verified` AppImage
       - See the `Linux AppImages`_ section below
-    * - :octicon:`verified` AppImage nightly builds
+    * - :octicon:`verified` AppImage preview builds
       - See the `Linux AppImages`_ section below
     * - :octicon:`verified` Python pip
       - See the `PyPI package and source code`_ section below
@@ -302,9 +302,6 @@ PyPI package and source code
 If a package is not available on your platform, or if it's out of date,
 then Streamlink can be installed via `pip`_, the Python package manager.
 
-Before running :command:`pip`, make sure that it's the Python 3 version of `pip`_ (to check, run :command:`pip --version`).
-On some systems, this isn't the case by default and an alternative, like :command:`pip3` for example, needs to be run instead.
-
 .. warning::
 
     On Linux, when not using a `virtual environment`_, it is recommended to **install custom python packages like this
@@ -504,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/
@@ -527,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
 
@@ -546,21 +554,21 @@ Windows binaries
 
         **Windows stable releases**
         ^^^
-        :fas:`download` GitHub releases page
+        :fas:`download;fa-2x` GitHub releases page
 
-        The most recent Streamlink release
+        :fas:`check-circle;sd-text-success fa-lg` The most recent Streamlink release
 
     .. grid-item-card::
         :padding: 3
-        :link: https://github.com/streamlink/windows-builds/actions?query=event%3Aschedule+is%3Asuccess+branch%3Amaster
-        :link-alt: Windows nightly builds
+        :link: https://github.com/streamlink/windows-builds/actions/workflows/preview-build.yml
+        :link-alt: Windows preview builds
         :text-align: center
 
-        **Windows nightly builds**
+        **Windows preview builds**
         ^^^
-        :fas:`download` GitHub actions build artifacts
+        :fas:`download;fa-2x` GitHub actions build artifacts
 
-        Built once each day at midnight UTC |br| :sub:`GitHub account required`
+        :fab:`github;fa-lg` Account required
 
 **Flavors**
 
@@ -657,21 +665,21 @@ Linux AppImages
 
         **AppImage stable releases**
         ^^^
-        :fas:`download` GitHub releases page
+        :fas:`download;fa-2x` GitHub releases page
 
-        The most recent Streamlink release
+        :fas:`check-circle;sd-text-success fa-lg` The most recent Streamlink release
 
     .. grid-item-card::
         :padding: 3
-        :link: https://github.com/streamlink/streamlink-appimage/actions?query=event%3Aschedule+is%3Asuccess+branch%3Amaster
-        :link-alt: AppImage nightly builds
+        :link: https://github.com/streamlink/streamlink-appimage/actions/workflows/preview-build.yml
+        :link-alt: AppImage preview builds
         :text-align: center
 
-        **AppImage nightly builds**
+        **AppImage preview builds**
         ^^^
-        :fas:`download` GitHub actions build artifacts
+        :fas:`download;fa-2x` GitHub actions build artifacts
 
-        Built once each day at midnight UTC |br| :sub:`GitHub account required`
+        :fab:`github;fa-lg` Account required
 
 **Architectures**
 
@@ -692,7 +700,7 @@ Linux AppImages
 
 **Contents**
 
-.. grid:: 2
+.. grid:: 3
     :padding: 0
     :class-container: grid-with-images
 
@@ -718,6 +726,17 @@ Linux AppImages
 
         Streamlink |br| :sub:`and dependencies`
 
+    .. grid-item-card::
+        :padding: 3
+        :link: https://github.com/streamlink/FFmpeg-Builds
+        :link-alt: FFmpeg, required for muxing streams
+        :text-align: center
+
+        .. image:: _static/icon-ffmpeg.svg
+            :alt: FFmpeg
+
+        FFmpeg |br| :sub:`for muxing streams` |br| :sub:`(optional)`
+
 **How-To**
 
 1. Verify that the system is running on at least

{streamlink-7.1.2 → 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"
@@ -233,7 +239,7 @@ select = [
 ]
 ignore = [
   "A003",  # builtin-attribute-shadowing
-  "A005",  # builtin-module-shadowing
+  "A005",  # stdlib-module-shadowing
   "ASYNC109",  # async-function-with-timeout
   "C408",  # unnecessary-collection-call
   "ISC003",  # explicit-string-concatenation

{streamlink-7.1.2 → 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.2",
+        version="7.2.0",
     )

streamlink-7.2.0/src/streamlink/_version.py

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

{streamlink-7.1.2 → 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.2 → 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()