UniDL

Control your downloads from anywhere. Stream from everywhere.

UniDL is a minimal, bot-controlled media server. No web UI, no complex setup—just chat with your bot to download, and stream locally via SMB or HTTP.

Features

• 🤖 Chat to Control: Send magnet links to your Telegram or Nostr bot.
• 📱 Remote First: Manage downloads from your phone, anywhere.
• 🏠 Local Streaming: Watch on your TV, laptop, or phone via SMB/HTTP.
• 🔒 Secure: Encrypted messaging and multi-user authorization.
• 🚀 Lightweight: Runs on Raspberry Pi, old laptops, or cloud servers.

Quick Start

Docker Run

docker run -d \
  --name UniDL \
  --restart unless-stopped \
  -p 6798:6798 \
  -p 6799:6799 \
  -p 445:4445 \
  -p 6888:6888/tcp \
  -p 6888:6888/udp \
  -e TELEGRAMBOT="yourbottoken" \
  -v UniDL:/tmp/UniDL \
  ghcr.io/besoeasy/UniDL

Docker Compose

version: "3.8"
services:
  UniDL:
    image: ghcr.io/besoeasy/UniDL
    container_name: UniDL
    restart: unless-stopped
    ports:
      - "6798:6798"
      - "6799:6799"
      - "445:4445"
      - "6888:6888/tcp"
      - "6888:6888/udp"
    environment:
      - TELEGRAMBOT=yourbottoken
    volumes:
      - UniDL:/tmp/UniDL
volumes:   UniDL:

Environment Variables

| Variable | Description | Required | | :------------ | :----------------------------------------- | :------- | | TELEGRAMBOT | Telegram Bot Token (from @BotFather) | No | | NSEC | Nostr Private Key (nsec) | No | | AUTHCODE | Custom auth code (auto-generated if empty) | No |

Usage

1. Control Via Chat

Start a chat with your bot and send a magnet link or torrent URL.

• Telegram: Message your bot.
• Nostr: DM the bot's public key.

• /help - Show all commands
• /dl <link> - Start download
• /status - Check download progress
• /clean - Remove old files

2. Stream (Watch)

Access your downloaded media on your local network.

• SMB (Samba): smb://YOURSERVERIP:445/UniDL

• HTTP: http://YOURSERVERIP:6799

Dashboard

Visit http://YOURSERVERIP:6798 to view system status, usage, and bot credentials.