# WwMusic

**Repository Path**: pyoc/ww-music

## Basic Information

- **Project Name**: WwMusic
- **Description**: Ww music是一个使用Java实现的命令行音乐软件
- **Primary Language**: Java
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-29
- **Last Updated**: 2025-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ww Music
 wwmusic是一个使用JAVA实现的命令行音乐软件,设计灵感来源 **[cmus](https://github.com/cmus/cmus)**
 
## 基本功能
- 歌曲播放 ![images](https://tanyusheng.icu/images/wwmusic_home.png)
- 搜索歌曲、歌手、专辑 ![images](https://tanyusheng.icu/images/wwmusic_search.png)
- 播放本地歌曲 ![images](https://tanyusheng.icu/images/wwmusic_file.png)
- 根据网易云歌单ID获取歌曲列表,将歌单写入sqlite ![images](https://tanyusheng.icu/images/wwmusic_songlist_search.png)
- 查看/删除sqlite缓存歌曲信息 ![images](https://tanyusheng.icu/images/wwmusic_cache.png)
- 歌词资源来源于网易云,且不支持收费歌曲

## 配置
```properties
#python脚本路径
FFI.PATH=wwmusic.py
#python命令路径
FFI.PYTHON=/usr/bin/python3
#分页查询
MUSIC.OFFSET=0
MUSIC.LIMIT=5
#ui page包路径
MUSIC.SCAN=icu.pyoc.ww.ui.pages
#数据库文件路径
MUSIC.DB=wwmusic.db
#是否开启数据库
MUSIC.DB.ENABLE=true
```



## 手动安装(不推荐)
   安装java(JDK>=11) python pip maven git
```bash
   $ git clone https://gitee.com/pyoc/ww-music.git
   $ cd ww-music
   # 修改src/main/resource/config.properties中的FFI.PYTHON为你的PYTHON路径
   $ echo "FFI.PYTHON=${YOUR_PYTHON_PATH}" >> src/main/resource/config.properties
   $ pip3 install -r src/main/py/requirements.txt
   $ mvn dependency:resolve
   $ mvn compile 
   
   #启动 如果在Window系统下必须使用javaw启动应用
   $ mvn exec:java -Dexec.mainClass="icu.pyoc.ww.WwMusic"
```


## 安装(推荐)
```bash
  1.安装java(JDK>=11) python pip
  2.下载 1.0.0发行版本 
  3.解压wwmusic-1.0.zip
  
  # 安装python库
  4.pip install -r requirements.txt
  
  #修改config.properties中的FFI.PYTHON为你的python路径
  5.FFI.PYTHON=/usr/bin/python3
  
  #运行
  java icu.pyoc.ww.WwMusic # (Linux/Macos)
  javaw icu.pyoc.ww.WwMusic # (Window)  
```

## 使用方式 (使用1～9数字键切换页面)
| Switch Key |     Title      |                                                        Description |  
|:-----------|:--------------:|-------------------------------------------------------------------:|
| 1          |      Home      |                                                   主页，展示当前正在播放的歌曲信息 |
| 2          |      File      |                                       通过上/下/Enter键切换目录,播放本地MP3音频文件 |
| 3          |     Search     | 根据歌曲名称搜索歌曲信息，使用Tab切换光标。当选择useCache时会优先从数据库缓存中查找数据。当光标在输入框上时无法切换页面。 |
| 4          | SongListSearch |                                                  根据网易云歌单ID获取歌单歌曲信息 |
| 6          |     Cache      |                                                 查看/播放/删除数据库缓存的歌曲信息 |
| 7          |    SongList    |                                                       查看数据库保存的歌单信息 |
| 9          |    QQMusic     |                                                  根据QQ歌单ID获取歌单歌曲信息 |