Skip to content

Latest commit

 

History

History
138 lines (96 loc) · 3.12 KB

README.md

File metadata and controls

138 lines (96 loc) · 3.12 KB

tgup

A simple CLI script to upload media from URLs to a Telegram channel.

Prerequisites

Ensure the following dependencies are installed:

  1. ffmpeg – Generates thumbnails, retrieves duration, and remuxes/merges m3u8 streams for yt-dlp.
  2. aria2 – The primary downloader used for all downloads.
  3. yt-dlp – Supports m3u8 downloads and additional sites, using aria2 as an external downloader.
  4. Go Compiler – Required to build and run the script.

Installation

1. Install ffmpeg, aria2, and yt-dlp

  • Ubuntu/Debian:

    sudo apt update  
sudo apt install ffmpeg aria2  
sudo pip install yt-dlp

  • macOS (Homebrew):

    brew install ffmpeg aria2 yt-dlp

  • Windows:
    Download and install them from their official websites:

2. Build the Telegram Bot API

Follow this guide to build the Telegram API server.
After building, save the generated telegram-bot-api binary for later use.

3. Install the Go Compiler

  • Ubuntu/Debian: 
    sudo apt install golang
  • macOS (Homebrew): 
    brew install go
  • Windows:
    Download from the official Go website.

Setup & Usage

1. Clone the Repository

git clone https://github.com/Sadwhy/tgup.git  
cd tgup

2. Install Dependencies

go mod tidy

3. Build the Script

go build -o tgup ./src/main.go

This generates a tgup binary.

4. Prepare the Environment

  • Place the telegram-bot-api binary in the same directory as tgup.

  • Create a .env file with the following:

    BOT_TOKEN=12345678:qwertyuiopasdfghjkl  
API_HASH=zxcvbnmasdfghjkl  
API_ID=1234567890

  • Get your API credentials:

⚠️ Keep these credentials private to prevent account compromise.

Using the Script

Single File Upload

./tgup
  • Enter your Channel ID (and Topic ID for supergroups, if applicable).
  • Provide the media URL when prompted.

Multi-File Upload

  1. Create a list.json file with media links:

    [  
  "https://example.com/file1.mp4",  
  "https://example.com/file2.jpg",  
  "https://example.com/file3.png"  
]

  2. Run the script:

    ./tgup
  • Enter your Channel/Group ID (and Topic ID if using supergroups).
  • The script will process each file in list.json.

Troubleshooting

  • Missing Dependencies? Verify ffmpeg, aria2, yt-dlp, and Go are installed.
  • Invalid API Credentials? Double-check .env values (BOT_TOKEN, API_HASH, API_ID).
  • Execution Issues? Ensure tgup and telegram-bot-api binaries have execute permissions.