Userscript installation

April 19, 2026 ยท View on GitHub

Plugin installation

Install Greasemonkey (firefox) or Tampermonkey (chrome)

Add script

In the plugin dashboard, create a new userscript and copy the content of userscript.js.

Configuration

Mandatory configuration

You need to specify the url of your ydl_api_ng and your User token (if user management is enabled)

// CUSTOMIZE HERE
const default_host = 'http://localhost:5011';
const userToken = null;
// STOP CUSTOMIZE HERE

Matching websites

By default, the userscript is only enabled on youtube.

// @match       http*://www.youtube.com*/*

You can enable the userscript everywhere but it may create conflicts in some cases

// @match       http*://*/*

Instead you can add your most common websites one by one : see tampermonkey documentation

Presets

There is a few default presets present in the default userscript and you can modify anything you want !

// CUSTOMIZE HERE
const routes = {};
const programmation_id = new URL(document.URL).pathname.replaceAll('/', '');
const presets_mapping = {};
const site_mapping = [];
// STOP CUSTOMIZE HERE

Userscript in action