FoxCoderGit/AstraGram

项目介绍

AstraGram 是基于 Telegram for Android 源码的独立 Android 即时通讯客户端，保留 Telegram 的交互方式，并在媒体处理、界面自定义、插件和更新流程上增加可选功能。它面向希望使用带附加能力的 Telegram 的 Android 用户，也面向想从源码构建客户端的开发者。应用包名 org.ghostgram.messenger 被刻意保留，使更新可以覆盖此前安装的版本而不清除本地应用数据。

主要功能

• 媒体工具：可选的 yt-dlp 集成与 FFmpeg 转换，可把支持的公开视频链接加入下载队列并在完成后发送；后台下载和上传任务在切换聊天后继续执行。
• 界面与提醒：附件菜单支持拖拽排序；可选绘画模式用于生成静音语音消息动画；他人对你的消息作出表情回应时，通过 Android 通知提醒。
• 可选外部服务：Yandex Music 的搜索、收藏和音频发送使用每个用户自己的账号或令牌，项目不提供共享音乐账号。
• 更新与分发工具：应用内签名更新检查，比较 versionCode，显示发布说明，支持重试与续传，并在安装前校验 APK 的 SHA-256 和签名。
• 徽章：服务端验证的 AstraGram 创作者与支持者徽章，以及可选展示的 exteraGram 支持者徽章。

快速使用

使用客户端时，从官方 GitHub Releases 页面下载 APK 并安装到 Android 设备，安装前用页面公布的 SHA-256 校验值核对下载文件。

从源码构建需要 Android Studio JDK、Android SDK 36 与 Build Tools 36.0.0、Android NDK 27.2.12479018、CMake 3.22.1 以及 Python 3.11 或更新版本。先复制 astra.local.properties.example 为 astra.local.properties，填入自己的客户端参数：

astraApiId=YOUR_TELEGRAM_API_ID
astraApiHash=YOUR_TELEGRAM_API_HASH
astraMapsApiKey=YOUR_GOOGLE_MAPS_API_KEY

然后在仓库根目录执行调试构建：

.\gradlew.bat :TMessagesProj_Ghost:assembleDebug -PghostOnly=true -Pandroid.injected.testOnly=false --max-workers=2 --console=plain

APK 输出到 TMessagesProj_Ghost/build/outputs/apk/debug/。如果需要签名的本地分发版本，项目提供 Tools/build-private-apk.ps1，它会在安装或复制到已连接设备前校验生成的 APK。

使用约束

• 客户端 API 参数、签名密钥、管理员凭据、服务端私钥和用户令牌不在公开仓库中；本地构建时必须自己在被 Git 忽略的 astra.local.properties 中提供 API 参数。
• 上面的构建命令使用 Windows PowerShell；其他平台需要等价的 Gradle 调用方式。
• yt-dlp、FFmpeg 和 Yandex Music 等可选集成会向外部服务发送请求，需遵守对应服务的条款和账号要求。
• 项目基于 Telegram for Android，采用 GPL-2.0 许可证，上游及第三方组件的声明保留在仓库中。

HotRepo 点评

HotRepo 在 2026-11-10 记录到该项目 115 个 Star、0 个 Fork，并在 Java 新项目榜上记录了一小时内新增 10 个 Star。观察窗口很短，只能说明当天进入过新项目榜，不足以判断趋势。从仓库内容看，这是一套完整的 Android 客户端分支，包含真实的构建路径、私有配置处理和签名更新校验，而不是薄封装或广告页。