# nusic-server

**Repository Path**: aqzscn/nusic-server

## Basic Information

- **Project Name**: nusic-server
- **Description**: NAS Music 服务端
- **Primary Language**: Python
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-11-03
- **Last Updated**: 2022-11-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NAS Music Server

#### 介绍

NAS Music 服务端，用于管理用户的音乐资料库，提供相关接口供客户端使用，使用户在极端网络条件下也能较为流畅地享受私人音乐资料库里的音乐。

##### 特性

- [x] 音频资源探测
- [x] 分页获取音乐列表功能
- [x] 音质/格式转换（依赖`ffmpeg`）
- [x] 音频资源分类整理

待办事项：

- 接口鉴权
- 日志处理
- 制作 docker 镜像，尝试用于自己的 NAS
- 编写客户端代码！

#### 安装教程

1.  [Mac OS ffmpeg 安装教程](https://zhuanlan.zhihu.com/p/90099862)

> 待补充……

#### 使用说明

警告：目前处于开发的早期阶段，功能和接口格式不稳定，可能发生较大变动，不建议轻易尝试。

> 待补充……

##### 音乐资料库目录结构

```
music 音乐资料库
├─ conf 配置文件
└─ library 音乐资料库
```

#### 参考资料

##### 比特率值与现实音频对照

- 16Kbps=电话音质
- 24Kbps=增加电话音质、短波广播、长波广播、欧洲制式中波广播
- 40Kbps=美国制式中波广播
- 56Kbps=话音
- 64Kbps=增加话音(手机铃声最佳比特率设定值、手机单声道 MP3 播放器最佳设定值)
- 112Kbps=FM 调频立体声广播
- 128Kbps=磁带(手机立体声 MP3 播放器最佳设定值、低档 MP3 播放器最佳设定值)
- 160Kbps=HIFI 高保真(中高档 MP3 播放器最佳设定值)
- 192Kbps=CD(高档 MP3 播放器最佳设定值)
- 256Kbps=Studio 音乐工作室(音乐发烧友适用)

##### 常用采样率

- 8,000 Hz - 电话所用采样率, 对于人的说话已经足够
- 11,025 Hz
- 22,050 Hz - 无线电广播所用采样率
- 32,000 Hz - miniDV 数码视频 camcorder、DAT (LP mode)所用采样率
- 44,100 Hz - 音频 CD, 也常用于 MPEG-1 音频（VCD, SVCD, MP3）所用采样率
- 47,250 Hz - 商用 PCM 录音机所用采样率
- 48,000 Hz - miniDV、数字电视、DVD、DAT、电影和专业音频所用的数字声音所用采样率
- 50,000 Hz - 商用数字录音机所用采样率
- 96,000 或者 192,000 Hz - DVD-Audio、一些 LPCM DVD 音轨、BD-ROM（蓝光盘）音轨、和 HD-DVD （高清晰度 DVD）音轨所用所用采样率
- 2.8224 MHz - Direct Stream Digital 的 1 位 sigma-delta modulation 过程所用采样率。

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request