whatisgithub

What is xiaoer-videolab?

jane-xiaoer/xiaoer-videolab — explained in plain English

Analysis updated 2026-05-18

456JavaScriptAudience · generalComplexity · 2/5Setup · moderate

In one sentence

A privacy-focused browser extension that downloads the video on your current tab in one click, using a local yt-dlp helper program.

Mindmap

mindmap
  root((xiaoer-videolab))
    What it does
      One-click video download
      1800 plus supported sites
      Local yt-dlp helper
      Progress notifications
    Tech stack
      JavaScript extension
      Python background server
      yt-dlp
      ffmpeg
    Use cases
      Save videos for offline viewing
      Archive social media clips
      Download from many platforms
    Audience
      General users
      Non-technical downloaders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Download the video from the current browser tab with a single click.

USE CASE 2

Save clips from YouTube, Bilibili, TikTok, Instagram, and 1,800-plus other sites.

USE CASE 3

Run a lightweight local helper that keeps the extension itself from reading page content.

USE CASE 4

Get a desktop notification when a download finishes.

What is it built with?

JavaScriptPythonyt-dlpffmpeg

How does it compare?

jane-xiaoer/xiaoer-videolabfastify/fastify-helmetfastify/avvio
Stars456463467
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-07-082026-07-14
MaintenanceActiveActive
Setup difficultymoderateeasyeasy
Complexity2/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 5min

Requires installing yt-dlp and ffmpeg locally, then loading the extension in developer mode.

So what is it?

Xiaoer VideoLab is a browser extension that downloads the video on whatever page you are currently viewing, saving it to your Downloads folder with one click. It works on macOS and Windows and supports over 1,800 video sites, including YouTube, Bilibili, TikTok, X/Twitter, Instagram, Vimeo, and many others. The design is privacy-focused. Most video downloader extensions request broad permissions to read everything on every website you visit. This one requests only the current tab's URL when you click the button, and sends that single URL to a small background program running on your own computer. The extension itself has no access to page content and makes no outbound network requests. All actual downloading is handled locally by a tool called yt-dlp, which is a well-known open-source downloader that you install separately. The background program is a minimal Python server that starts automatically when you log in (using launchd on macOS, or Task Scheduler on Windows). When the extension sends it a URL, it passes that URL to yt-dlp, which fetches the video and saves it as an mp4 file. A macOS notification appears when the download finishes. The extension badge shows progress and whether the download succeeded or failed. Installing it takes about five minutes. On Mac you install yt-dlp and ffmpeg using Homebrew, clone the repository, run an install script, and then load the extension folder into Chrome's developer mode. On Windows the steps are similar using PowerShell and the built-in Windows package manager. The README is written for people with no coding experience and walks through each step. Not all sites work equally well. DRM-protected streaming content cannot be downloaded. A few Chinese platforms such as WeChat Channels and Kuaishou are not supported. Some sites like Douyin and Xiaohongshu require you to have the video playing on screen before clicking. The full list of supported and unsupported sites is documented in the README.

Copy-paste prompts

Prompt 1
Walk me through installing Xiaoer VideoLab and yt-dlp on macOS with Homebrew.
Prompt 2
Show me how to load the Xiaoer VideoLab extension into Chrome developer mode on Windows.
Prompt 3
Explain why Xiaoer VideoLab only asks for the current tab's URL instead of broad permissions.
Prompt 4
Which video sites does Xiaoer VideoLab not support, and why?

Frequently asked questions

What is xiaoer-videolab?

A privacy-focused browser extension that downloads the video on your current tab in one click, using a local yt-dlp helper program.

What language is xiaoer-videolab written in?

Mainly JavaScript. The stack also includes JavaScript, Python, yt-dlp.

How hard is xiaoer-videolab to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is xiaoer-videolab for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.