Skip to main content

M3U8 Downloader is a Python class designed to download and concatenate video files from M3U8 playlists.

Project description

pym3u8downloader

M3U8 Downloader is a Python class designed to download and concatenate video files from M3U8 playlists, including master playlists. This class offers comprehensive functionality for managing M3U8 playlist files, downloading video segments, optionally combining them into a single video file, and handling various error conditions.

Installation

M3U8Downloader can be installed using pip:

pip install pym3u8downloader

Usage

from pym3u8downloader import M3U8Downloader

# Initialize the downloader
downloader = M3U8Downloader(
    input_file_path="http://example.com/video.m3u8",
    output_file_path="output_video"
)

# Download and concatenate the playlist
downloader.download_playlist()

# Download and concatenate the master playlist
downloader.download_master_playlist(name='720')

# Output
# Verify  : [##################################################] 100%
# Download: [##################################################] 100%
# Build   : [##################################################] 100%

Documentation

pym3u8downloader

M3U8Downloader

Constructors

  • M3U8Downloader(input_file_path: str, output_file_path: str, skip_space_check: Optional[bool] = False, debug: Optional[bool] = False, debug_file_path: Optional[str] = 'debug.log', max_threads: Optional[int] = 10, verify_ssl: Optional[bool] = True): Initializes the M3U8Downloader object with the specified parameters.

Methods

  • download_playlist(merge: bool = True): Downloads video files from an M3U8 playlist. The optional merge parameter determines the handling of the downloaded segments. When merge is set to True, the method downloads and concatenates all video segments into a single output file. If merge is False, it only downloads the segments without concatenating them, keeping each segment as an individual file.
  • download_master_playlist(name: Optional[str] = None, bandwidth: Optional[str] = None, resolution: Optional[str] = None, merge: bool = True): Downloads video files from an M3U8 master playlist, with the specific variant selected based on optional parameters such as name, bandwidth, and resolution. The optional merge parameter determines the handling of the downloaded segments. When merge is set to True, the method downloads and concatenates all video segments into a single output file. If merge is False, it only downloads the segments without concatenating them, keeping each segment as an individual file.

Properties

  • input_file_path: Getter/setter property for the input file path.
  • output_file_path: Getter/setter property for the output file path.
  • skip_space_check: Getter/setter property for the skip space check flag.
  • debug: Getter/setter property for the debug flag.
  • debug_file_path: Getter/setter property for the debug file path.
  • max_threads: Getter/setter property for the maximum number of threads that can be executed in parallel.
  • is_download_complete: Getter property for the download completion status.
  • verify_ssl: Getter/setter property for the verify SSL flag. This helps skip SSL warnings for HTTPS-based URLs. Defaults to True.

M3U8DownloaderError

This error class is employed to signal any issues or errors encountered during the execution of M3U8Downloader methods.

Constructors

  • M3U8DownloaderError(message: str): Initialize a M3U8DownloaderError.

M3U8DownloaderWarning

This warning class is employed to signal any issues encountered during the execution of the download_master_playlist method of the M3U8Downloader class, especially when no parameters are passed. Along with the warning message, the json_data variable is returned with all available resolution formats (variants) in JSON-structured format.

Constructors

  • M3U8DownloaderWarning(message: str, json_data: Optional[list] = None): Initialize a M3U8DownloaderWarning.

Troubleshooting Guide

For detailed troubleshooting guide, please refer to TROUBLESHOOTING.

License

Please refer to the MIT License within the project for more information.

Contributing

We welcome contributions from the community! Whether you have ideas for new features, bug fixes, or enhancements, feel free to open an issue or submit a pull request on GitHub.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

pym3u8downloader-0.1.8-py3-none-any.whl (13.8 kB view details)

Uploaded Python 3

File details

Details for the file pym3u8downloader-0.1.8-py3-none-any.whl.

File metadata

File hashes

Hashes for pym3u8downloader-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 29469ae682a0fe32af2ad8862148dc04d8a21fad7796749338bc01c7ded26cf3
MD5 88f6529d75a357fbe22233a003adb616
BLAKE2b-256 1b1cdd89b3b49d552cadb8de5a406d2272722e1c5c90bac056c5dc1ec14847c4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page