# LoonMusic-Release

**Repository Path**: AByte-L/LoonMusic-Release

## Basic Information

- **Project Name**: LoonMusic-Release
- **Description**: PC端NAS音乐播放器（发布仓库）。
- **Primary Language**: C#
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-02-24
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 群晖, NAS, MusicPlayer, 音乐播放器

## README

# Loon Music

## 介绍
LoonMusic 是针对群晖NAS开发的 Windows 端音乐播放器。

> 名字来源于 `roon` 音乐播放器，无实际意义

![alt text](assets/image-11.png)

![alt text](assets/image-23.png)

本软件为方便自己在桌面端使用群晖的音乐服务开发的，目前仅支持群晖，也只针对自己的群晖系统版本进行测试。

个人开发，进度慢，Bug多，功能不完善，尽量保持迭代更新...


### 用户交流微信群

![alt text](QR-Code.png)

若二维码失效，联系：1802171399@qq.com

### NAS支持

1. 仅支持群晖（测试DSM版本：Version: 7.2.2-72806 Update 3）
2. 其他NAS（暂无计划支持）

## 功能描述

### 页面功能

1. 主页：随便听听，歌手统计、专辑统计、歌曲统计；可以在群晖网页端将歌手、播放列表、文件夹等锁定，这里会在我的锁定中显示。
2. 最近添加：最新改动的专辑（新增、修改封面、修改歌词等都会识别未最近添加）
3. 我喜欢的（群晖没有我喜欢的分类，是根据自己的需求，将 歌曲 `rating` 评分为 `5` 的作为我喜欢）
4. 所有歌曲（支持增量加载）
5. 歌手
6. 文件夹，可批量编辑文件夹中的歌曲信息，如果你的歌曲是按专辑分类的，这里批量操作非常方便
7. 歌单（播放列表）
8. 专辑
9. 歌词页面（支持歌词搜索、歌词编辑、字体调整，时间调整）
10. 播放队列（支持拖动排序）
11. 下载管理（存在问题，待完善）
12. 本地音乐（存在问题，待完善）



### 辅助功能

1. 支持托盘
2. 系统媒体控制面板支持
3. 任务栏提供上一曲，下一曲，播放/暂停功能（待完善）
4. 支持搜索（歌曲、专辑、歌手）
5. 单列运行，启动多个实例时，始终激活第一个实列，并将窗口前置
6. 支持播放列表缓存，进度缓存

### Todo

1. 完善主页
2. 增加“最近播放”功能



## 安装

### 环境要求

> 重要！重要！重要！

- 操作系统: Windows11（推荐）或者 Windows 10 版本 1809 (Build 17763) 或更高版本。

- 查看方式：在桌面右键此电脑-》属性-》Window 规格-》操作系统内部版本


### 下载

1. gitee的仓库文件上传有大小限制，后期的版本上传不了了。
2. 后期版本从 **微信群** 里面下载。


### 安装证书

由于软件使用的旁加载安装方式，需要受信任的证书才能安装，因此您需要安装相应的证书。以下是安装证书的步骤：

1. 从软件发布者处获取证书文件（通常是 .cer 或 .pfx 文件），注：安装包中已提供。
1. 右键点击证书文件，选择“安装证书”。
1. 在证书导入向导中，选择 **本地计算机** **本地计算机** **本地计算机**，然后点击 下一步。
1. 选择 **将所有证书放入以下存储**，然后点击 浏览。
1. 选择 **受信任的根证书颁发机构**，然后点击 确定。
1. 点击“下一步”，然后点击 完成。
1. 如果系统提示，请确认安装证书。


### 安装应用程序

1. 下载应用程序包（通常是 .msix 或 .appx 文件）。
1. 双击下载的应用程序包文件。
1. 系统会弹出安装提示，点击 安装。
1. 等待安装完成，安装完成后可以在开始菜单中找到应用程序（安装后显示的软件名称为：Loon）
2. 安装后安装程序可以删除。

**非常规安装**

> 非常规方式安装没有没有界面提示，安装没有报错，直接在开始菜单中查看新增的 Loon 应用

如果出现系统无法识别 msix 格式的情况

![alt text](assets/image-13.png)


使用 `Install.ps1` 脚本安装，右键，使用PowerShell运行

![alt text](assets/image-14.png)

如果上面的方式还是失败，使用 `Add-AppDevPackage.ps1` 脚本安装，右键，使用PowerShell运行

![alt text](assets/image-15.png)


### 卸载应用程序

1. 打开 设置。
1. 导航到 **Loon** 应用 > 应用与功能。
1. 在列表中找到您的应用程序，点击 卸载。


### 更新应用程序

- 软件 **设置** 页面中提供了 “检查更新” 按钮用于检测是否有新版本，新版版也在微信群里面提供。

- 下载后直接点击安装文件，软件会自动更新。

- 如果提示证书过期，重新导入最新版本中的证书，然后再点击安装文件，此时变为安装一个新软件，需要重新再登录一次。


## 登录

### 账号要求

- 建议你创建一个非管理员的账号，该账号允许访问群晖的 AudoStation 和 FileStation服务，且允许对音乐文件夹进行读写，以方便修改歌曲元数据信息（如：歌词）。
- 账号不要启用双重验证，否者登录失败。
- 正常情况下，使用https和http都可以连接。


### 登录步骤

1. 点击标题栏上的 **NAS** 

![alt text](assets/image-8.png)

2. 点击登录

![alt text](assets/image-9.png)

1. 输入服务器地址、用户名和密码进行登录，服务器地址开头若不指定http/https，默认使用https方式连接，必须指定端口（一般为5001）,若使用http协议，必须指定http和端口（一般为5000），具体参照下表：
  
  <style>
.table-container {
    display: flex;
    justify-content: center;
    width: 100%;
}

.excel-table {
    width: 100%;
    border-collapse: collapse;
    font-family: Arial, sans-serif;
    font-size: 12px; /* 设置字体大小 */
    table-layout: fixed; /* 固定表格布局  这样可实现表格第一列固定宽度，剩下的按比例自动拉伸*/
}

.excel-table th, .excel-table td {
    border: 1px solid #d0d7de;
    padding: 8px;
    text-align: left;
}

.excel-table th {
    background-color: #f0f3f5;
    font-weight: bold;
}


.excel-table th:nth-child(1), .excel-table td:nth-child(1) {
    width: 40px;
    /*  width: 100px; 固定第一列宽度 */
}

.excel-table th:nth-child(2), .excel-table td:nth-child(2) {
    width: 40%;
}

.excel-table th:nth-child(3), .excel-table td:nth-child(3) {
    width: 40%;
}
.excel-table th:nth-child(4), .excel-table td:nth-child(4) {
    width: 20%;
}
</style>


<div class="table-container">
    <table class="excel-table">
        <thead>
            <tr>
                <th>协议</th>
                <th>域名连接</th>
                <th>IP连接</th>
                <th>说明</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td rowspan="2">Https</td>                 
                <td>xxx.familyds.com:5001</a></td>
                <td>192.168.1.110:5001</a></td>
                <td>省略https；<br>必须指定端口5001</a></td>
            </tr>
            <tr>
                <td>https://xxx.familyds.com:5001</a></td>
                <td>https://192.168.1.110:5001</a></td>
                <td>可选指定https；<br>必须指定端口5001</a></td>
            </tr>
            <tr>
                <td rowspan="2">Http</td>             
                <td>http://xxx.familyds.com:5000</a></td>
                <td>http://192.168.1.110:5000</a></td>
                <td>必须指定http；<br>必须指定端口5000</a></td>
            </tr>
        </tbody>
    </table>
</div>

1. 若要注销，点击 **注销** 即可
2. 可通过设置页面中查看当前连接的服务器和连接用户

![alt text](assets/image-10.png)


## 常见问题

> 优先查看本文档，无法解决可在微信群中咨询，大多问题其他人都经历过。

### 安装问题

- 证书问题: 确保已正确安装证书到 **本地计算机** 中的 **受信任颁发机构**，以及证书未过期。

- 系统版本: 确保系统版本满足最低要求。

- 权限问题: 或者使用管理员身份运行安装程序。

### 登录问题

- 正常情况下，使用https和http都可以连接到自己NAS。

- 账号不要开启双重验证。

- 若你的NAS支持外网访问，本软件就可以外网访问，反之亦然。

- 若https登录失败，换http登录。

- 若外网失败，换内网尝试。


### 歌曲信息同步问题

歌曲信息同步到NAS，需要账号拥有一定的权限

- AudoStation 服务权限，设置访问音乐服务器的必要条件。

- 拥有对音乐文件夹（一般为 Music）的读写权限，保存歌词、封面等信息需要。

- FileStation服务权限：目前未使用到，后期增加功能可能会使用

### 界面问题

软件色调跟随系统变动，有时出现一下异常，可通过设置主题修复。

![alt text](assets/6b20cae34fdf617d3ca0f97d8bb2e00.jpg)


**重新设置系统主题**

1. 按 Win + I 打开“设置”，或在“开始”菜单中点击“设置”图标。

2. 在“设置”中，选择“个性化”。

3. 在左侧菜单中，点击“主题”。

4. 应用现有主题，在“主题”页面，选择系统自带的主题，如“Windows 默认主题”或“Windows 浅色/深色主题”，点击主题名称即可应用。

![alt text](assets/image-12.png)

### 软件截图

（1）最近添加页面

![alt text](assets/image-11.png)

（2）我喜欢的页面

![alt text](assets/image-16.png)

（3）歌手页面

![alt text](assets/image-17.png)

![alt text](assets/image-21.png)

（4）文件夹页面

![alt text](assets/image-18.png)

（5）专辑页面

![alt text](assets/image-19.png)

（6）搜索结果页面

![alt text](assets/image-20.png)

（7）歌词搜索页面

![alt text](assets/image-7.png)

（8）设置页面

![alt text](assets/image-22.png)

（9）托盘

![alt text](assets/image-24.png)


## 隐私协议

`LoonMusic` 尊重并保护所有用户在使用 `LoonMusic` 应用程序时的个人隐私。为了向您提供更准确、更个性化的服务，`LoonMusic`将按照以下规定使用或披露您的个人信息：

 

本隐私政策，并高度谨慎处理。除本隐私政策的任何其他规定外，`LoonMusic`不会披露信息；

 

或在未经您事先许可的情况下提供给任何第三方。`LoonMusic`将不时更新本隐私政策。此隐私是不可或缺的，`LoonMusic`服务协议的一部分，因此当您同意`LoonMusic`的服务协议时，即视为您同意本隐私政策；

 

`LoonMusic`作为NAS音乐播放器，在初次使用的时候需要填入NAS地址以及用户名和密码，`LoonMusic`不会收集您输入的这些信息，这些信息只会存在于本地，用于您免输入登陆您的NAS；

 

在`LoonMusic`接入您的NAS后，你可以聆听音乐，同时浏览和修改音乐文件和音乐信息，切记所有操作均由您在软件中的使用所产生，`LoonMusic`不会主动去修改您群晖中的任何音乐文件；

 

`LoonMusic`不提供云端服务的内容，也不提供流媒体服务，所有的音乐文件以及封面歌词文件信息所有权均属于用户自身，应用中的云端（远程、多媒体）服务均根据开放接口实现。请务必先阅读相关的服务协议后再使用。