# 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

A working instance of **ffmpeg** in the path.

## 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

Copyright © 2025 Georg Hopp

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>