VidBee

<div align="left"> <a href="https://github.com/nexmoe/VidBee"> <img src="apps/desktop/build/icon.png" alt="Logo" width="80" height="80"> </a> <h3>VidBee</h3> <p> <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> <br /> <br /> <a href="https://github.com/nexmoe/VidBee/releases/latest" target="_blank"><img src="screenshots/main-interface.png" alt="VidBee Desktop" width="46%"/></a> <a href="https://github.com/nexmoe/VidBee/releases/latest" target="_blank"><img src="screenshots/download-queue.png" alt="VidBee Download Queue" width="46%"/></a> <br /> <br /> </p> </div>

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 ~

<a href="https://next.ossinsight.io/widgets/official/compose-last-28-days-stats?repo_id=1081230042" target="_blank" style="display: block" align="left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://next.ossinsight.io/widgets/official/compose-last-28-days-stats/thumbnail.png?repo_id=1081230042&image_size=auto&color_scheme=dark" width="655" height="auto"> <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"> </picture> </a> <!-- Made with [OSS Insight](https://ossinsight.io/) -->

✨ 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.

🎨 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.

📡 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:

bashCopy
pnpm run start:web

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

Run with Docker:

bashCopy
docker compose up -d --build

Run with GitHub Container Registry images:

yamlCopy
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:

bashCopy
docker compose down

Optional env vars (via .env):

bashCopy
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 (Next.js)
  • 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