MR-PR0G GitHub avatar

Telegram-channel-cloner

MR-PR0G

An ultra-resilient, production-grade asynchronous CLI application that uses Python 3.12+ and Telethon to clone message histories from any accessible Telegram channel, group, or Saved Messages to a destination channel/group.

Stars

14

7-day growth

No data

Forks

2

Open issues

0

License

MIT

Last updated

2026-07-11

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It is engineered to handle massive channels (10,000+ to 50,000+ messages) on unstable networks with zero freezing, auto-reconnection, resumable progress, and extensive customization options like proxy support, text cleaning, media filtering, and forum topic syncing.

Who it is for

  • Telegram channel administrators migrating content between channels
  • Developers or DevOps engineers automating Telegram data backup and archiving
  • Content curators rebranding or republishing Telegram channel content
  • Users needing to copy large histories to Saved Messages or personal archives

Use cases

  • Migrating a public Telegram channel's entire history to a new private channel
  • Backing up a Telegram group or channel to your personal Saved Messages
  • Cloning only specific date ranges or message ID ranges from a channel
  • Rebranding posts by replacing usernames and adding custom headers/footers

Strengths

  • 100% chronological execution preserving message order
  • Zero‑freezing network resilience with automatic reconnection on proxy drops or IP changes
  • Resumable progress via progress.json, allowing recovery from any interruption without duplication
  • Advanced filtering by media type, max file size, date range, and message ID boundaries

Considerations

  • Requires Python 3.12+ and manual setup of virtual environment and API credentials
  • Telegram rate limits (FloodWait) may slow cloning; human‑like delays reduce risk but increase total time
  • Only works for channels/groups the user has joined and has admin posting rights in the destination

README quick start

🚀 Telegram Channel Clone Theta (v0.0.5)

An ultra-resilient, production-grade asynchronous CLI application built with Python 3.12+ and Telethon to seamlessly clone message histories from any accessible Telegram channel, group, or Saved Messages to a destination channel/group.

⚡ Quick Overview

Cloning massive Telegram channels (10,000+ to 50,000+ messages) often fails due to proxy disconnects, IP changes, rate limits, and frozen sockets. Telegram Channel Clone Theta is engineered from the ground up to handle unstable networks with zero freezing, smart chunked pagination, auto-reconnection, and resumable progress tracking.

🌟 Key Features

  • 🔄 100% Chronological Execution: Copies messages strictly from oldest to newest, preserving historical sequence perfectly.
  • 🛡️ Zero-Freezing Network Resilience: Hard socket recovery mechanism that auto-reconnects on IP changes or proxy drops without freezing.
  • 🌐 HTTP Proxy Support: Built-in HTTP proxy support powered by python-socks for bypass and secure operations.
  • 💬 Saved Messages Integration: Clone directly to or from your personal "Saved Messages" using simple keywords (saved).
  • 🔍 Single-Pass Fast Search: Caches all accessible dialogs once with a live scanning progress bar for instant searching.
  • ✏️ Text Cleaning, Auto Replacement & Signatures: Auto-replace channel handles, remove custom text/patterns, and inject custom headers or footers.
  • 📂 Full Media & Album Compatibility: Handles Text, Photos, Videos, Media Groups (Albums), Voice, GIFs, Documents, Stickers, Locations, Contacts, and Round Videos.
  • 🎛️ Advanced Filtering Options: Restrict cloning by allowed media types, max file size limits (e.g., max 50MB), Date Ranges (YYYY-MM-DD), or Message ID boundaries.
  • 📌 Pinned Messages & Forum Topics: Syncs pinned messages automatically and supports Telegram Supergroup Forum Topics (Threads).
  • Human Delay Jitter: Configurable random delay between messages for natural behavior to stay safe under Telegram's rate limit policies.
  • 📊 Live Rich CLI Dashboard: Real-time terminal UI displaying copy speed, estimated time remaining (ETA), message count, and status alerts.
  • ⚙️ FloodWait & Error Isolation: Gracefully sleeps on Telegram rate limits and logs missing/failed items without crashing.
  • 💾 **Resuma

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482