Telegram 视频下载器 Windows 安装与首次使用教程

准备工作

需要 Windows 10/11 64 位电脑、可用网络和你自己的 Telegram 个人账号。账号必须已加入目标群组或订阅目标频道，且能够读取相应消息。仅下载你有权保存的内容。

推荐官网提供的 Windows EXE 安装包：内置 Python，无需另装 Python 或 Git。源码 ZIP 面向开发者，需要 Python 3.11 或更高版本，不要把源码版启动步骤套用到安装版。

下载安装包

1. 返回官网下载区，选择“下载 Windows 版”，再选择“下载安装包 EXE”。
2. 核对文件来源及官网提供的 SHA-256 校验信息。校验值一致只能验证文件一致性，不等于第三方安全认证。
3. 运行安装程序，完成安装后通过程序快捷方式启动。

v0.3.9 安装包尚未做发行者代码签名。如果 Windows 提示未知发布者，请先核对来源；不要为了安装而关闭系统安全防护。不确定时先停止安装。

配置 Telegram 账号

1. 通过 Telegram API 开发工具 获取自己的 API ID 与 API Hash。
2. 在程序“账号”页填写上述信息，点击“扫码登录”，使用已登录的 Telegram 客户端扫码。
3. 若账号启用了二步验证，在程序提示处输入密码。二维码过期会自动刷新；无法扫码时可使用手机号验证码备用登录方式。

API Hash、验证码、二步验证密码和会话文件都不要发给他人，包括求助时。网站统计不需要这些账号凭据。

试用与第一次运行

1. 在“授权”页点击“开始试用 / 刷新授权”，首次联网验证可开通 24 小时试用。试用结束后需有效授权；同机重装不会重新获得试用。
2. 进入“群组/频道”，刷新列表，勾选一个有权访问的目标并保存。新目标默认不补抓历史。
3. 在“运行”页确认保存位置和磁盘空间，然后点击“启动后台”。
4. 如需选择旧视频，按批量下载教程在“视频检索”中选取，不必为了测试开启全部历史。

个人收款码需管理员核实到账后开通，不是扫码后自动确认付款。具体授权选项以程序当前展示为准。

日常运行与更新

关闭主窗口会隐藏到托盘，不等于停止下载。停止下载请使用“停止后台”。电脑需要保持开机、联网；重启电脑后需手动启动程序和后台。

覆盖安装前先停止后台，再退出托盘。保留原配置、会话和下载数据，不要按删除数据的方式处理一般故障。源码版在线更新与 EXE 安装包更新不是同一种流程。

开始使用

查看当前版本与下载入口

本工具是独立第三方软件，非 Telegram 官方产品。请遵守内容权利及群组、频道规则。