Files
amaoke.app/README.md
T
2025-11-25 01:13:59 +08:00

69 lines
2.0 KiB
Markdown

# 甘オケ / amaoke.app
Practice Japanese Karaoke lyrics reading and typing at the same time with amaoke.app!
在这里可以同时练习日语卡拉 OK 歌词阅读速度和打字速度!
## 主要功能
* [x] 导入网易云歌单自动获取歌词
* [x] 自动给歌词标注读音
* [x] 打字模式
* [x] 切换 furigana 显示模式 (显示/隐藏/仅显示假名/显示罗马音)
* [x] 统计打字速度和准确率
* [x] 跟随打字速度自动播放/暂停音乐
* [ ] 历史成绩和进步曲线
* [x] 唱歌模式
* [x] 自动分离人声和伴奏
* [ ] 分段处理以加快初始加载速度
* [x] 自动预处理下一首歌
* [x] 调节人声伴奏比例
* [x] 跟随音乐滚动歌词
* [x] 播放/暂停音乐控制
* [x] 实时变调变速(速度越快音调就越高)
* [ ] 单独控制变调和变速(非实时)
* [ ] 音域分析(自动推荐升降调幅度)
* [ ] 电视模式
* [ ] 和手机配对、用手机点歌
* [ ] 从网易云搜索歌曲
## Technical Tasks
* [x] i18n
* [x] 404 page
* [x] Previous song / next song buttons
* [x] Update an existing playlist
* [ ] Allow users to correct lyric pronunciations through correction feedback
* [ ] Correct lyrics timing inconsistencies (i.e. 网易云的歌词因为是业余用户上传的,时间戳不一定准确。但是 waveform 里面可以分析出每段人声的具体开始结束时间,也许可以自动修正)
* [x] Processing lyrics and audio should be parallel
* [ ] Add admin password to admin pages
* [x] About page
* [ ] Intro popup
## Development server
### Requirements
- Bun
- Docker
### 1. Environment setup
1. Create your `.env` file by renaming `.env.example` to `.env`
2. Add the following variable:
OPENROUTER_API_KEY=your_key_here
(Request the key from the repository owner)
### 2. Start the database
Run in the project root:
docker compose up
### 3. Install dependencies
Install Bun:
https://bun.com/get
Then install project dependencies:
bun install
### 4. Start development server
bun run dev