Skip to content

Firefox Extension

voc0der edited this page May 8, 2026 · 5 revisions

Firefox Extension

Setup

  1. Go to the extension page here and add the extension.

  2. Open the Add-ons menu in Firefox (Ctrl+Shift+A) and open the ytdl-material options.

  3. Modify the frontend URL to match the frontend URL of your instance. Click save.

  4. You're all set! Go to a YouTube page and click the icon to automatically start the download.

Chromium-based browser users can use the Chrome Extension package instead.

What the extension does

Main function

You can view the source code for the extension's main function here.

The extension uses your browser tab's URL to open a ytdl-material link that starts a download. As a result, the extension requires the tabs permission.

Settings storage

The ytdl-material frontend URL and audio-only preference are stored in the browser's extension storage. As a result, the extension requires the storage permission. View the settings JS code here, and HTML code here.

Android

Firefox for Android requires a custom Add-on collection for this extension. To set it up:

  1. Download Firefox Nightly from the Play Store
  2. Go into the settings and tap About Firefox Nightly at the bottom of the settings menu
  3. Tap on the Firefox logo until it enables the debug mode
  4. Go back into settings and tap Custom Add-on collection
  5. Type the following information in the dialog:
    • Collection owner: 15736936
    • Collection name: YTDL-M
  6. Add the extension
  7. Go back to settings and tap Add-ons, then ytdl-material, and set up the settings for the extension
  8. You're all set! Navigate to a YouTube page, tap the three dots on the bottom right, tap Add-ons, and then tap ytdl-material to start your download.

Clone this wiki locally