MCPcopy Index your code
hub / github.com/nexmoe/VidBee

github.com/nexmoe/VidBee @v1.3.13 sqlite

repository ↗ · DeepWiki ↗ · release v1.3.13 ↗
1,877 symbols 5,023 edges 357 files 93 documented · 5%
README

Logo

VidBee

<a href="https://github.com/nexmoe/VidBee/stargazers"><img src="https://img.shields.io/github/stars/nexmoe/VidBee?color=ffcb47&labelColor=black&logo=github&label=Stars" /></a>
<a href="https://github.com/nexmoe/VidBee/graphs/contributors"><img src="https://img.shields.io/github/contributors/nexmoe/VidBee?ogo=github&label=Contributors&labelColor=black" /></a>
<a href="https://github.com/nexmoe/VidBee/releases"><img src="https://img.shields.io/github/downloads/nexmoe/VidBee/total?color=369eff&labelColor=black&logo=github&label=Downloads" /></a>
<a href="https://github.com/nexmoe/VidBee/releases/latest"><img src="https://img.shields.io/github/v/release/nexmoe/VidBee?color=369eff&labelColor=black&logo=github&label=Latest%20Release" /></a>
<a href="https://x.com/intent/follow?screen_name=nexmoex"><img src="https://img.shields.io/badge/Follow-blue?color=1d9bf0&logo=x&labelColor=black" /></a>
<a href="https://deepwiki.com/nexmoe/VidBee"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>






<a href="https://github.com/nexmoe/VidBee/releases/latest" target="_blank"><img src="https://github.com/nexmoe/VidBee/raw/v1.3.13/screenshots/main-interface.png" alt="VidBee Desktop" width="46%"/></a>
<a href="https://github.com/nexmoe/VidBee/releases/latest" target="_blank"><img src="https://github.com/nexmoe/VidBee/raw/v1.3.13/screenshots/download-queue.png" alt="VidBee Download Queue" width="46%"/></a>

VidBee is a modern, open-source video downloader that lets you download videos and audios from 1000+ websites worldwide. Built with Electron and powered by yt-dlp, VidBee offers a clean, intuitive interface with powerful features for all your downloading needs, including RSS auto-download automation that automatically subscribes to feeds and downloads new videos from your favorite creators in the background.

👋🏻 Getting Started

VidBee is currently under active development, and feedback is welcome for any issue encountered.

📥 Download VidBee | 📚 Documentation

[!IMPORTANT]

Star Us, You will receive all release notifications from GitHub without any delay ~

<img alt="Performance Stats of nexmoe/VidBee - Last 28 days" src="https://next.ossinsight.io/widgets/official/compose-last-28-days-stats/thumbnail.png?repo_id=1081230042&image_size=auto&color_scheme=light" width="655" height="auto">

✨ Features

🌍 Global Video Download Support

Download videos from almost any website worldwide through the powerful yt-dlp engine. Support for 1000+ sites including YouTube, TikTok, Instagram, Twitter, and many more.

VidBee Main Interface

🎨 Best-in-class UI Experience

Modern, clean interface with intuitive operations. One-click pause/resume/retry, real-time progress tracking, and comprehensive download queue management.

VidBee Download Queue

📡 RSS Auto Download

Automatically subscribe to RSS feeds and auto-download new videos in the background from your favorite creators across YouTube, TikTok, and more. Set up RSS subscriptions once, and VidBee will automatically download new uploads without manual intervention, perfect for keeping up with your favorite channels and creators.

🎞️ Configurable Output Containers

Pick between Auto (MP4/MKV), MP4, MKV, WebM, or yt-dlp's Original defaults for one-click downloads — no more wondering whether you'll get an MP4 or a WebM. See Formats & Containers for the full breakdown.

🌐 Supported Sites

VidBee supports 1000+ video and audio platforms through yt-dlp. For the complete list of supported sites, visit https://vidbee.org/supported-sites/

🧱 Web + API (Docker-ready)

This monorepo now includes:

  • packages/downloader-core: Shared yt-dlp/ffmpeg download core
  • apps/api: Fastify API server with oRPC and SSE events
  • apps/web: TanStack Start web client using oRPC

Run locally:

pnpm run start:web

This command starts apps/api and apps/web together.

Run with Docker:

docker compose up -d --build

Run with GitHub Container Registry images:

services:
  api:
    image: ghcr.io/nexmoe/vidbee-api:latest
    environment:
      VIDBEE_API_HOST: 0.0.0.0
      VIDBEE_API_PORT: 3100
      VIDBEE_DOWNLOAD_DIR: /data/downloads
      VIDBEE_HISTORY_STORE_PATH: /data/vidbee/vidbee.db
    ports:
      - "3100:3100"
    volumes:
      - vidbee-downloads:/data/downloads
      - vidbee-data:/data/vidbee
    restart: unless-stopped

  web:
    image: ghcr.io/nexmoe/vidbee-web:latest
    depends_on:
      - api
    ports:
      - "3000:3000"
    restart: unless-stopped

volumes:
  vidbee-downloads:
  vidbee-data:

Stop services:

docker compose down

Optional env vars (via .env):

VIDBEE_API_PORT=3100
VIDBEE_WEB_PORT=3000
VITE_API_URL=http://localhost:3100

🤝 Contributing

You are welcome to join the open source community to build together. For more details, check out:

  • Monorepo apps:
  • apps/desktop: VidBee desktop app (Electron)
  • apps/docs: Documentation site (Fumapress)
  • apps/extension: Browser extension (WXT)
  • apps/desktop/docs/glitchtip.md: GlitchTip and sentry-cli setup for desktop monitoring
  • Contributing Guide
  • DeepWiki Documentation

📄 License

This project is distributed under the MIT License. See LICENSE for details.

🙏 Thanks

  • yt-dlp - The powerful video downloader engine
  • FFmpeg - The multimedia framework for video and audio processing
  • Electron - Build cross-platform desktop apps
  • React - The UI library
  • Vite - Next generation frontend tooling
  • Tailwind CSS - Utility-first CSS framework
  • shadcn/ui - Beautifully designed components

Extension points exported contracts — how you extend this code

FeedFetcher (Interface)
(no doc) [4 implementers]
packages/subscriptions-core/src/feed-parser.ts
PersistAdapter (Interface)
(no doc) [3 implementers]
packages/task-queue/src/persist/adapter.ts
ProbeSpawnHandle (Interface)
(no doc) [3 implementers]
apps/cli/src/download/probe.ts
LanguageDefinition (Interface)
(no doc)
packages/i18n/src/languages.ts
BrowserCookiesSetting (Interface)
(no doc)
packages/downloader-core/src/browser-cookies-setting.ts
AppSidebarIcon (Interface)
(no doc)
packages/ui/src/components/ui/app-sidebar.tsx
RybbitClient (Interface)
(no doc)
apps/desktop/src/renderer/src/env.d.ts
RawVideoInfo (Interface)
(no doc)
apps/api/src/lib/yt-dlp-info.ts

Core symbols most depended-on inside this repo

t
called by 776
apps/desktop/src/main/tray.ts
push
called by 284
packages/task-queue/src/util/min-heap.ts
cn
called by 112
packages/ui/src/lib/cn.ts
on
called by 103
apps/cli/src/download/probe.ts
get
called by 99
apps/desktop/src/main/lib/bounded-output-buffer.ts
get
called by 93
packages/task-queue/src/persist/sqlite.ts
add
called by 84
packages/subscriptions-core/src/store.ts
set
called by 75
apps/desktop/src/main/settings.ts

Shape

Function 1,093
Method 397
Interface 301
Class 86

Languages

TypeScript100%

Modules by API surface

packages/downloader-core/src/downloader-core.ts55 symbols
packages/subscriptions-core/src/store.ts45 symbols
packages/task-queue/src/persist/sqlite.ts33 symbols
packages/downloader-core/src/yt-dlp-executor.ts33 symbols
packages/task-queue/src/api/index.ts32 symbols
apps/desktop/scripts/setup-dev-binaries.js32 symbols
apps/web/src/components/download/download-item.tsx31 symbols
apps/desktop/src/renderer/src/components/download/DownloadItem.tsx29 symbols
apps/cli/src/transport/automation-client.ts23 symbols
packages/subscriptions-core/src/api.ts22 symbols
apps/desktop/src/shared/telemetry/issue-filter.ts22 symbols
apps/desktop/src/main/index.ts22 symbols

Dependencies from manifests, versioned

@biomejs/biome2.3.13 · 1×
@electron-toolkit/preload3.0.2 · 1×
@electron-toolkit/tsconfig2.0.0 · 1×
@electron-toolkit/utils4.0.0 · 1×
@fastify/cors11.2.0 · 1×
@hookform/resolvers5.2.2 · 1×
@iconify/json2.2.394 · 1×
@opentelemetry/api1.9.0 · 1×
@orpc/client1.13.5 · 1×
@orpc/contract1.13.5 · 1×
@orpc/openapi1.13.5 · 1×
@orpc/server1.13.5 · 1×

For agents

$ claude mcp add VidBee \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact