HLSGET

A tool to get a HLS video stream.

Synopsis

Usage: hlsget [OPTIONS] --name <NAME> --url <URL>

Options:
	-n, --name <NAME>
	-u, --url <URL>
	-b, --buffer <BUFFER>            request to store in client after concurrency limit reached [default: 10]
	-r, --rate <RATE>                number of requests per second the client should perform [default: 40]
	-c, --concurrency <CONCURRENCY>  number of concurrent requests [default: 20]
	-t, --timeout <TIMEOUT>          network io timeout [default: 30]
	-B                               also use timeout on body reads
	-R                               prevent reconnect after each iteration
	-w <WAIT>                        wait for temporary failure like 503 [default: 301]
	-o, --origin <ORIGIN>
	-a, --agent <AGENT>
	-v...                            Increase verbosity
	-h, --help                       Print help
	-V, --version                    Print version

Description

It downloads the m3u8 as well as all ts files. After that ffmpeg is called to merge these into a single mp4 file.

The download is performed concurrently and the amount of concurrent download as well as the request rate and other things are configurable through CLI.

The progress is visualized through progress bars for each ts download.

The real cool stuff was all done in the dependencies. I just sticked them together.

Requirements

[:Requirements:]

Dependencies

This tool uses the following crates:

crate (license)

anyhow-1.0 (MIT or Apache-2.0)
bytes-1.9 (MIT)
clap-4.5 (MIT or Apache-2.0)
env_logger-0.11 (MIT or Apache-2.0)
futures-util-0.3 (MIT or Apache-2.0)
http-1.2 (MIT or Apache-2.0)
http-body-util-0.1 (MIT)
indicatif-0.17 (MIT)
log-0.4 (MIT or Apache-2.0)
m3u8-rs-6.0 (MIT)
reqwest-0.12 (MIT or Apache-2.0)
shellwords-1.1 (MIT)
tokio-1.42 (MIT)
tower-0.5 (MIT)
tower-http-0.6 (MIT)
tower-http-client-0.4 (MIT or Apache-2.0)
tower-reqwest-0.4 (MIT or Apache-2.0)
which-7.0 (MIT)

As well as those dependencies respectively.

The license text can be found under licenses.

Contributing

[:Contributing:]

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Author

Georg Hopp georg@steffers.org

2.9 KiB Raw Blame History