# radishes

**Repository Path**: link0109/radishes

## Basic Information

- **Project Name**: radishes
- **Description**: Cross-platform copyright-free music platform（跨平台的无版权的音乐平台）. 支持 windows / macos / linux / web
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: next
- **Homepage**: http://radishes.vercel.app/
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2021-01-16
- **Last Updated**: 2023-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Electron, macOS, Vue, Windows, unblockmusic

## README

## Radishes 2.0.0

![release](https://github.com/Linkontoask/radishes/workflows/release/badge.svg)

`Radishes`是这个项目的名称，它是由`萝卜`翻译而来。

界面表现和功能参考 windows 网易云音乐界面和 ios 的网易云音乐，会对一些功能进行移动端支持。希望能找到合适的基于 vue3 的移动端打包工具（非套壳）。

项目成立原因：

- 打造一款跨端播放器，减低用户学习成本。
- 希望完成全音乐播放，避免版权问题不能播放。
- 接触 vue3 新功能以及周边生态，提升编码水平、有效合理的组织代码结构与逻辑。
- [TypeScript 4.x](https://github.com/Microsoft/TypeScript) 已经发布，它的好处已经足够明显，故借此项目深入学习。
- 使用前沿技术让一个项目从 0 到 1 的过程不仅可以提升我们的 coding 水平，还可以提升非 coding （设计、 git 、 nginx 等）的能力。

### 项目运行

- 克隆项目

`git clone https://github.com/Linkontoask/radishes.git`

- 安装依赖

```shell
cd radishes/
npx lerna bootstrap
```

- 运行项目  
  web: `yarn dev`  
  electron: `yarn dev:electron`

- 构建项目  
  web: `yarn build`  
  electron: `yarn build:electron`

### 重构计划

~~2020.10.31 之前完成基本架构（可能更早）。~~(已完成基本架构，可能会因为功能需求变更一些，但是整体上不会有大的变动。)  
因为时间安排，只会在业余时间去重构，所以时间上没有具体安排。如果你也是如此，希望在业余时间做一些或学一些东西，我觉得这个重构计划很适合你，参与方式在下面。

### 支持的功能

`browser`: 浏览器支持  
`electron`: 桌面级支持  
`mobile`: 移动端支持(在线链接: [http://112.74.169.178/mobile/music/](http://112.74.169.178/mobile/music/)，分支：`next-mobile`)  
`√`: 已经支持  
`×`: 不打算支持

| 功能                                                            | browser | electron | mobile |
| :-------------------------------------------------------------- | :-----: | :------: | :----: |
| 登录和注册（邮箱暂不支持注册）                                    |    √    |    √     |        |
| 每日推荐歌单和歌曲                                               |    √    |    √     |    √    |
| 每日轮播图以及新歌播放、查看歌单详情                               |    √    |    √     |    √    |
| 歌单搜索、查看、收藏、下载                                        |    √    |    √     |    √    |
| 歌曲排行榜以及排行榜的分类支持                                     |    √    |    √     |    √    |
| 支持查看歌手专辑、详情、相似歌手以及歌手按地区等方式过滤             |    √    |    √     |    √    |
| 歌曲播放、暂停、歌词(横向、纵向)、音量 MediaSession(Chrome)       |    √    |    √     |    √    |
| 浮动歌词支持（在PC上为一个子窗口），歌词进度显示                   |    √    |    √     |   ×     |
| 支持设置播放源（QQ、酷狗等）、下载品质和下载位置修改                |    √    |    √     |        |
| 支持搜索歌手、专辑、歌单和单曲                                     |    √    |    √     |   √    |
| 本地音乐支持（支持拖放播放歌曲、歌曲标签ID3v2显示）                 |    √    |    √     |   ×     |
| 缓存本地所有状态（比如当前播放歌曲、进度、主题颜色、大小等）         |    √    |    √     |   √    |
| 朋友动态查看、点赞等                                            |         |          |        |
| 音乐云盘                                                        |    √     |     √     |        |
| 视频播放、收藏                                                  |         |          |        |
| 通知(已登录)                                                    |    ×    |          |   ×    |
| 音效(3D环绕、淡入淡出、温柔、混合)                                |    √    |     √    |        |

### Git 提交规范

[rules](https://github.com/conventional-changelog/commitlint/blob/master/%40commitlint/config-conventional/index.js)

提交模式如下：  
`type(scope?): subject`

更多规则参考[https://github.com/conventional-changelog/commitlint](https://github.com/conventional-changelog/commitlint)

### Electron

目前已发布第一版，包含听歌等功能，前往 [https://github.com/Linkontoask/radishes/releases/tag/2.0.0-alpha.1](https://github.com/Linkontoask/radishes/releases/tag/2.0.0-alpha.1) 下载 windows 版本。  
macOS 版本暂时无法发布（因为我没钱买 mac ）。
在开发的同时会快速兼容 Electron 。所谓的快速就是调用很少的 API 实现 PC 端的功能，比如放大、缩小、通知、歌词、音乐拖放上传。  

目前`Electron`已经支持对歌曲的标签写入与读取，专辑封面还未压缩处理。所有在`radishes`平台下载的歌曲都会自动生成歌曲的歌手、专辑、标题等内容。  
到现在为止，`Electron`平台相对于`Web`平台已经完成了下载进度展示、本地音乐的同步和播放、浮动歌词的展示。  

### `vue3.x`已发布，音乐项目已完成基本架构

目前会利用闲暇时间进行重构，如果你也想参与进来，可以发邮件或在[这里](https://github.com/Linkontoask/radishes/issues/6)告诉我

### 邀请前端开发人员进行重构

> 请在 issues 中留下你的想法，或者给我发送邮件告诉我你的想法 [linkorgs@163.com](linkorgs@163.com)，我会及时回复您

相关链接：

- [NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi)
- [UnblockNeteaseMusic](https://github.com/nondanee/UnblockNeteaseMusic)
- [vuejs](https://v3.vuejs.org/)
- [commitlint](https://commitlint.js.org/#/)
- [vue-cli](https://cli.vuejs.org/zh/)
- [prettier](https://prettier.io/)
- [webpack-chain](https://github.com/neutrinojs/webpack-chain#getting-started)
- [storybook](https://github.com/storybookjs/storybook/tree/next/app/vue)
- [storybook vue3 support](https://github.com/storybookjs/storybook/issues/10654)
- [vue-cli-plugin-electron-builder](https://github.com/nklayman/vue-cli-plugin-electron-builder)
- [vue-cli jsx](https://github.com/vuejs/jsx-next/blob/dev/packages/babel-plugin-jsx/README-zh_CN.md)
- [nativescript vue 3 issues](https://github.com/nativescript-vue/nativescript-vue/issues/583)
- [nativescript-vue](https://github.com/nativescript-vue/nativescript-vue)
- [browser module](https://philipwalton.com/articles/deploying-es2015-code-in-production-today/)
- [dayjs](https://day.js.org/docs/zh-CN/installation/installation)
- [lerna](https://github.com/lerna/lerna)
- [id3-writer](https://github.com/egoroof/browser-id3-writer)