Skip to main content

Installation overview

HLS Downloader is available for all major browsers. The installation method varies depending on whether your browser has an official store listing or requires manual installation.
Newer versions (≥ 4.1.2) ship only as ZIP archives. Older versions can still be installed from CRX files (see legacy notes below).

Official store installations

Install from Firefox Add-ons

The easiest way to install HLS Downloader on Firefox is through the official add-ons store:
  1. Visit the HLS Downloader add-on page
  2. Click Add to Firefox
  3. Confirm the permissions prompt
  4. You’re ready to go!

Manual installation (temporary)

For testing or development purposes:
1

Download the extension

Get the latest .xpi file from the releases page
2

Open Firefox debugging

Navigate to about:debugging#/runtime/this-firefox
3

Load temporary add-on

Click Load Temporary Add-on… and select the XPI file
Temporary add-ons are removed when Firefox restarts. For permanent installation, use the official add-ons store.

Manual installation (Chromium browsers)

Chrome, Brave, Arc, and Opera require manual installation using the developer mode. All these browsers use the same .zip package.
1

Download the extension

Download extension-mv3-chrome.zip from the latest release
2

Extract the ZIP

Unzip the file to a convenient folder on your computer
3

Open extensions page

Navigate to chrome://extensions/
4

Enable developer mode

Toggle Developer mode in the top-right corner
5

Load unpacked extension

Click Load unpacked and select the extracted folder (the one containing manifest.json)
6

Done

HLS Downloader is now installed! 🎉
Chrome currently has an experimental MV3 build available from source. See the Development guide for build instructions.

Legacy installation (versions < 4.1.2)

Verify installation

After installation, you should see the HLS Downloader icon in your browser toolbar. If you don’t see it:
  1. Click the puzzle icon (extensions menu) in your toolbar
  2. Find HLS Downloader in the list
  3. Click the pin icon to keep it visible

Next steps

Quickstart guide

Learn how to download your first HLS stream

Build docs developers (and LLMs) love