TGPlayer v0.3.4

TGPlayer v0.3.4

本版本将 Telegram/tdesktop 风格动效应用到 TGPlayer，并重构托盘菜单体验。

主要更新

• 新增统一动效系统：页面滑动转场、Ripple、错峰、数字滚动、文字交叉淡化和抛物线动画。
• 托盘菜单跟随应用主题、配色、字体、圆角和动效设置。
• 修复托盘透明窗口周围的半透明边缘。
• 支持应用内减弱动效和系统 prefers-reduced-motion。
• 托盘弹窗关闭后销毁渲染进程，减少长期内存占用。
• 修复打包运行副本缺少 GramJS 导致登录数据无法使用的问题。

构建信息

• Windows x64 NSIS 安装包已在本地构建并验证。
• 安装包文件：TGPlayer-Setup-0.3.4.exe
• 安装包大小：约 76 MB
• 安装程序 SHA-256：6c89b25fc5ef253689b1e9c3fe5e47ae423c168157fc8d8a1767ae64bdcae911

GitHub 网页附件上传受当前账号权限和单文件 25 MB 限制，安装包暂未作为 Release 附件上传。源码、版本 tag 和构建产物均已准备完成。

Made with Proma · GitHub

TGPlayer v0.3.3

新增 / Added

• 完整扫描聊天的音频历史：此前每个聊天只索引最新的 200 首；现在会走服务端音频过滤器、每页 100 条翻页遍历该聊天的全部音频。耗时的扫描会在同步按钮上显示进度，再次点击同一个按钮即可停止；被停止、被限流或中断的扫描不会丢掉已索引的内容。「同步所选」执行完整重扫，用它可以把旧版本只索引过最新 200 首的聊天补齐。
• 启动/重连改为增量同步：只抓取比本地索引更新的音频，启动更快、请求更少。
• 记住播放模式：随机播放、循环模式、音量、静音随设置一起写入磁盘，重启后（首帧就是正确的）保持原样。
• 记住上次播放的曲目：重启后回到上次那首，连同播放位置和播放/暂停状态。恢复会在曲库载入、连接建立、同步完成时重试，而不是只尝试一次——即使启动时还在登录、或那首曲子稍后才被索引出来，也会落在你的歌上，而不是曲库第一首。若一次完整扫描确认该曲目已不在音乐库中，只提示一次并忘掉它。
• 没有加载任何曲目时按播放键，会优先打开上次那首（其次才是当前项、最后才是列表第一首）。

修复 / Fixed

• 播放进度恢复：流在 1.5 秒内没有回报元数据时，不再让界面显示 7:18 而实际从 0 开始；跳转位置会按元素真实时长夹取。
• 选中的曲目即使自动播放被浏览器拦截、或恢复为暂停状态，也会立即写入续播记录（此前只由 play/pause 事件触发，可能丢失）。

下载 / Download

• TGPlayer-Setup-0.3.3.exe：Windows x64 安装版（NSIS，支持自定义安装目录，升级保留登录与音乐库）。
• SHA256：656035405C8098795200304462B3ACF3CB1EF032552AF17ED5B7A9F7764EA709

Highlights (English)

• Chat scans now page through a chat's entire audio history (100 messages per request) instead of only its newest 200; the sync button reports progress and doubles as a stop control, and a stopped, flood-waited or interrupted scan keeps everything already indexed. "Sync selected" performs a full re-index that backfills libraries built by earlier versions.
• The sync on launch and reconnect is incremental — it asks only for audio newer than the stored index.
• Shuffle, repeat, volume and mute are persisted with the settings and applied on the first paint.
• The last track is restored with its position and play/pause state, and that restore is retried as the library is adopted and as the session connects instead of being attempted once. A finished scan that proves the track is gone says so once and forgets it.
• Pressing play with nothing loaded prefers the saved track over the first row of the library.

TGPlayer v0.3.2

修复 / Fixed

• 收藏持久化：收藏记录此前仅保存在内存中，退出应用即丢失。现在即时写入磁盘（favorites.json），重启后按曲目 ID 恢复。
• 播放队列持久化：播放队列同样不再丢失，随续播状态一同保存与恢复；重新同步曲库后仍能按 ID 对应回原曲目。
• 退出登录时会同步清空本地收藏与队列，避免更换账号后串数据。
• 播放列表本身已有磁盘持久化，本次一并核对无误。

下载 / Download

• TGPlayer-Setup-0.3.2.exe：Windows x64 安装版（NSIS，支持自定义安装路径、桌面/开始菜单快捷方式）。
• 覆盖安装前请先从托盘退出旧版本。

---

Made with Proma · GitHub

TGPlayer v0.3.1

Highlights

• Improve Telegram media streaming with bounded segment concurrency and retries for transient network errors.
• Show playback buffering feedback when the media element is waiting or stalled.
• Make the home hero card consistent with the dark theme.

Installer

• TGPlayer-Setup-0.3.1.exe
• SHA-256: A5E8E8D8C16AE428C8D9F3362C19F957F3F75344550C979FF6CF518E9A1C6982

TGPlayer v0.3.0

TGPlayer v0.3.0

Highlights

• Reworked the system-tray popup with a Material You-style layout, icon controls, and lightweight open/play animations.
• The tray popup now follows the app theme independently in both light and dark modes.
• Restores the most recently played track, position, and play/pause state after reopening.
• Delays playback restoration until the Telegram session is connected, preventing the brief false connection-error notice during startup.
• Installer defaults to D:\TGPlayer while still allowing a custom install location.

????

• ?????????? Material You ??,?? SVG ???????????????
• ???????????????????????
• ????????????????????/?????
• ? Telegram ????????????,????????????????
• ???????? D:\TGPlayer,?????????

Installer SHA-256: 5042A903939A5D783A284F5AFA36BA14E31FB431D3C6F8E89E5D48AE2AC71A5E

TGPlayer v0.2.0

TGPlayer v0.2.0 — tray playback stability update.

Highlights

• Reduced background resource usage when the window is minimized to the system tray.
• Limited retained media caches and released idle file handles to prevent long-session growth.
• Fixed a playback hang when a browser audio range request disconnects while waiting for backpressure.
• Tray minimize behavior keeps playback, pause/resume, and previous/next controls working.
• Added a rounded custom tray popup with hover feedback and grouped controls.
• Reduced hidden-window progress repaints while keeping the audio clock and network stream alive.
• Updated the application and lockfile version to 0.2.0.

中文说明

• 优化最小化到系统托盘后的后台占用。
• 限制媒体缓存数量，释放闲置文件句柄，避免长时间使用后持续增长。
• 修复切歌、拖动进度或连接中断时可能卡死、无响应的问题。
• 托盘状态下继续支持播放、暂停、上一首和下一首。
• 托盘右键菜单改为圆角深色浮层，带悬停反馈和清晰分组。
• 隐藏窗口时停止无效的进度界面刷新，但保留音频时钟和网络流。
• 应用版本升级为 0.2.0。

Installer SHA-256: 0DF86EB88BEF5722B754FE8B1EC6B5C18C113D885AD43757283ECFE8A067B0E8

TGPlayer v0.1.0

TGPlayer v0.1.0 — first public build.

A Telegram-first desktop music player: sign in with your personal Telegram
account (no API ID/hash to apply for — the app ships Telegram Desktop's public
credentials), pick which chats to scan, and stream their audio with seeking and
full-length playback.

Install (Windows x64)

Download TGPlayer-Setup-0.1.0.exe below and run it. The installer lets you
choose the install directory and creates Start-menu / desktop shortcuts.

• Size: 79,293,030 bytes (75.62 MB)
• SHA-256: 368C3F23110979903EF100D03BBF5F4D558C3944F979F4E82A0143771EAB0A0E

Session data and audio cache are stored in your per-user data directory
(%APPDATA%\tgplayer); the login session is OS-encrypted and never leaves the
machine.

---

TGPlayer v0.1.0 — 首个公开版本。

以 Telegram 为核心的桌面音乐播放器:用你的个人 Telegram 账户登录(无需申请
API ID/hash,程序内置 Telegram Desktop 的公开凭据),自己选择要扫描的聊天,
即可流式播放其中的音频,支持拖动进度和完整时长播放。

安装(Windows x64)

下载下方的 TGPlayer-Setup-0.1.0.exe 运行即可。安装器可自选安装目录,并创建
开始菜单 / 桌面快捷方式。

• 大小:79,293,030 字节(75.62 MB)
• SHA-256:368C3F23110979903EF100D03BBF5F4D558C3944F979F4E82A0143771EAB0A0E

登录会话和音频缓存保存在你的 per-user 数据目录(%APPDATA%\tgplayer);登录
会话经系统加密,绝不离开本机。