NDBot v2.03.0525

A self-hosted workspace for unified media downloads, file management, and cloud transfer, designed by AiPo.

中文 README

Why NDBot Exists

Videos, images, audio, public links, and cloud-drive files often live across Telegram, media platforms, social networks, and multiple cloud drives. NDBot brings downloading, task queues, file preview, account isolation, site cookies, cloud transfer, and Telegram Bot input into one self-hosted console.

It is built for individuals, small teams, and self-hosting users who want control over their download workflow, media files, and cloud transfer rules.

Core Features

• Web console: dashboard, task list, file browser, preview, admin console, and queue governance.
• Telegram Bot: admins configure a shared Bot; users bind their Web account with one-time binding codes.
• Multi-user isolation: permissions, storage roots, task visibility, cookies, rclone configs, and Bot binding are isolated per user.
• Media downloads: YouTube, X.com, Bilibili, Instagram, TikTok, Telegram media, and yt-dlp supported sites.
• Cloud transfer: Google Drive, OneDrive, S3-compatible storage, WebDAV; Baidu, Aliyun, Quark, and similar drives can be connected through AList/WebDAV.
• File collections: cinema, gallery, concert, library, and comics presets for browsing the same files in different modes.
• Operations and security: 2FA, login rate limits, quotas, retries, dead-letter queue, audit records, admin queue governance.
• Internationalization groundwork: account-level interface language and time-zone preferences.

What's New in v2.03.0525

This release upgrades the first open-source NDBot into a multi-user self-hosted workspace:

• Account-based Web users with roles, permissions, invite codes, 2FA, and Telegram Bot binding codes.
• Personal media library with thumbnails, safe rename, source labels, and preset collections.
• Per-account cloud remotes, default Bot cloud target, and cloud-only save mode.
• AList/WebDAV guidance for Baidu, Aliyun, Quark, and similar cloud-drive gateway scenarios.
• Retry, dead-letter handling, audit records, queue governance, user quotas, traffic accounting, and admin user management.
• Account-level language and time-zone preferences for international self-hosted users.

Install

NDBot supports three installation paths. Docker Compose is the recommended production path, while the installers are easier for first-time users.

Option 1: Shell Installer

git clone https://github.com/aipo-lenshow/NDBot.git
cd NDBot
bash install.sh

The shell installer asks for language, install directory, Web port, download path, proxy, optional AList, and whether to start services.

Option 2: Python Installer

git clone https://github.com/aipo-lenshow/NDBot.git
cd NDBot
python3 install.py

The Python installer provides the same flow with a richer terminal UI.

Option 3: Manual Docker Compose

git clone https://github.com/aipo-lenshow/NDBot.git
cd NDBot
cp .env.example .env
# Optional: edit WEB_PORT, DOWNLOAD_PATH, proxy, and secrets
docker compose up -d --build

Open:

http://<your-server-ip>:5000

The first registered account becomes the administrator. Configure the shared Telegram Bot from the admin page after login. Language, timezone, user policy, cookies, and cloud drives are configured in the Web UI.

See INSTALL.md for details and upgrade notes.

Project Layout

bot/        Telegram Bot service
worker/     Download, transfer, cleanup, and background jobs
web/        Flask Web console
rclone/     rclone config template
scripts/    Local pre-commit safety checks

Cloud Drives

NDBot uses rclone for cloud-drive connectivity. Google Drive, OneDrive, S3, and WebDAV follow official rclone backends. Baidu, Aliyun, Quark, and similar drives are best connected through AList exposing WebDAV.

Some WebDAV/AList gateways do not return quota information. This does not mean the remote is broken; listing, upload, and transfer can still work normally.

Contributing

Bug reports and feature requests are welcome. Please read CONTRIBUTING.md before opening a pull request, and never attach .env, cookies, sessions, rclone configs, databases, or downloaded private files to public issues.

Security

Please do not report security issues in public issues. Email AiPo@ailenshow.com instead. See SECURITY.md.

License

Copyright (C) 2026 AiPo

NDBot is licensed under the GNU Affero General Public License v3.0.

You may use, deploy, and modify this project freely. If you provide a modified version as a network service to others, AGPL-3.0 requires you to publish the corresponding source code.

Author

AiPo

• Email: AiPo@ailenshow.com
• GitHub: https://github.com/aipo-lenshow/NDBot