Skip to main content

m3u8downloader

m3u8downloader is a tool to download video at a m3u8 link. HTTP Live Streaming (HLS) is becoming popular. m3u8 playlist is used by HLS to serve video fragments of different quality to different clients. This tool supports HLS master playlist and media playlist. If master playlist is given, it selects the highest resolution automatically. HLS fragment encryption is supported. Resume from partial download is supported, just rerun the same command to continue.

ffmpeg is used to convert the downloaded fragments into final mp4 video file.

Installation

To install m3u8downloader, simply:

$ sudo apt install -y ffmpeg
$ pip install --user m3u8downloader

Quick Start

Example command line usage:

downloadm3u8 -o ~/Downloads/foo.mp4 https://example.com/path/to/foo.m3u8

If ~/.local/bin is not in $PATH, you can use full path:

~/.local/bin/downloadm3u8 -o ~/Downloads/foo.mp4 https://example.com/path/to/foo.m3u8

Here is built-in command line help:

usage: m3u8downloader [-h] [--version] [--debug] --output OUTPUT
                      [--tempdir TEMPDIR] [--concurrency N]
                      URL

download video at m3u8 url

positional arguments:
  URL                   the m3u8 url

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --debug               enable debug log
  --output OUTPUT, -o OUTPUT
                        output video filename, e.g. ~/Downloads/foo.mp4
  --tempdir TEMPDIR     temp dir, used to store .ts files before combing them
                        into mp4
  --concurrency N, -c N
                        number of fragments to download at a time

Documentation

This command line tool doesn’t have extra documents.

Limitations

This tool only parses minimum m3u8 extensions for selecting media playlist from master playlist, downloading key and fragments from media playlist. If a m3u8 file doesn’t download correctly, it’s probably some new extension was added to the HLS spec which this tool isn’t aware of.

ChangeLog

  • v0.7.7 2019-03-08

    • bugfix: always rewrite fragment url to local abs path

  • v0.7.5 2019-03-07

    • set default log level to INFO

  • v0.7.4 2019-03-07

    • initial release

Metadata

Release files for m3u8downloader 0.7.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for m3u8downloader 0.7.7
File Size Uploaded Provenance Actions
m3u8downloader-0.7.7.tar.gz 7.4 kB Without provenance Details for m3u8downloader-0.7.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for m3u8downloader 0.7.7
File Interpreter ABI Platform Actions
m3u8downloader-0.7.7-py2.py3-none-any.whl Python 2, Python 3 none any Details for m3u8downloader-0.7.7-py2.py3-none-any.whl

Total release size: 17.8 kB

Release files / m3u8downloader-0.7.7.tar.gz

Download URL m3u8downloader-0.7.7.tar.gz
Size 7.4 kB
Tags Source
SHA-256 checksum
How to use checksums
154bad4ab064c809a08e88a59afbee07d5f673ff157a27d2468b7cf68a34994e
BLAKE2b-256 checksum
How to use checksums
cb431d701154f6dfd4747c0ca94e4d26864e7d15aacffa399272ddc0d1e68111
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.5.3

Release files / m3u8downloader-0.7.7-py2.py3-none-any.whl

Download URL m3u8downloader-0.7.7-py2.py3-none-any.whl
Size 10.4 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
15f258b5fefb8180b05e58e24fef80136d08710196bc5db89eb384731dc39d5f
BLAKE2b-256 checksum
How to use checksums
c8c8b89078dab41acceb2cb242478c67c0f9497d1fb87cd9ec76a6828ed53cbc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.5.3

Security for m3u8downloader 0.7.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page