MR-PR0G GitHub avatar

Telegram-channel-cloner

MR-PR0G

一个超强韧、生产级别的异步CLI应用,基于Python 3.12+和Telethon,可将任何可访问的Telegram频道、群组或“已保存消息”无缝克隆到目标频道/群组。

Stars

14

7 天增长

暂无数据

Fork 数

2

开放 Issue

0

开源协议

MIT

最近更新

2026-07-11

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

专为处理超大量消息(10,000+至50,000+条)的不稳定网络环境而设计,具备零冻结、自动重连、可恢复进度以及丰富的自定义选项(如代理支持、文本清洗、媒体过滤、论坛话题同步)。

适合谁使用

  • 迁移频道内容的Telegram频道管理员
  • 需要自动化Telegram数据备份和归档的开发者或运维工程师
  • 对Telegram频道内容进行重新品牌化或重新发布的内容策展人
  • 需要将大量历史记录复制到“已保存消息”或个人归档的用户

典型使用场景

  • 将公共Telegram频道的全部历史迁移到新的私密频道
  • 将群组或频道备份到“已保存消息”中
  • 仅克隆指定日期范围或消息ID范围的频道历史
  • 通过替换用户名、添加自定义页眉/页脚来重新品牌化帖子

项目优势

  • 严格按时间顺序执行,保持消息顺序不变
  • 零冻结网络韧性——代理断开或IP变化时自动重连
  • 通过progress.json实现可恢复进度,中断后从断点继续,不会重复
  • 支持按媒体类型、最大文件大小、日期范围和消息ID边界进行高级过滤

使用前须知

  • 需要Python 3.12+并手动配置虚拟环境和API凭据
  • Telegram的速率限制(FloodWait)可能减慢克隆速度;采用模拟人类延迟来降低风险但会延长总体时间
  • 只能克隆用户已加入且拥有发帖权限的频道/群组

README 快速开始

🚀 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

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

lopopolo
精选
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 与机器学习AI 智能体
2,390
slvDev
精选
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 与机器学习大语言模型
1,960
littledivy
精选
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 与机器学习
1,482