Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Revise repo docs [skip ci] #2146

Merged
merged 6 commits into from
Dec 7, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion FAQ.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# lx-music-desktop 常见问题

本文档已迁移到<https://lyswhut.github.io/lx-music-doc/desktop/faq>
本文档已迁移至<https://lyswhut.github.io/lx-music-doc/desktop/faq>

<!--
在阅读本常见问题后,仍然无法解决你的问题,请提交issue或者加企鹅群`830125506`反馈(无事勿加,入群先看群公告),反馈时请**注明**已阅读常见问题!
Expand Down
102 changes: 51 additions & 51 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
<p align="center"><a href="https://github.com/lyswhut/lx-music-desktop"><img width="200" src="https://github.com/lyswhut/lx-music-desktop/blob/master/doc/images/icon.png" alt="lx-music logo"></a></p>

<h1 align="center">LX Music 桌面版</h1>

<p align="center">
<a href="https://github.com/lyswhut/lx-music-desktop/releases"><img src="https://img.shields.io/github/release/lyswhut/lx-music-desktop" alt="Release version"></a>
<a href="https://github.com/lyswhut/lx-music-desktop/actions/workflows/release.yml"><img src="https://github.com/lyswhut/lx-music-desktop/workflows/Build/badge.svg" alt="Build status"></a>
Expand Down Expand Up @@ -28,11 +30,9 @@
[9]: https://img.shields.io/github/license/lyswhut/lx-music-desktop
[10]: https://github.com/lyswhut/lx-music-desktop/blob/master/LICENSE -->

<h2 align="center">洛雪音乐助手桌面版</h2>

### 说明
<p align="center">一个基于 Electron + Vue 开发的音乐软件</p>

一个基于 Electron + Vue 开发的音乐软件。
## 说明

所用技术栈:

Expand All @@ -41,120 +41,120 @@

已支持的平台:

- Windows 7 及以上
- Mac OS
- Linux
- macOS
- Windows 7 及以上

软件变化请查看:[更新日志](https://github.com/lyswhut/lx-music-desktop/blob/master/CHANGELOG.md)<br>
软件下载请转到:[发布页面](https://github.com/lyswhut/lx-music-desktop/releases)<br>
~~或者到网盘下载(网盘内有MAC、windows版):`https://www.lanzoui.com/b0bf2cfa/` 密码:`glqw`(若链接无法打开请百度:蓝奏云链接打不开)<br>~~
使用常见问题请转至:[常见问题](https://lyswhut.github.io/lx-music-doc/desktop/faq)
软件变化请查看 [更新日志](https://github.com/lyswhut/lx-music-desktop/blob/master/CHANGELOG.md)。

目前本项目的原始发布地址只有**GitHub**及**蓝奏网盘**,其他渠道均为第三方转载发布,与本项目无关!
软件下载请查看 [GitHub Releases](https://github.com/lyswhut/lx-music-desktop/releases)。

为了提高使用门槛,本软件内的默认设置、UI操作不以新手友好为目标,所以使用前建议先根据你的喜好浏览调整一遍软件设置,阅读一遍[音乐播放列表机制](https://lyswhut.github.io/lx-music-doc/desktop/faq/playlist)及[可用的鼠标、键盘快捷操作](https://lyswhut.github.io/lx-music-doc/desktop/faq/hotkey)
目前本项目的原始发布地址只有 [**GitHub Releases**](https://github.com/lyswhut/lx-music-desktop/releases),其他渠道均为第三方转载发布,与本项目无关!

#### Scheme URL支持
为了提高使用门槛,本软件内的默认设置、UI 操作不以新手友好为目标,所以使用前建议先根据你的喜好浏览调整一遍软件设置,阅读一遍 [音乐播放列表机制](https://lyswhut.github.io/lx-music-doc/desktop/faq/playlist) 及 [可用的鼠标、键盘快捷操作](https://lyswhut.github.io/lx-music-doc/desktop/faq/hotkey)。

从v1.17.0起支持 Scheme URL,可以使用此功能从浏览器等场景下调用LX Music,我们开发了一个[油猴脚本](https://github.com/lyswhut/lx-music-script#readme)配套使用,<br>
脚本安装地址:<https://greasyfork.org/zh-CN/scripts/438148><br>
### Scheme URL 支持

若你想自己调用LX Music,可以看[Scheme URL支持](https://lyswhut.github.io/lx-music-doc/desktop/scheme-url)
从 v1.17.0 起支持 Scheme URL,可以使用此功能在浏览器等场景下调用 LX Music,我们开发了一个 [油猴脚本](https://github.com/lyswhut/lx-music-script#readme) 配套使用。

#### 数据同步服务
脚本安装地址:[LX Music 辅助脚本](https://greasyfork.org/zh-CN/scripts/438148)。

从v2.2.0起,我们发布了一个独立版的[数据同步服务](https://github.com/lyswhut/lx-music-sync-server#readme),如果你有服务器,可以将其部署到服务器上作为私人多端同步服务使用,详情看该项目说明
若你想自己调用 LX Music,可以参考 [Scheme URL 支持](https://lyswhut.github.io/lx-music-doc/desktop/scheme-url)。

#### 开放 API 支持
### 数据同步服务

从 v2.7.0 起支持开放API服务,启用该功能后,将会在本地启动一个 HTTP 服务,提供播放器相关的接口供第三方软件调用,详情看[开放 API 文档](https://lyswhut.github.io/lx-music-doc/desktop/open-api)
从 v2.2.0 起,我们发布了一个独立版的 [数据同步服务](https://github.com/lyswhut/lx-music-sync-server#readme),如果你有服务器,可以将其部署到服务器上作为私人多端同步服务使用,详情看该项目说明

#### 数据存储路径
### 开放 API 支持

从 v2.7.0 起支持开放 API 服务,启用该功能后,将会在本地启动一个 HTTP 服务,提供播放器相关的接口供第三方软件调用,详情看 [开放 API 文档](https://lyswhut.github.io/lx-music-doc/desktop/open-api)。

### 数据存储目录

默认情况下,软件的数据存储在:

- Windows:`%APPDATA%/lx-music-desktop`
- Linux:`$XDG_CONFIG_HOME/lx-music-desktop` 或 `~/.config/lx-music-desktop`
- macOS:`~/Library/Application Support/lx-music-desktop`
- Windows:`%APPDATA%/lx-music-desktop`

在Windows平台下,若程序目录下存在`portable`目录,则自动使用此目录作为数据存储目录(v1.17.0新增)。
在 Windows 平台上,若程序目录中存在 `portable` 目录,则自动使用此目录作为数据存储目录(适用于 v1.17.0 及以上版本)。

### UI界面
## 用户界面

<p><a href="https://github.com/lyswhut/lx-music-desktop"><img width="100%" src="https://github.com/lyswhut/lx-music-desktop/blob/master/doc/images/app.png" alt="lx-music UI"></a></p>
<p><a href="https://github.com/lyswhut/lx-music-desktop"><img width="100%" src="https://github.com/lyswhut/lx-music-desktop/blob/master/doc/images/app.png" alt="lx-music desktop UI"></a></p>

### 常见问题
## 常见问题

常见问题已移至:<https://lyswhut.github.io/lx-music-doc/desktop/faq>
已迁移至:<https://lyswhut.github.io/lx-music-doc/desktop/faq>

### 贡献代码
## 贡献代码

本项目欢迎PR,但为了PR能顺利合并,需要注意以下几点:
本项目欢迎 PR,但为了 PR 能顺利合并,需要注意以下几点:

- 对于添加新功能的PR,建议在PR前先创建issue说明,以确认该功能是否确实需要
- 对于修复Bug PR,请提供修复前后的说明及重现方式
- 其他类型的PR则适当附上说明
- 对于添加新功能的 PR,建议在提交 PR 前先创建 issue 进行说明,以确认该功能是否确实需要
- 对于修复 bug 的 PR,请提供修复前后的说明及重现方式
- 对于其他类型的 PR,则适当附上说明。

贡献代码步骤:

1. 参照[源码使用方法](https://lyswhut.github.io/lx-music-doc/desktop/use-source-code)设置开发环境
2. 克隆本仓库代码并切换到`dev`分支开发
3. 提交PR至`dev`分支
1. 参照 [源码使用方法](https://lyswhut.github.io/lx-music-doc/desktop/use-source-code) 设置开发环境
2. 克隆本仓库代码并切换至 `dev` 分支进行开发;
3. 提交 PR 至 `dev` 分支。

### 源码使用方法
## 源码使用方法

已迁移至:<https://lyswhut.github.io/lx-music-doc/desktop/use-source-code>

### 项目协议
## 项目协议

本项目基于 [Apache License 2.0](https://github.com/lyswhut/lx-music-desktop/blob/master/LICENSE) 许可证发行,以下协议是对于 Apache License 2.0 的补充,如有冲突,以以下协议为准。

---

词语约定:本协议中的“本项目”指洛雪音乐桌面版项目;“使用者”指签署本协议的使用者;“官方音乐平台”指对本项目内置的包括酷我、酷狗、咪咕等音乐源的官方平台统称;“版权数据”指包括但不限于图像、音频、名字等在内的他人拥有所属版权的数据。
*词语约定:本协议中的“本项目”指 LX Music (洛雪音乐助手)桌面版项目;“使用者”指签署本协议的使用者;“官方音乐平台”指对本项目内置的包括酷我、酷狗、咪咕等音乐源的官方平台统称;“版权数据”指包括但不限于图像、音频、名字等在内的他人拥有所属版权的数据。*

#### 一、数据来源
### 一、数据来源

1.1 本项目的各官方平台在线数据来源原理是从其公开服务器中拉取数据(与未登录状态在官方平台APP获取的数据相同),经过对数据简单地筛选与合并后进行展示,因此本项目不对数据的合法性、准确性负责。
1.1 本项目的各官方平台在线数据来源原理是从其公开服务器中拉取数据(与未登录状态在官方平台 APP 获取的数据相同),经过对数据简单地筛选与合并后进行展示,因此本项目不对数据的合法性、准确性负责。

1.2 本项目本身没有获取某个音频数据的能力,本项目使用的在线音频数据来源来自软件设置内“音乐来源”设置所选择的“源”返回的在线链接。例如播放某首歌,本项目所做的只是将希望播放的歌曲名字、歌手名字等信息传递给“源”,若“源”返回了一个链接,则本项目将认为这就是该歌曲的音频数据而进行使用,至于这是不是正确的音频数据本项目无法校验其准确性,所以使用本项目的过程中可能会出现希望播放的音频与实际播放的音频不对应或者无法播放的问题。

1.3 本项目的非官方平台数据(例如我的收藏列表)来自使用者本地系统或者使用者连接的同步服务,本项目不对这些数据的合法性、准确性负责。

#### 二、版权数据
### 二、版权数据

2.1 使用本项目的过程中可能会产生版权数据。对于这些版权数据,本项目不拥有它们的所有权。为了避免侵权,使用者务必在**24小时内**清除使用本项目的过程中所产生的版权数据。
2.1 使用本项目的过程中可能会产生版权数据。对于这些版权数据,本项目不拥有它们的所有权。为了避免侵权,使用者务必在 **24 小时内** 清除使用本项目的过程中所产生的版权数据。

#### 三、音乐平台别名
### 三、音乐平台别名

3.1 本项目内的官方音乐平台别名为本项目内对官方音乐平台的一个称呼,不包含恶意。如果官方音乐平台觉得不妥,可联系本项目更改或移除。

#### 四、资源使用
### 四、资源使用

4.1 本项目内使用的部分包括但不限于字体、图片等资源来源于互联网。如果出现侵权可联系本项目移除。

#### 五、免责声明
### 五、免责声明

5.1 由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害(包括但不限于因商誉损失、停工、计算机故障或故障引起的损害赔偿,或任何及所有其他商业损害或损失)由使用者负责。

#### 六、使用限制
### 六、使用限制

6.1 本项目完全免费,且开源发布于 GitHub 面向全世界人用作对技术的学习交流。本项目不对项目内的技术可能存在违反当地法律法规的行为作保证。

6.2 **禁止在违反当地法律法规的情况下使用本项目。** 对于使用者在明知或不知当地法律法规不允许的情况下使用本项目所造成的任何违法违规行为由使用者承担,本项目不承担由此造成的任何直接、间接、特殊、偶然或结果性责任。

#### 七、版权保护
### 七、版权保护

7.1 音乐平台不易,请尊重版权,支持正版。

#### 八、非商业性质
### 八、非商业性质

8.1 本项目仅用于对技术可行性的探索及研究,不接受任何商业(包括但不限于广告等)合作及捐赠。

#### 九、接受协议
### 九、接受协议

9.1 若你使用了本项目,将代表你接受本协议
9.1 若你使用了本项目,即代表你接受本协议

---

若对此有疑问请 mail to: lyswhut+qq.com (请将`+`替换成`@`)
若对此有疑问请 mail to: lyswhut+qq.com (请将 `+` 替换为 `@`)
Loading
Loading