Hydrogen-Music

<p align="center">
  <img src="img/icon.png" width="96" alt="Hydrogen Music" />
</p>

<h1 align="center">Hydrogen Music 复活版</h1>

<p align="center">
  <strong>基于 Electron 与 Vue 3 的明日方舟风格网易云播放器</strong>
  <br />
  这个版本延续原项目的视觉方向，继续补齐登录、播放、下载、歌词、评论、云盘、私人漫游、本地音乐和桌面端集成。
</p>

<p align="center">
  <a href="https://github.com/ldx123000/Hydrogen-Music/releases"><img alt="GitHub Release" src="https://img.shields.io/github/v/release/ldx123000/Hydrogen-Music?style=for-the-badge&label=Release" /></a>
  <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/ldx123000/Hydrogen-Music?style=for-the-badge" /></a>
  <img alt="Electron" src="https://img.shields.io/badge/Electron-38-47848F?style=for-the-badge&logo=electron&logoColor=white" />
  <img alt="Vue" src="https://img.shields.io/badge/Vue-3-42B883?style=for-the-badge&logo=vuedotjs&logoColor=white" />
</p>

<p align="center">
  <a href="#项目定位">项目定位</a>
  ·
  <a href="#功能总览">功能总览</a>
  ·
  <a href="#截图预览">截图预览</a>
  ·
  <a href="#安装使用">安装使用</a>
  ·
  <a href="#开发与构建">开发与构建</a>
  ·
  <a href="#声明与致谢">声明与致谢</a>
</p>

<p align="center">
  <img src="img/home.png" alt="Hydrogen Music Home" />
</p>

## 项目定位

Hydrogen Music 是一个第三方桌面音乐播放器。当前仓库在原 Hydrogen Music 的基础上继续维护，主要目标是让应用重新具备可用、稳定、完整的桌面端体验。

目前主要维护这些部分：

- 恢复并增强账号登录、曲库访问、播放解析、下载、云盘等基础功能。
- 加上私人漫游、评论区、桌面歌词、音乐视频、本地音乐、塞壬唱片等功能。
- 完善桌面端集成，包括托盘、全局快捷键、Dock 菜单、Linux MPRIS、媒体信息、自动更新与多平台安装包。
- 保持简洁克制的界面风格，同时加入深色模式、自定义字体、音频可视化、背景封面模糊等可选设置。

## 功能总览

### 账号与服务

- 支持网易云音乐二维码、手机号登录。
- 内置增强版网易云 API 服务，应用启动后自动拉起本地服务。
- 支持账号状态隔离、登录信息清理、VIP 信息展示与会话迁移。
- 可同步最近播放记录，让官方客户端里也能看到这边的播放历史。

### 播放

- 音质偏好覆盖标准、较高、极高、无损、Hi-Res、高清环绕声、沉浸环绕声、杜比全景声、超清母带等档位。
- 可播放歌单、专辑、歌手热门歌曲、每日推荐、搜索结果、私人漫游、本地音乐、电台节目与塞壬唱片音源。
- 提供顺序、循环、单曲循环、随机播放，播放队列会持久化，也支持断点恢复。
- 可开启歌曲无缝衔接，通过预缓冲下一首音频降低切歌空隙。
- 提供音频可视化、背景封面模糊、歌词模糊等可选效果。

### 曲库与搜索

- 提供歌单、专辑、歌手、MV、每日推荐等常用曲库入口。
- 可搜索歌曲、专辑、歌手、歌单和 MV。
- 歌单、专辑、歌手、本地音乐等列表支持搜索过滤。
- 支持收藏歌单管理、喜欢歌曲、添加到歌单、下一首播放、显示专辑等常用操作。

### 私人漫游

- 内置私人漫游页面，支持默认推荐、熟悉偏好、探索发现、场景推荐与 AI DJ 模式。
- 场景推荐支持运动、专注、夜晚情绪等子模式。
- 内置近期去重队列，减少短时间内反复推荐同一首歌。
- 支持上一首、下一首、喜欢、不喜欢、封面轮播与候选歌曲预取。

### 歌词与评论

- 播放器右侧可以在歌词和评论区之间切换。
- 歌词支持原文、翻译、罗马音、间奏提示、字体大小与显示偏好设置。
- 桌面歌词支持独立窗口、置顶显示、拖动、锁定、缩放、当前句与下一句展示。
- 评论区支持精彩评论、最新评论、楼层回复、点赞、回复、发送与复制评论。

### 下载、本地音乐与云盘

- 支持歌曲下载、下载队列、暂停/恢复/取消与窗口进度展示。
- 下载时可写入基础标签、封面、歌词标签，并可选择额外生成独立 LRC 文件。
- 可选择下载目录，也可为每首下载歌曲创建独立文件夹。
- 支持扫描多个本地音乐目录，并按文件夹、歌手、专辑维度浏览。
- 支持云盘列表、容量信息、上传、删除、播放与常见音频/视频文件识别。

### 视频、电台与扩展音源

- 支持网易云 MV 播放。
- 音乐视频功能可绑定 B 站账号和下载 BV 号视频内容，支持选择分 P 与清晰度，也可以设置音频和视频的时间段同步、缓存视频文件。
- 支持收藏电台与电台节目播放，播放器会展示电台节目简介。
- 支持 Monster Siren 塞壬唱片官方音源专区。

### 桌面端

- 支持浅色、深色、跟随系统主题。
- 支持自定义字体与系统字体选择。
- 支持全局快捷键、系统托盘、退出行为设置。
- macOS 支持原生窗口交通灯、Dock 菜单与歌曲信息展示。
- Linux 支持 MPRIS 媒体控制。
- Windows / macOS / Linux 均提供打包配置。

## 截图预览

<table>
  <tr>
    <td><img src="img/home.png" alt="首页" /></td>
    <td><img src="img/lyric.png" alt="歌词" /></td>
  </tr>
  <tr>
    <td><img src="img/comment.png" alt="评论区" /></td>
    <td><img src="img/privateFM.png" alt="私人漫游" /></td>
  </tr>
  <tr>
    <td><i