Modern Chrome Web Extension and Firefox Browser Addon to Download HLS Videos using Native FFmpeg.

This Web Extension is a Work in Progress, may contain bugs or not work as expected.

• Install
• Features
  • Upcoming Features
  • Known Issues
• Configuration
• Support
• Development
  • Building
• Contributing

• Google Chrome Web Store
• Mozilla Firefox Add-ons

All Chromium Based Browsers can install the extension from the Chrome Web Store.

• Download *.m3u8 videos using a native ffmpeg application.
• Shows the total number of streams found on the toolbar icon.
• Sends a notification when complete you can click on to open the download folder.

• Playlist parsing to display correct qualities and combine audio/video.

• Streams with separate video and audio will show up as 2 downloads.
• Stream quality display is not yet accurate.
• Error handling and messages needs improving.

You can pin the Addon by clicking the Puzzle Piece, find the Web Extension icon, then;
Chrome, click the Pin icon.
Firefox, click the Settings Wheel and Pin to Toolbar.

To open the options, click on the icon (from above) then click Open Options.

For help using the web extension, utilize any these resources:

• Q&A Discussion: https://github.com/cssnr/hls-video-downloader/discussions/categories/q-a
• Request a Feature: https://github.com/cssnr/hls-video-downloader/discussions/categories/feature-requests

If you are experiencing an issue/bug or getting unexpected results, use:

• Report an Issue: https://github.com/cssnr/hls-video-downloader/issues
• Chat with us on Discord: https://discord.gg/wXy6m2X8wY
• Provide General Feedback: https://cssnr.github.io/feedback

Logs can be found inspecting the page (Ctrl+Shift+I), clicking on the Console, and; Firefox: toggling Debug logs, Chrome: toggling Verbose from levels dropdown.

To support this project, see the Contributing section at the bottom.

Quick Start

First, clone (or download) this repository and change into the directory.

Second, install the dependencies:

npm install

Finally, to run Chrome or Firefox with web-ext, run one of the following:

npm run chrome npm run firefox

Additionally, to Load Unpacked/Temporary Add-on make a manifest.json and run from the src folder, run one of the following:

npm run manifest:chrome npm run manifest:firefox

Chrome: https://developer.chrome.com/docs/extensions/get-started/tutorial/hello-world#load-unpacked
Firefox: https://extensionworkshop.com/documentation/develop/temporary-installation-in-firefox/

For more information on web-ext, read this documentation.
To pass additional arguments to an npm run command, use --.
Example: npm run chrome -- --chromium-binary=...

Install the requirements and copy libraries into the src/dist directory by running npm install. See gulpfile.js for more information on postinstall.

npm install

To create a .zip archive of the src directory for the desired browser run one of the following:

npm run build npm run build:chrome npm run build:firefox

For more information on building, see the scripts section in the package.json file.

1. Build or Download a Release.
2. Unzip the archive, place the folder where it must remain and note its location for later.
3. Open Chrome, click the 3 dots in the top right, click Extensions, click Manage Extensions.
4. In the top right, click Developer Mode then on the top left click Load unpacked.
5. Navigate to the folder you extracted in step #3 then click Select Folder.

1. Build or Download a Release.
2. Unzip the archive, place the folder where it must remain and note its location for later.
3. Go to about:debugging#/runtime/this-firefox and click Load Temporary Add-on...
4. Navigate to the folder you extracted earlier, select manifest.json then click Select File.
5. Optional: Open about:config search for extensions.webextensions.keepStorageOnUninstall and set to true.

If you need to test a restart, you must pack the addon. This only works in ESR, Development, or Nightly. You may also use an Unbranded Build: https://wiki.mozilla.org/Add-ons/Extension_Signing#Unbranded_Builds

1. Run npm run build:firefox then use web-ext-artifacts/{name}-firefox-{version}.zip.
2. Open about:config search for xpinstall.signatures.required and set to false.
3. Open about:addons and drag the zip file to the page or choose Install from File from the Settings wheel.

Please consider making a donation to support the development of this project and additional open source projects.

Additionally, you can give a 5-star rating on Google or Mozilla and star this project on GitHub.

Other Web Extensions I have created and published:

• Link Extractor
• Open Links in New Tab
• Auto Auth
• Cache Cleaner
• HLS Video Downloader
• Obtainium Extension
• SMWC Web Extension
• PlayDrift Extension
• ASN Plus
• Aviation Tools
• Text Formatter

For a full list of current projects visit: https://cssnr.github.io/