<p align="center"> <a href="https://www.fiverr.com/share/kpLBoo"> <img src="https://iili.io/BOeHp5J.jpg" alt="All Url Uploader banner" width="100%"/> </a> </p> <div align="center">

All Url Uploader

Upload direct links and supported media sources back to Telegram.

Built with aiogram, yt-dlp, and uv for a cleaner local workflow.

Docs · Contributing · Docker · Issues · Discussions

</div>

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

<!-- readme: contributors -start --> <table> <tbody> <tr> <td align="center"> <a href="https://github.com/kalanakt"> <img src="https://avatars.githubusercontent.com/u/86665964?v=4" width="100;" alt="kalanakt"/> <br /> _{<b>kalana kt</b>} </a> </td> <td align="center"> <a href="https://github.com/tromcho"> <img src="https://avatars.githubusercontent.com/u/113139586?v=4" width="100;" alt="tromcho"/> <br /> _{<b>tromcho</b>} </a> </td> <td align="center"> <a href="https://github.com/fzsouser"> <img src="https://avatars.githubusercontent.com/u/108298343?v=4" width="100;" alt="fzsouser"/> <br /> _<b>Fzso</b> </a> </td> <td align="center"> <a href="https://github.com/hybridvamp"> <img src="https://avatars.githubusercontent.com/u/48980248?v=4" width="100;" alt="hybridvamp"/> <br /> _{<b>HYBRID</b>} </a> </td> <td align="center"> <a href="https://github.com/Divarion-D"> <img src="https://avatars.githubusercontent.com/u/42798043?v=4" width="100;" alt="Divarion-D"/> <br /> _<b>Danil</b> </a> </td> <td align="center"> <a href="https://github.com/AvikaTrivedi"> <img src="https://avatars.githubusercontent.com/u/84050503?v=4" width="100;" alt="AvikaTrivedi"/> <br /> _{<b>Avika Trivedi</b>} </a> </td> </tr> <tr> <td align="center"> <a href="https://github.com/libresoul"> <img src="https://avatars.githubusercontent.com/u/69932259?v=4" width="100;" alt="libresoul"/> <br /> _{<b>Damindu Dhananjitha</b>} </a> </td> <td align="center"> <a href="https://github.com/ImgBotApp"> <img src="https://avatars.githubusercontent.com/u/31427850?v=4" width="100;" alt="ImgBotApp"/> <br /> _{<b>Imgbot</b>} </a> </td> <td align="center"> <a href="https://github.com/satyanandatripathi"> <img src="https://avatars.githubusercontent.com/u/83153745?v=4" width="100;" alt="satyanandatripathi"/> <br /> _{<b>Parthiv Katapara </b>} </a> </td> <td align="center"> <a href="https://github.com/IndrajeethY"> <img src="https://avatars.githubusercontent.com/u/79161058?v=4" width="100;" alt="IndrajeethY"/> <br /> _{<b>Indrajeeth</b>} </a> </td> </tr> <tbody> </table> <!-- readme: contributors -end -->

Star History

<picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=kalanakt/All-Url-Uploader&type=date&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=kalanakt/All-Url-Uploader&type=date&legend=top-left" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=kalanakt/All-Url-Uploader&type=date&legend=top-left" /> </picture>