Dl-plus

Breaking Changes

* Dropped support for Python 3.8.

Features

* **(CLI)** New management commands were added — `backend list`, `backend uninstall NAME`, `extractor list`, `extractor uninstall NAME`.
* Added support for Python 3.13.

Fixes

* **(CLI)** Fix `backend update` `PermissionError` on Windows.
* **(CLI)** Don't try to validate a backend name if not passed. Fixes `TypeError` on `backend update` command.

Features

* **(Config)** Backend configuration file. A new config file `$DL_PLUS_CONFIG_HOME/backends.ini` can be used to extend/override the predefined list of backends.
* **(CLI)** Two new commands was added — `config show main` and `config show backends` — to display `config.ini` and `backends.ini`, respectively.
* A new backend/extractor installer based on `pip`. Unlike previously used `builtin` installer, `pip` installer is able to install dependencies. The new installer is used if `pip` is available, the legacy `builtin` installer is used otherwise.

Improvements

* **(Extractor API)** `yt-dlp`'s `_sort_format` warnings are supressed when possible.
* **(CLI)** Backend name validation in backend–related commands.

Breaking Changes

* **(Config)** The `[extractors.enable]` section was renamed to `[extractors]`. The old name is still supported but deprecated. It is strongly recommended to update the config.
* On \*nix (more specifically, non-Windows) systems the default location for managed backends and extractor plugins was changed from `$XDG_CONFIG_HOME/dl-plus` to `$XDG_DATA_HOME/dl-plus`. The old location is still supported but deprecated. It is strongly recommended to either move the data to the new location or set the `DL_PLUS_DATA_HOME`/`DL_PLUS_HOME` environment variable to keep the old location.

Features

* Added support for Python 3.12.
* **(Env)** Added two new environment variables: `DL_PLUS_CONFIG_HOME` and `DL_PLUS_DATA_HOME`. These variables have higher priority than `DL_PLUS_HOME`.
`DL_PLUS_CONFIG_HOME` is a directory where the config file is stored. `DL_PLUS_DATA_HOME` is a directory where managed backends and extractor plugins are stored.
* **(Env)** Added a new environment variable `DL_PLUS_BACKEND`, which has higher priority than the config setting, but lower than the command line argument. The variable can be used, for example, to temporarily override the backend setting, especially if it is not possible/hard to do via the command line argument, e.g., `DL_PLUS_BACKEND=youtube-dl mpv https://...` can be used instead of `mpv --ytdl-raw-options=backend=youtube-dl mpv https://...`.

Breaking Changes

* Dropped support for Python 3.6, 3.7.
* **(CLI)** The `backend install` `NAME` argument is now required. `youtube-dl` is no longer the default backend to install.
* **(CLI)** The `backend info` `--backend` option was replaced by a positional argument (`backend info --backend=yt-dlp` → `backend info yt-dlp`).

Features

* Added support for Python 3.10, 3.11.
* Backend autodetection. If the `backend` option is set to `:autodetect:`, `dl-plus` tries to initialize any known backend in the following order: `yt-dlp`, `youtube-dl`, `youtube-dlc`.
* **(Config)** The default value of the `backend` option was changed from `youtube-dl` to `:autodetect:`.
* **(CLI)** New commands: `backend update` and `extractor update`.
* **(Extractor API)** Added an implementation of `Extractor._match_valid_url()` (introduced in `yt-dlp`) for backends that do not yet support it.

Changes

* **(CLI)** The `backend install` and `extractor install` commands no longer update backends/extractors if they are already installed. `backend update`/`extractor update` should be used in that case.
* **(Config)** The default order of extractors was changed to `:plugins:`, `:builtins:`, `generic`. It was not possible to override any built–in extractor with an extractor provided by a plugin when `:builtins:` had a higher priority than `:plugins:`.

Deprecations

* **(Extractor API)** `Extractor.dlp_match()` is deprecated, `Extractor._match_valid_url()` should be used instead.

Fixes

* Added a workaround for lazy extractors.
* **(Extractor API)** `Extractor.dlp_match()` is now compatible with `yt-dlp`.

Improvements

* **(CLI)** Improved compat mode detection. All known backends are checked now, not only `youtube-dl`.

Features

* Extractor plugins management. It is now possible to install extractor plugins using `dl-plus` itself. Plugins are installed into the `dl-plus` config directory. The format of the command is as follows: `dl-plus --cmd extractor install NAME [VERSION]`.
* Configuration via environment variables:
- `DL_PLUS_HOME` — the directory where the default config (`config.ini`), backends and extractors are stored. The default value is `$XDG_CONFIG_HOME/dl-plus`/`%APPDATA%\dl-plus`.
- `DL_PLUS_CONFIG` — the path of the config file. The default value is `$DL_PLUS_HOME/config.ini`.

This is a fixed build of the version 0.4.0.

Check https://github.com/un-def/dl-plus/releases/tag/0.4.0 for the release notes.