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
