Skip to content

Repository files navigation

NoBsDL Video Downloader (userscript)

Download right on the page

Download videos as MP4 and audio as MP3 without leaving the page. Open the panel, pick a real quality with its file size, watch the live server progress, and the file goes straight to your browser's downloads. Powered by NoBsDL.

Install

  1. Install Tampermonkey or Violentmonkey.
  2. Install the userscript from Greasy Fork or a mirror:

What you get

  • In-page downloads: a small NoBsDL button sits in the corner of supported media pages. Choose a format and the file is saved without opening a new tab.
  • Real formats only: every quality comes from the actual source, with NoBsDL's size estimate. Nothing is invented.
  • Live progress: Queue → Download → Process → Ready, with a real percentage while bytes flow (and while MP3 is encoded), speed and time left.
  • Close it any time: the job keeps running, the button shows the percentage and the file is still saved when ready.
  • MP3 128 / 256 / 320 kbps next to the MP4 qualities.
  • Minimize to a small round button; the choice is remembered.
  • Falls back to opening the matching NoBsDL page when your userscript manager does not provide GM_xmlhttpRequest.

NoBsDL's interaction promise applies to everyone: No popups. No forced redirects. No fake download buttons. Just download.

Supported pages

  • YouTube videos and Shorts (playlists open NoBsDL's playlist tool). Mix/Radio links stay single-video downloads.
  • TikTok videos and mobile shortlinks.
  • Instagram Reels and media posts.
  • Public Facebook video and Reel pages.
  • Reddit video posts and direct redd.it media links.
  • X/Twitter status pages containing media.
  • Public Vimeo video pages.
  • Twitch clips and past videos, Dailymotion videos, Pinterest pins, Bluesky posts, Streamable, Imgur, 9GAG, Odysee, Rutube and OK.ru video pages (via NoBsDL's universal downloader; each verified with a real download).
  • SoundCloud tracks, Bandcamp tracks and Mixcloud shows (MP3 only).

Only individual media pages show the button — never feeds, profiles or search pages.

Free and Supporter

Most downloads are free. Some higher resolutions and files over the free size limits (500 MB video, 100 MB MP3) need a paid NoBsDL Supporter key; the panel shows those choices with a lock and never starts them for a free session. This is declared as @antifeature payment. A Supporter session activated on nobsdl.com in the same browser is used when your userscript manager sends nobsdl.com cookies with its requests; otherwise use Open on NoBsDL in the panel, where your Supporter access works as usual.

Privacy and permissions

  • @grant GM_xmlhttpRequest (+ GM.xmlHttpRequest) with @connect nobsdl.com only: requests go to nobsdl.com and nowhere else.
  • Nothing is sent until you open the panel. Then the current public media URL is sent to nobsdl.com to list its formats; choosing one starts the job and polls its status. Feeds you merely scroll past are never looked up.
  • Requests may carry your normal nobsdl.com cookies (your userscript manager decides), which is how an active Supporter session can be recognised. The script itself stores no key, cookie or history; only whether you minimized the button (GM_getValue/GM_setValue).
  • No analytics, ads or tracking code in the script. The DOM is built with text nodes only (no innerHTML), inside a Shadow DOM.
  • Links use noopener, noreferrer and referrerPolicy="no-referrer".

The script does not bypass logins, private-media controls, paywalls or DRM. Download only media you are allowed to save.

Development

npm test                 # syntax + logic suite, no dependencies
npm install
CHROME_BIN=/path/to/chrome npm run test:browser   # mocked browser checks

The browser suite fulfils every page and NoBsDL API answer in-process; it does not contact media sites or NoBsDL. Screenshots in media/ were taken on a real YouTube page (Big Buck Bunny, CC-BY Blender Foundation) with the real NoBsDL service; recommendations are blurred.

License

MIT

About

Free Tampermonkey and Violentmonkey userscript with MP4 and MP3 download shortcuts for YouTube, TikTok, Instagram, Facebook, Reddit, X/Twitter, Vimeo and SoundCloud via NoBsDL.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages