lymagics/clips-courier repository overview

⁠Clips Courier

A private Telegram bot that delivers short videos and photos into the chat. Send it a link to a TikTok, Instagram, or X post — it downloads the clip with yt-dlp⁠, or the pictures with gallery-dl⁠, and sends them back as a regular Telegram video, photo, or album.

The bot is private by default: only the owner and the people the owner adds ("friends") can download videos.

⁠How It Works

1. You send /d <link> to the bot.
2. The bot checks that you are the owner or a friend.
3. It downloads the post to a temporary folder and sends it to the chat: a video as a video, a picture as a photo, and several pictures as one album.
4. The temporary folder is deleted right after, even when the download fails.

⁠Commands

⁠Setup

You need two things:

• A bot token — create a bot with @BotFather⁠ in Telegram.
• Your Telegram user ID — ask @userinfobot⁠ or a similar bot.

⁠Configuration

All settings come from environment variables (see .env.example):

⁠Run with Docker

The image is published on Docker Hub automatically on every tagged release, so there is nothing to build:

docker run -d \
  -e BOT_KEY=123456:your-token \
  -e OWNER_ID=123456789 \
  -e DB_PATH=/data/courier.db \
  -v courier-data:/data \
  lymagics/clips-courier

The volume keeps the friend list when the container is recreated.

⁠License

MIT⁠