Skip to content

Latest commit

 

History

History
79 lines (54 loc) · 2.73 KB

README.md

File metadata and controls

79 lines (54 loc) · 2.73 KB
Raw

M3UAssistant

Nowadays, video websites tend to break their online videos into hundreds (if not thousands) of TS fragments and stream them via an M3U playlist. This makes scraping rather hard as:

  1. Without access to the M3U playlist, we don't know how many files are there and what their names are
  2. Each TS fragment can be encrypted
  3. TS is not that popular hence might not be correctly recognised by many video players
  4. Hundreds of TS files are not watchable for humans at all

M3UAssistant is designed to address this problem by:

  1. Parsing the content (i.e. TS fragment URLs) of the target M3U8 file, and the key file if the TS fragments are encrypted
  2. Download the fragments and the value of decryption key if encrypted
  3. Concatenate fragments into one TS file
  4. Decrypt the TS file
  5. Convert the decrypted file to MP4, which can be recognised by all most all video player

Dependencies

Unfortunately, all of the following dependencies are required for now. In the short (hopefully) future, I will add the options of replacing them with other ones you would like to use.

However, hey, it is always nice to have a try on the following ones on this or other occasions if you haven't : )

Built-in dependencies

Hopefully, your computer already has the tool for concatenation: cat

pip3 dependencies

pip3 install -r requirements.txt

Other dependencies

The following dependencies can be installed via HomeBrew:

brew install aria2c
brew install openssl
  • FFmpeg For video conversion:
brew install ffmpeg

If you are not a macOS user, then good luck on finding them via your own package manager :P

Demo

Here is a demo on how to use this assistant:

  1. cd to the parent directory of M3UAssistant,
  2. Run with Python3:
python3 -m M3UAssistant.master_engine <target_m3u_url> -P <m3u_prefix> -O <output_name.mp4>

where:

  1. target_m3u_url is the URL to the M3U file to parse
  2. m3u_prefix is the prefix that should be added to each TS fragment URI in the M3U file to complete a full URL. Usually M3U will omit this prefix, but Normally you can identify it easily by checking out the full address of TS fragments in your browser.
  3. output_name.mp4 the name of the final output, as indicated by its name, it should end with .mp4

Optional arguments:

  1. --help, -h, showing the help message and exit
  2. --verbose True|False or -V True|False, indicating whether to print out the debug messages
  3. --*_tool, indicating whether to replace the default tools, coming soon