NCMD — 纯粹的某音乐客户端

English Version Available Here

NCMD 是一款现代音乐客户端。不追求功能的堆砌，只为带给你最纯粹、最沉浸的听歌体验。Android 客户端基于 Material 3 设计语言；项目正迁移至 Kotlin Multiplatform，以支持 Windows 与 Linux 桌面端。

---

✨ 核心亮点

🎨 灵动的视觉语言

• 全 Material 3 实现：遵循最新的设计规范，带来丝滑的过渡动画与通透的界面布局。
• 封面动态取色：界面背景与色彩随专辑封面的变化而流动，让音乐不仅好听，更好看。
• 深色模式支持：完美适配系统深色/浅色切换，夜晚听歌更护眼。

🎭 极速沉浸的横屏播放器

这是 NCMD 的灵魂所在。当你旋转手机，一个全新的视界将为你展开：

• 手势驱动：上滑显示控制栏，下滑收起，点击切换歌曲信息显示模式。
• 极致视野：去掉了所有冗余的边框与按钮，歌词与封面交相辉映。
• 边缘延伸：视觉效果直接延伸至屏幕边缘，充分利用每一寸显示空间。

🚀 强劲的内核

• 智能播放管理：基于 Media3 构建，支持全局通知控制、锁屏播放与耳机控制。
• 轻量且快速：单 Activity 架构配合 Navigation Compose，响应极速。
• 离线持久化：记住你的播放列表、UI 偏好与登录状态。

🌐 Kotlin Multiplatform 迁移进度

• 已共享：歌词解析、播放队列与播放请求策略、睡眠计时策略、领域模型与播放控制契约。
• 桌面端可用：Windows 与 Linux 版支持本地音乐库、元数据/封面读取、播放、封面取色与 HiDPI。
• 原生 Wayland：Linux 在 JetBrains Runtime 下使用 WLToolkit，而非 XWayland 回退。
• 持续校验：CI 会构建 Android、Linux、Windows 和 Arch Linux 薄包，并执行 Linux 启动烟雾测试。

桌面端正在持续完善在线曲库与登录；当前可稳定使用本地音乐播放功能。

---

🛠️ 技术细节

NCMD 采用了 Android 开发领域的前沿技术栈：

• UI: Jetpack Compose, Material 3, Navigation Compose
• 媒体: Media3 (ExoPlayer, Session)
• 网络: OkHttp, Kotlin Serialization
• 存储: Room Database, SharedPreferences
• 架构: MVVM (Android) + Kotlin Multiplatform shared core

---

🚀 快速开始

环境要求

• Android 12 (API 31) 或更高版本
• JDK 17+

构建与安装

git clone https://github.com/goldppx/NCMD.git
cd NCMD
./gradlew assembleDebug

Desktop（Windows / Linux）

./gradlew :desktop:run

发布的桌面包均不内置 Java；Windows 提供可安装的 MSI。请用系统包管理器安装 Java 21 或更新版本；Windows 启动器 在未找到运行时时会弹窗打开 JetBrains Runtime 下载页。Linux 的原生 Wayland 支持必须使用 JetBrains Runtime 21；普通 OpenJDK 会走 XWayland。Arch 用户请参阅 packaging/arch/README.md。

---

📸 预览（预留）

更多精美截图请查看 Screenshots

---

🤝 贡献与支持

欢迎通过 Issue 或 Pull Request 来完善这个项目。如果你喜欢这个作品，请给它一个 ⭐️！

---

📄 开源协议

本项目采用 MIT 协议开源。

---

“让音乐回归本质。”