myMusic

_{汽水音乐会员整曲的签名服务由 SodaM 提供（AGPL-3.0）· Powered by SodaM}

myMusic 是面向 Android 6.0 及以上设备的音乐客户端，支持手机、平板、折叠屏和电视。界面使用 Jetpack Compose 与 Material 3；触摸、鼠标、键盘和遥控器使用同一套焦点与播放操作。

音乐平台能力来自 music-lib（AGPL-3.0），本项目已将平台层移植为原生实现，不需要额外的后端服务。

项目与社区

• 项目主页：https://github.com/mytv-android/myMusic
• 界面与设计稿汇总：https://mytv-android.github.io/myMusic/
• Telegram 群组：https://t.me/mytv_android_channel
• Linux Do 社区：https://linux.do/
• 配套工具：易用TV助手 收录了 myMusic 及其他开源 TV 应用，可一键安装，并提供扫码遥控、文件传输、应用安装与更新等模块，方便在电视上集中管理和查看各应用的配置与使用教程，无需注册账号。

两个入口在应用的 设置 › 关于与更新 里同样提供：手机上点按打开，电视上用手机扫页面上的二维码（二维码由本机编码器生成，不经过第三方图片服务）。

友情链接：SodaM —— Linux / macOS / Windows 上的汽水音乐桌面客户端，由 sodahub-org 独立维护，不是 myMusic 项目的一部分；myMusic 的整曲签名服务也由它提供。

界面

下面的界面来自 docs/ 下的设计稿，按同一套视觉规则单独绘制；设计稿本身是可以直接操作的原型。汇总页见 https://mytv-android.github.io/myMusic/。

榜单：来源胶囊只决定榜单内容，播放仍按聚合策略自动换源

榜单详情：播放全部、换源设置与逐曲音源状态

歌单：平台来源与推荐 / 分类切换

歌单详情：与榜单共用同一套媒体列表

聚合搜索：按同一录音合并，逐条标出完整 / 试听 / VIP，异常平台单独显示

音源选择：逐平台列出音源状态，可记住本曲的选择

我的：同步状态直接出现在歌单行上

自建歌单：播放全部、添加歌曲与编辑排序

全屏播放：封面、当前播放源与换源入口常驻

歌词：逐行高亮，当前句保持视觉中心

播放队列：切换页面不会丢失

歌词背景律动：流光场随真实音频的低 / 中 / 高频变化

播放页：手机、平板、电视使用同一套部件，三种排法

折叠屏书本姿态：左页封面与控制，右页歌词

海报墙：队列铺成封面墙，点一格就地放大，再点即从这首播放

桌面小组件：长按添加，颜色与深浅跟随 App 外观设置

正在播放：封面用播放页这首歌抽到的形状，带波浪进度条

歌词：当前一句放大、下一句变淡

平板与电视：左侧导航轨、内容网格与常驻播放窗格

界面结构

界面使用 Material 3 Expressive，配色由当前歌曲封面实时生成，浏览页与播放页带模糊背景。

主界面有四个入口：榜单、歌单、搜索、我的。设置是低频入口：手机在“我的”右上角，平板和电视在导航栏底部。

• 榜单：平台排行榜轮播、飙升榜第一名和完整榜单；电视上方的大图跟随焦点切换。
• 歌单：推荐与分类共用一个浏览上下文，停在哪种方式、听歌模式里选的分组都会记住，下次打开还在这儿；手机和平板滚到底自动加载下一页，电视保留翻页按钮。
• 搜索：提交才请求；类型只有单曲 / 歌单 / 专辑，粘贴链接会自动识别并显示“解析链接”；结果按同一录音合并，逐条标出各平台是完整、试听、VIP 还是没有音源（不只靠颜色区分）。
• 我的：喜欢、最近播放、下载和自建歌单。移出歌单、取消收藏、清除记录都可以撤销；删除下载文件和歌单仍需确认。自建歌单可同步到 GitHub Gist、Gitee 或你自己的 WebDAV。
• 本地音乐：扫描手机里的音乐，也可以只添加几个文件夹；自动配上封面和歌词——有歌名、歌手的按标签到各平台找，没有标签的听几秒识别，认错了可以手动换一个。同名 .lrc 歌词优先，标题和歌手默认只补文件里缺的。只改应用里的显示，不会改动你的文件。本地歌可以加进自建歌单和喜欢。歌单同步到另一台设备后，这首歌会依次找本机同一个文件、你放在网易云盘或 WebDAV 里的副本、匹配到的平台版本来播放，歌单里会标出放的是哪一份；哪里都放不了时写明“只在某台设备上”，可以就地找一首平台版本，也不会从歌单里删掉。本地歌可以上传到你自己的网易云盘或 WebDAV 服务器，传完后换一台设备也能直接播：只有你点了上传才会传，一首一首传、可以随时取消，默认只在 Wi-Fi 下传；把只在本机的歌加进已同步的歌单时只会提醒一句，不会自动上传。QQ 音乐云盘只能查看和播放其中已匹配的歌，不能上传。
• 天天送会员：登录汽水音乐后，这里直接显示官方的「VIP天天送」活动状态——免费 VIP 有效期、今天这一份领了没有、活动还差多少天，一键领到你的汽水账号上，在汽水音乐客户端里就能用。活动规则原文也在页里。
• 平台账号：在 设置 › 平台账号 里粘贴各平台的登录 Cookie。登录 Apple Music 会员账号后，Apple Music 的音源会从试听片段变成整曲，也能取到完整歌词；没登录时 Apple Music 仍可以浏览和试听，播放会自动换到有整曲的其他平台。YouTube Music 直连，不用登录也能搜索、播放和看公开歌单，登录后会多出你的私人歌单；另一个源 music.op.wiki 匿名就能搜它聚合的多个平台并按需逐首准备音频，适合原生平台没登录时兜底；用 music.op.wiki 账号登录后，还能看到并修改你在它上面的歌单（新建歌单仍在网站完成）。
• 设置：外观（布局、启动页、文字大小、主题、配色与对比度）、播放页（封面形状、歌词背景与律动强度、歌词动画与歌词文字、点按迷你播放器打开播放页还是海报墙，折叠屏展开时还有桌面姿态上半屏放什么，电视上还有环境模式时钟）、播放与换源、均衡器、音乐源、搜索与浏览、平台账号、音乐库同步、本地音乐、存储、关于与更新。平板和电视是“列表 + 详情”双栏。

播放

• 手机底部是悬浮迷你播放器：点按打开播放页（可在设置里改成海报墙），左右滑切歌，上滑展开，长按打开队列；读屏用户有对应的按钮和自定义操作。
• 播放页是沉浸式的：封面铺满并延伸到状态栏下，背景是缓慢流动的封面光，固定深色；控件 4 秒无操作后隐藏；在封面上左右滑切歌、双击收藏；歌名下常驻两行歌词，点开是全屏歌词，点某一行跳到该处播放。
• 全屏歌词可以换成歌词动画：除了原来的整页歌词（经典），还有 Rush、虹光、52Hz、动感波光、黑胶唱片、MiSide 掉落、巨幕、星潮·银河、跳一跳几种，动画跟着逐字进度和音乐节拍走。手机在全屏歌词页右上角的 ✦ 里选，平板和折叠屏在工具栏里，电视在控制栏里，设置 › 播放页 里也能改；每种动画有自己的几项可调设置，选卡片上就是它的样子。可以让每首歌随机换一个，或者按歌曲快慢换（慢歌、快歌各用哪种可以自己定），某首歌也可以固定用某个动画；左下角可以叠一层频谱。减少动画时显示静止画面，窗口太矮或歌词没有时间轴时回到经典。
• 歌词文字可以把“原文 / 译文”写在一行的歌词拆成两行、简体转繁体、给韩文和日文假名歌词补上罗马音（后两项需要 Android 10 及以上），对播放页、系统媒体播放条、桌面小组件和海报墙都生效；歌词下面那一行可以选显示翻译、罗马音或都显示。这些都默认关闭。
• 切歌过渡：在 设置 › 播放与换源 打开后，自动接下一首时把上一首的结尾和下一首的开头叠起来。方式可选交叉淡化（固定 4 / 6 / 8 / 10 秒）、智能过渡（先分析两首的节拍、速度、首尾，再挑切拍、低频交接、尾奏承接或等功率淡化）或不过渡（整首播完直接切）；播放页还能画一圈过渡进度。下一首会提前准备好；来不及或者遇到直播、带版权的整曲就直接切，设置页留一行「上一次接歌」说明用了什么。手动切歌不受影响。
• 定时关闭：15 / 30 / 45 / 60 分钟或播完当前歌曲；结束前 30 秒淡出。计时在播放服务里，后台和锁屏都有效。
• 平板 840–1199dp 使用底部播放条，≥1200dp 右侧常驻 380dp 播放窗格；电视使用全屏播放页，空闲后进入只显示封面和歌词的环境模式。环境模式（全屏歌词）下遥控器方向键直接控制播放：上下键切歌、左右键快退快进（各 10 秒，连按可累积），按确认键才唤出控制栏。
• 折叠屏和双屏（按系统报来的折痕 / 铰链位置）：
  • 半折成书本姿态时，播放页左页放封面和控制、右页放歌词；“我的”、设置、同步、详情和搜索的双栏以折痕为界，底部播放条也分到两页。
  • 半折立在桌上（桌面姿态）时，播放页上半屏放歌词（设置 › 播放页 里可换成封面或时钟），下半屏是常驻的进度和播放控制。只有播放页本来就开着才切过去，在别的页面半折不打断浏览。
  • 海报墙的大卡落在右页或上半屏；桌面姿态下标题胶囊挪到下半屏顶上，上半屏整块留给大卡。侧边面板和居中弹窗避开折痕。
  • 横跨双屏时按铰链分块，铰链下面不放内容；双屏横跨上下两块时列表在上屏、详情在下屏。
  • 分屏后的矮窗口（高度不到 480dp）使用紧凑播放页。
  • 折叠与展开不会打断正在进行的浏览。设计稿见 docs/foldables.html。

海报墙

• 播放队列可以切成一面封面墙：从队列面板标题栏的网格按钮或播放页“更多”菜单进入，也可以在 设置 › 播放页 › 点按迷你播放器打开 里设成迷你播放器（平板的底部播放条和播放窗格、电视导航栏的“正在播放”）的默认去处。曲目按大小不一的格子铺开、向四周无限延伸，可以四向拖动；点一格先就地放大，再点“播放”从这首开始（只在队列里跳过去，不换队列）。正在播放的大卡里显示歌词，切歌时镜头跟到新歌。
• 歌单、专辑、榜单和自建歌单的详情页可以一键切成海报视图，下次打开沿用上次的选择。
• 听歌模式的推荐流不循环铺满，而是排成一条往前长的带子，续上来的歌只填进后面的位置，墙上已有的格子不动。
• 电视上方向键按空间位置移动焦点；空闲 30 秒后镜头缓慢漂移，减轻 OLED 残影，第一下按键只唤醒。
• 墙内设置（染色、关灯、序号、翻译、切歌跟随、电视漂移）在队列墙和详情页之间共用，和播放页的设置一样只存在本机，不进同步文件。
• 封面按格子的实际大小取合适清晰度，大卡不糊，小格也不用下原图。

来源与许可：海报墙的版式改编自 folia-major（AGPL-3.0）的 Lattice，四个模板由本项目重新手画，代码为 Kotlin 重写，外观换成 Material 3 Expressive。第三方声明见 THIRD_PARTY_NOTICES.md。

歌词动画移植自 Folia 的歌词模组，各自的作者和许可见 THIRD_PARTY_NOTICES.md。

歌词动画「Rush」照 Rush（GPL-3.0）的歌词页重写，许可说明见 THIRD_PARTY_NOTICES.md。

外观

配色来源可选跟随封面（默认）、系统壁纸、品牌松绿或自选颜色；浏览页和播放页的配色风格、对比度、纯黑背景、模糊（自动 / 开 / 关）和减少动画都可以调整。电视、低内存设备和 Android 12 以下默认关闭实时模糊。

拉丁字母和数字使用内置的 Roboto Flex 子集，中文由系统字体显示。手机上从迷你播放器打开播放页时，封面以共享元素飞入。

存储、无障碍与性能

• 播放缓存上限可在“设置 › 存储”里调整（128 MB–1 GB），电视默认 256 MB，其他设备默认 512 MB；调低后立即按最近使用淘汰。
• TalkBack 走查结果见 docs/accessibility-audit.md。
• 发布包带 Baseline Profile；帧时间测试方法和结果见 docs/performance.md。

桌面小组件

六款桌面小组件，在桌面长按添加；设计稿见 docs/widgets.html。

• 正在播放：1×1 到 4×3 共七档，按组件实际大小换版式；2×3 起有波浪进度条，4×3 带当前两句歌词。封面用播放页这首抽到的形状，暂停时变圆角方形；已播时间是系统自己走字的 Chronometer。
• 歌词：当前一句放大、下一句变淡，有翻译时跟在下面；只在亮屏时按行更新。背景可选实色、半透明（72%）或透明（白字加阴影）。
• 听歌模式：一键开始私人漫游或场景电台，可指定平台和模式；需要登录的模式会提示去登录。
• 随便听听：不先选模式，直接开播——先接着上次在听的那个，再试平台自己的主推荐（偏好模式、私人漫游），都不出歌才拿场景电台兜底。
• 榜单：任选一张榜，显示前几名和排名变化，后台定期刷新（要联网）。
• 歌单：我喜欢、最近播放或任意自建歌单，点哪首从哪首开始放，正在播放的一行标成主色。
• 快捷入口：识曲、搜索、我喜欢、听歌模式和定时关闭。

颜色和深浅跟随 App 的外观设置（不是系统的动态取色）：主题跟随系统时两套颜色都交给桌面切换。每个组件都有可跳过的设置页，之后可以长按组件重新设置。

后台播放与离线缓存

• 切到后台或锁屏后继续播放，并保留系统媒体通知与控制。
• 播放队列和位置存在本机：进程被系统回收后，桌面组件、系统媒体控件和蓝牙耳机的“继续播放”从上次的位置接着放（上次放完了就从这首开头）。
• 电视上默认在按 Home、切到别的应用或连按两次返回退出时暂停播放；设置 › 播放页 › 后台播放（默认关，只有电视布局显示）打开后和手机一样，离开应用也接着放，要停就进应用按暂停，或用通知栏、系统媒体控件上的停止。系统屏保、息屏不算离开应用，音乐会继续放。被屏保或别的应用打断的播放，回到 myMusic 时会接着放（自己按的暂停、睡眠定时、队列播完不会）。
• 设置 › 播放页 › 播放时阻止屏保（默认关，只有电视布局显示）：播放期间保持屏幕常亮，系统屏保就不启动。系统屏保本就是「屏幕超时」才启动的，所以只有这一种拦法；电视自己拉的第三方屏保界面拦不住，那时靠上一条兜着。屏幕会一直亮着，OLED 有烧屏风险。
• 播放过的音频会自动缓存，可在设置中清除播放缓存。
• 播放器与歌曲列表的下载按钮会把音频保存到应用目录。已完成的下载会在播放时优先作为本地音源，网络不可用时也能从本地文件播放。
• 下载记录在“我的 → 下载”中管理，可删除本地文件。

音乐库同步

• 同步自建歌单、收藏和平台账号 Cookie。Cookie 会以明文写入同步文件（私密 Gist / 代码片段，或你的 WebDAV 目录），请勿公开文件链接或共享该目录；最近播放、下载文件、播放地址和播放进度不上传。
• 同步位置可选 GitHub Gist、Gitee 代码片段或 WebDAV（坚果云、Nextcloud、群晖等）；也可以导入 / 导出本机 JSON。
• TV 连接页可生成 10 分钟有效的二维码，手机在同一局域网打开网页面板，填写令牌和可选的文件 ID / 链接，或 WebDAV 地址、用户名和密码。网页沿用 TV 当前 Material 配色，只在配置页前台运行；离开页面、进入后台或会话过期即关闭，已保存令牌不会传给网页。
• 本机修改先写入本机数据库，界面立即反馈；修改后约 1 秒防抖立即推送，离线时自动重试。推送后会再读一次云端并重新合并，避免两台设备停在旧版本。
• 三个版本（上次基线、本机、云端）逐歌单合并。两边都修改同一歌单时不会静默覆盖，可选择“合并两版 / 保留本机 / 使用云端”；删除使用墓碑，不会把已删除歌单重新创建。
• 收藏和平台 Cookie 按修改时间合并，取消收藏 / 退出登录同样使用墓碑，不会被另一台设备的旧数据恢复。
• 绑定的平台歌单也会同步绑定状态：在一台设备上编辑或解除绑定后，其他设备也改为手动维护，不会再按平台内容把这些修改冲掉。
• 加进歌单和收藏的本地歌也会同步：其他设备上能从云端副本或匹配到的平台版本播放；都没有时显示这首歌在哪台设备上。在任意一台设备上给它换的匹配，会同步回其他设备。删除云端副本只影响那一份，不会删本机文件，也不会把歌从歌单里移除。
• 同步文件超过 1 MB 时同步页会提示一句，同步照常进行，内容不会被截掉。
• 令牌和 WebDAV 密码加密后只保存在本机，不进入数据库、日志或同步文件。

均衡器与应用更新

• 均衡器绑定当前播放会话，按设备实际频段绘制五段或更多滑杆，提供平直、流行、摇滚、爵士、人声和自定义预设；设置保存在本机，切换歌曲、换源或重建 audio session 后重新应用。设备不支持时明确显示“未生效”，不影响播放。
• 关于页检查 GitHub Release 的 update.json，只比较 versionCode；下载后校验 SHA-256、包名、版本号和签名，再通过 FileProvider 打开系统安装器。Android 不允许静默安装。
• CI 在发布 APK 的同时生成 update.json 与 SHA-256 文件。

构建

提交或拉取请求会运行 Android 单元测试。推送到 main 或 dev 时，GitHub Actions 会构建 Android 6.0+ 的通用 APK，并随 Release 发布 update.json 和 update.apk.sha256。

配置以下仓库或组织 Secrets 后，Release 会使用正式签名；未配置时使用 debug 签名：

• SIGNING_PROPERTIES：Base64 编码的 properties，包含 storeFile=keystore.jks、storePassword、keyAlias、keyPassword。
• SIGN_KEY：Base64 编码的 JKS 密钥库。

许可证

应用代码与纳入的 music-lib 均使用 GNU Affero General Public License v3.0。完整文本见 LICENSE。

这是一个学习项目。请遵守所在地法律和各音乐平台的服务条款，不要将程序或下载内容用于商业用途。