Skip to content

QUICK_START.md

Latest commit

 

History

History
163 lines (116 loc) · 2.35 KB

QUICK_START.md

File metadata and controls

163 lines (116 loc) · 2.35 KB

CloudMusic 快速开始

1. 安装

本地一键安装

git clone https://github.com/vimalinx/CloudMusic.git
cd CloudMusic
./install.sh
source ~/.zshrc

Arch / AUR

cd packaging/aur/cloudmusic-git
makepkg -si

如果 AUR 包已发布，也可以直接：

yay -S cloudmusic-git

2. 登录

自动导入 Cookie（推荐）

musicctl login-auto
musicctl whoami

QR 登录

musicctl login-qr
musicctl whoami

手动 Cookie 登录

musicctl login --cookie 'MUSIC_U=xxx; __csrf=yyy'
musicctl whoami

3. 启动

Fancy TUI

cloudmusic

纯 ASCII 复古界面

cloudmusic-ascii

启动器

cloudmusic-start
# 或
./start.sh

4. 常用命令

搜索

musicctl search "周杰伦"
musicctl bridge search --keyword "稻香" --limit 10

播放

musicctl play url 20744694 --play
musicctl play stop

歌单

musicctl playlist ls --uid <uid>
musicctl playlist pull --id <playlist_id> --format m3u
musicctl playlist download --id <playlist_id> --dir ~/Music/CloudMusic

Rofi / Waybar

musicctl bridge status
musicctl bridge control --action play-pause
scripts/RofiBeats_CloudMusic.sh

5. 关键键位

Fancy TUI

  • Enter：加载歌单 / 播放歌曲
  • Tab / Shift+Tab：切换区域
  • Space：播放/暂停
  • n / p：上下首
  • x：停止
  • Ctrl+f：云搜索
  • ?：帮助
  • q：退出

ASCII CLI

  • Tab / ← / →：切 pane
  • j / k：移动
  • Enter：加载/播放
  • Space：播放/暂停
  • n / p：上下首
  • l：循环
  • x：随机
  • s：停止
  • q：退出

6. 配置

配置文件：~/.config/cloudmusic/config.yaml

quality: exhigh
download_dir: ~/Music/CloudMusic
theme: retro
volume: 70
loop_mode: all
shuffle: false

7. 常见问题

播放不了

  • 先确认 musicctl whoami 正常
  • 建议安装 mpv
  • 执行 musicctl play stop 清理旧播放进程

Rofi 里两路声音重叠

  • 使用仓库自带的 scripts/RofiBeats_CloudMusic.sh
  • 它会在开始 CloudMusic 播放前先停掉旧的 radio-mpv

Fancy TUI 里帮助弹窗崩溃

  • 这个问题已经修复；请更新到最新代码或最新包版本

8. 更多文档

  • README.md
  • CHANGELOG.md
  • ROFIBEATS_INTEGRATION.md