🚀 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