Update docs and changelog

CHANGELOG.md

@@ -3,6 +3,12 @@ twitch-dl changelog
 
 <!-- Do not edit. This file is automatically generated from changelog.yaml.-->
 
+### [2.2.0 (TBA)](https://github.com/ihabunek/twitch-dl/releases/tag/2.2.0)
+
+* **Requires python 3.8 or later**
+* Migrated to click lib for cli parsing
+* Add shell auto completion
+
 ### [2.1.4 (2024-01-06)](https://github.com/ihabunek/twitch-dl/releases/tag/2.1.4)
 
 * Fix error caused by twitch requiring https for the usher api (thanks

changelog.yaml

@@ -1,9 +1,11 @@
-3.0.0:
+2.2.0:
   date: TBA
   changes:
-    - "BREAKING: Requires python 3.8 or later"
-    - "Migrated to click lib for cli parsing"
-    - "Add shell auto completion"
+    - "**Requires python 3.8 or later**"
+    - "Migrated to Click library for generating the commandline interface"
+    - "Add shell auto completion, see: https://twitch-dl.bezdomni.net/shell_completion.html"
+    - "Add setting defaults via environment variables, see: https://twitch-dl.bezdomni.net/environment_variables.html"
+    - "Add `download --concat` option to avoid using ffmeg for joinig vods and concat them instead. This will produce a `.ts` file by default."
 
 2.1.4:
   date: 2024-01-06

docs/SUMMARY.md

@@ -9,6 +9,8 @@
     - [twitch-dl clips](commands/clips.md)
     - [twitch-dl info](commands/info.md)
     - [twitch-dl env](commands/env.md)
+- [Environemnt variables](environment_variables.md)
+- [Shell completion](shell_completion.md)
 - [Advanced](advanced.md)
 
 [License](license.md)

docs/changelog.md

@@ -3,6 +3,12 @@ twitch-dl changelog
 
 <!-- Do not edit. This file is automatically generated from changelog.yaml.-->
 
+### [2.2.0 (TBA)](https://github.com/ihabunek/twitch-dl/releases/tag/2.2.0)
+
+* **Requires python 3.8 or later**
+* Migrated to click lib for cli parsing
+* Add shell auto completion
+
 ### [2.1.4 (2024-01-06)](https://github.com/ihabunek/twitch-dl/releases/tag/2.1.4)
 
 * Fix error caused by twitch requiring https for the usher api (thanks

docs/commands/download.md

@@ -26,6 +26,11 @@ twitch-dl download [OPTIONS] [IDS]...
     <td>Download a single chapter of the video. Specify the chapter number or use the flag without a number to display a chapter select prompt.</td>
 </tr>
 
+<tr>
+    <td class="code">--concat</td>
+    <td>Do not use ffmpeg to join files, concat them instead</td>
+</tr>
+
 <tr>
     <td class="code">-d, --dry-run</td>
     <td>Simulate the download provcess without actually downloading any files.</td>
@@ -38,7 +43,7 @@ twitch-dl download [OPTIONS] [IDS]...
 
 <tr>
     <td class="code">-f, --format TEXT</td>
-    <td>Video format to convert into, passed to ffmpeg as the target file extension. [default: <code>mkv</code>]</td>
+    <td>Video format to convert into, passed to ffmpeg as the target file extension. Defaults to <code>mkv</code>. If <code>--concat</code> is passed, defaults to <code>ts</code>.</td>
 </tr>
 
 <tr>

docs/environment_variables.md

@@ -0,0 +1,15 @@
+# Environment variables
+
+> Introduced in twitch-dl 2.2.0
+
+twitch-dl allows setting defaults for parameters via environment variables.
+
+Environment variables should be named `TWITCH_DL_<COMMAND_NAME>_<OPTION_NAME>`.
+
+For example, when invoking `twitch-dl download`, if you always set `--quality
+source` you can set the following environment variable to make this the
+default:
+
+```
+TWITCH_DL_DOWNLOAD_QUALITY="source"
+```

docs/shell_completion.md

@@ -1,6 +1,6 @@
 # Shell completion
 
-> Introduced in twitch-dl 3.0.0
+> Introduced in twitch-dl 2.2.0
 
 twitch-dl uses [Click shell completion](https://click.palletsprojects.com/en/8.1.x/shell-completion/) which works on Bash, Fish and Zsh.
 

twitchdl/cli.py

@@ -176,7 +176,8 @@ def clips(
 @click.option(
     "--concat",
     is_flag=True,
-    help="Do not use ffmpeg to join files, concat them instead",
+    help="""Do not use ffmpeg to join files, concat them instead. This will
+         produce a .ts file by default.""",
 )
 @click.option(
     "-d",
@@ -227,7 +228,8 @@ def clips(
 @click.option(
     "-r",
     "--rate-limit",
-    help="Limit the maximum download speed in bytes per second. Use 'k' and 'm' suffixes for kbps and mbps.",
+    help="""Limit the maximum download speed in bytes per second. Use 'k' and
+         'm' suffixes for kbps and mbps.""",
     callback=validate_rate,
 )
 @click.option(