About The Project

This project enable web scrapping for video that come with most common file extension; .mp4, .ts, .m4s, which normally require .m3u8 playlist.

What is m3u8 file?

A file with the M3U8 file extension is a UTF-8 encoded playlist file. M3U8 files are plain text files that can be used to store the URL paths of streaming audio or video and information about the media tracks. (VIVE BUSINESS, 2023)

More Info on m3u8

Expected Outcome of this Project

Able to extract and access the URL paths of streaming video (which will be a ts video file in multiple segments) to download the contents.

Getting Started

Prerequisites

• Setup environment

  git clone <this repo>
  pip3 install -r requirements.txt

2 Usage Method

1. Run as Microservice with Flask
2. Running via Script

Make sure to obtain the .mp4 or .m3u8 link.

How to get .m3u8 link

1. Open Developer Tools or Ctrl + Shift + I on your browser.
2. Search the video you would like to donwload and play it.
3. On Developer Tools open Network Tab.
4. Type ".m3u8" in the search bar.
5. Right click on the m3u8 master file and copy the link address.
   

Usage (Run as Microservice with Flask)

Run the following command and navigate to the application server (e.g. http://127.0.0.1:3000).

flask --app app run --port 3000

Note: Only support MP4 video download for now.

Usage (Running via Script)

Run the following script.

python3 video_downloader.py "<the_link>" --name-file-as custom_name

Optional Example Files to Use

Example 1

python3 main.py "<the link>" ./downloaded_video/ <name the file as you like>

Example 2: (Help you get the title of the video based on the website)

python3 main.py "<the_link>" ./downloaded_video/ "<website_link>"

Notes: Make sure to always set the html element that you would like to target (example2-4).

Example 3: (Compile all the m3u8 url and website url to download multiple video)

Create 2 txt file for video url and website url compilation.

Save all the video url and website url in respective txt file.

python3 main.py "<videos_url_file_path>" "<websites_url_file_path>" ./downloaded_video/

Example 4: (Download video with multi-threading)

python3 main.py "<videos_url_file_path>" "<websites_url_file_path> ./downloaded_video/"

If successful you will get the downloaded file in "downloaded_video" folder.

Roadmap

• Add Progress Bar
• Create a simple UI and executable program
• Catch connection error to avoid re-download
• Write unittest

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

Acknowledgments

Thanks to:

1. Coding Bunch For the tutorial video on how to donwload ts video file via m3u8. Highly recommend others to watch, he explained the whole system very well!
2. Globo.com For providing a great repo on loading m3u8 file format.

Thanks for making it free and a source for educational purpose.

Disclaimer

This project does not suggest/recommend/encourage copyright infringement of anykind.

(back to top)