# netease-cloud-music-gtk

**Repository Path**: unsafe-rust/netease-cloud-music-gtk

## Basic Information

- **Project Name**: netease-cloud-music-gtk
- **Description**: Linux 平台下基于 Rust + GTK 开发的网易云音乐播放器 
- **Primary Language**: Rust
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 62
- **Created**: 2022-06-18
- **Last Updated**: 2022-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# netease-cloud-music-gtk
[![Actions Status](https://github.com/gmg137/netease-cloud-music-gtk/workflows/CI/badge.svg)](https://github.com/gmg137/netease-cloud-music-gtk/actions)
> netease-cloud-music-gtk 是基于 Rust + GTK 开发的网易云音乐播放器，专为 Linux 系统打造，已在 openSUSE Tumbleweed + GNOME 环境下测试。

## 特点
- 稳定：专为 Linux 系统打造，相比官方版本拥有更好的兼容与稳定性。
- 极速：相比 Node/python 版，Rust + GTK 带给你如丝般的顺滑体验。
- 可靠：除了断网或网易 API 限制，不会出现运行时问题。
- 简洁：仿 GNOME Music 风格，GTK 原生界面，纯粹得令人发指。
- 轻量：安装文件不到 2 M，只需最简单的运行时依赖。

## 功能
- 网易邮箱/手机账号登录
- 私人歌单管理
- 个性推荐
- 私人 FM
- 音乐云盘
- 热门排行榜
- 歌曲搜索
- 简易歌词
- 桌面歌词(依赖于 [Desktop Lyric](https://extensions.gnome.org/extension/4006/desktop-lyric/)或[OSDLyrics](https://github.com/osdlyrics/osdlyrics))
- 热门歌单
- 新碟上架
- Mpris 支持

## 运行依赖
> openssl, gstreamer, gstreamer-plugins-base, gstreamer-plugins-good, gstreamer-plugins-bad, gstreamer-plugins-ugly

## 安装
### openSUSE Tumbleweed
```bash
sudo zypper in netease-cloud-music-gtk
```
### openSUSE Leap
```bash
// 添加源
sudo zypper ar -f obs://multimedia:apps multimedia
// 安装
sudo zypper in netease-cloud-music-gtk
```
### Arch Linux
[使用方法](https://www.archlinuxcn.org/archlinux-cn-repo-and-mirror/)：在 /etc/pacman.conf 文件末尾添加以下两行（[或者选择其它镜像](https://github.com/archlinuxcn/mirrorlist-repo)）：
```
[archlinuxcn]
Server = https://repo.archlinuxcn.org/$arch
```
添加后执行下面语句安装 archlinuxcn-keyring
```bash
sudo pacman -Syyu archlinuxcn-keyring
```
然后安装 netease-cloud-music-gtk
```bash
sudo pacman -Syu netease-cloud-music-gtk
```

### Debian
```bash
echo "deb https://dl.bintray.com/debianopt/debianopt buster main" | sudo tee -a /etc/apt/sources.list

curl -o bintray-public.key.asc https://bintray.com/user/downloadSubjectPublicKey?username=bintray

sudo apt-key add bintray-public.key.asc

sudo apt install netease-cloud-music-gtk
```
### Fedora / Ubuntu
- 下载 [RPM/DEB](https://gitee.com/gmg137/netease-cloud-music-gtk/releases)包安装。

### 其它发行版
- 下载 [Appimage](https://gitee.com/gmg137/netease-cloud-music-gtk/releases) 运行。

## 从源码安装
### openSUSE 安装依赖
```bash
sudo zypper in git gcc dbus-1-devel gtk3-devel libopenssl-1_1-devel gstreamer-devel \
      gstreamer-plugins-bad gstreamer-plugins-bad-devel \
      gstreamer-plugins-base gstreamer-plugins-base-devel \
      gstreamer-plugins-good gstreamer-plugins-ugly cairo-devel
```
### ubuntu 安装依赖
```bash
sudo apt install git gcc libdbus-1-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \
      gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
      gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly \
      gstreamer1.0-libav libgtk-3-dev libatk1.0-dev libcogl-pango-dev \
      libssl-dev libcairo2-dev libgstreamer-plugins-bad1.0-dev
```
### fedora 安装依赖
```bash
# 需要启用 rpmfusion-free
sudo dnf install git gcc dbus-devel gtk3-devel openssl-devel gstreamer1-devel \
      gstreamer1-plugins-bad-free gstreamer1-plugins-bad-free-devel \
      gstreamer1-plugins-base gstreamer1-plugins-base-devel gstreamer1-libav \
      gstreamer1-plugins-good gstreamer1-plugins-ugly cairo-devel
```
### mac（osx） 安装依赖
```bash
brew install gtk+3
brew install gstreamer gst-plugins-base gst-plugins-good \
      gst-plugins-bad gst-plugins-ugly gst-libav
      
brew install dbus

# 安装之后要启动
brew services restart dbus
```

### 编译/打包
```bash
git clone https://github.com/gmg137/netease-cloud-music-gtk.git
cd netease-cloud-music-gtk

// 编译
cargo build --release
// 编译指定 gtk 版本(Leap 15.1 / Ubuntu 18.04)
cargo build --release --no-default-features --features gtk_3_18

// 打包 rpm
cargo install cargo-rpm
cargo rpm build

// 打包 deb
cargo install cargo-deb
cargo deb
```
### FAQ
1. 为什么后台运行时没有托盘图标?
> 由于 GTK3 取消了托盘接口，所以目前不打算实现托盘功能。<br>
> **替代方案:**
> - Mpris 插件: GNOME 推荐 [Mpris Indicator Button](https://extensions.gnome.org/extension/1379/mpris-indicator-button/)，其它桌面可查找相应 Mpris 插件。
> - 直接点击启动图标，亦可唤醒程序。
2. 为什么程序无法在我的系统运行?
> 请从命令行启动程序，查看错误输出。如果报 glib 错误，可以重新安装旧版系统(ubuntu18.04, leap15)的安装包来解决。
3. 为什么播放歌单时播放的是随机音乐?
> 双击只会播放歌单中的一首音乐，如果要播放整个歌单请点击歌单右上角的播放按钮。
4. 为什么点击播放后没有反应?
> 请通过命令行添加 ```--debug``` 参数来启动程序，查看获取到的歌曲链接是否正确。
5. 音乐缓存目录在什么位置?
> 请通过命令行添加 ```--debug``` 参数来启动程序, 查看输出信息。
6. 配合 [OSDLyrics](https://github.com/osdlyrics/osdlyrics) 播放时歌词显示不正确。
> 由于 [OSDLyrics](https://github.com/osdlyrics/osdlyrics) 是通过歌词文件名称做匹配，因此当播放同名歌曲时可能会匹配到错误的歌词文件。
> 对此可以通过删除已有歌词文件临时解决。

## 截图
![home](https://user-images.githubusercontent.com/6460323/74423902-fa996900-4e8b-11ea-915f-a4ec40bd2982.jpg)
![found](https://user-images.githubusercontent.com/6460323/74421939-c8d2d300-4e88-11ea-9b93-962ae80f5a11.png)
![mine](https://user-images.githubusercontent.com/6460323/74424004-29afda80-4e8c-11ea-9c16-af3f25525c9c.jpeg)

## License
This project's source code and documentation is licensed under the  [GNU General Public License](LICENSE) (GPL v3).

## 参考
- [podcasts](https://gitlab.gnome.org/World/podcasts)
- [gnome-music](https://gitlab.gnome.org/GNOME/gnome-music)
- [musicbox](https://github.com/darknessomi/musicbox)
- [NeteaseCloudMusicRustApi](https://github.com/Itanq/NeteaseCloudMusicRustApi)