All-Url-Uploader

All Url Uploader is a Telegram bot that accepts direct file URLs and supported media links, downloads them with the right tool for the job, and sends the result back to Telegram with the correct media type, metadata, and optional custom thumbnail.

What It Handles

• direct file links
• url|filename
• url|filename|username|password
• url * filename
• YouTube quick audio and quick video downloads
• format selection for supported yt-dlp sources
• custom per-user thumbnails with /thumb and /delthumb

Bot Commands

• /start - welcome message, shortcuts, and usage guidance
• /help - supported link formats and flow overview
• /about - runtime details, repo link, and project notes
• /thumb - show the currently saved custom thumbnail
• /delthumb - remove the saved custom thumbnail

Quick Start

1. Clone the repository and move into it:

git clone https://github.com/kalanakt/All-Url-Uploader.git
cd All-Url-Uploader

2. Create a .env file in the project root:

BOT_TOKEN=
OWNER_ID=
AUTH_USERS=
DOWNLOAD_LOCATION=./DOWNLOADS
CHUNK_SIZE=128
HTTP_PROXY=
PROCESS_MAX_TIMEOUT=3700

3. Install dependencies:

uv sync --group dev

4. Start the bot:

uv run python bot.py

Environment

• BOT_TOKEN - required Telegram bot token
• OWNER_ID - required Telegram user ID for the bot owner
• AUTH_USERS - optional comma-separated list of user IDs that bypass the cooldown
• DOWNLOAD_LOCATION - optional base directory for temporary downloads and uploads
• CHUNK_SIZE - optional direct-download chunk size; values below 1024 are treated as kilobytes for backward compatibility
• HTTP_PROXY - optional proxy URL passed to network requests and yt-dlp
• PROCESS_MAX_TIMEOUT - optional process timeout in seconds for external tools

Project Layout

• root runtime entrypoints: bot.py, app.py, config.py
• routers: routers/
• services: services/
• shared helpers and models: utils/
• tests: tests/
• external documentation site: docs/

Docker

Build and run the container with your existing .env file:

docker build -t all-url-uploader .
docker run --env-file .env all-url-uploader

Checks

Run the same core checks used in GitHub Actions:

uv run pytest
uv run pylint $(git ls-files '*.py')
cd docs && npm run build

Deploy

Deploy on Railway	Deploy on Koyeb	Deploy on Heroku

Contributors

kalana kt	tromcho	Fzso	HYBRID	Danil	Avika Trivedi
Damindu Dhananjitha	Imgbot	Parthiv Katapara	Indrajeeth

Star History