首页/新闻资讯/正文详情

3 步跑通 MusicBox:网易云音乐命令行播放器从安装到源码完整指南

发布时间:2026/11/6 5:09:53 来源:云帆数科 栏目:资讯中心
3 步跑通 MusicBox:网易云音乐命令行播放器从安装到源码完整指南
3 步跑通 MusicBox网易云音乐命令行播放器从安装到源码完整指南【免费下载链接】musicbox网易云音乐命令行版本项目地址: https://gitcode.com/gh_mirrors/mu/musicboxMusicBox项目名NetEase-MusicBox是一个用 Python 编写的网易云音乐命令行播放器让你直接在终端里搜索、播放和管理歌曲而不必打开浏览器或桌面客户端。它用字符块渲染出菜单、进度条和歌词支持多档音质、扫码登录、本地缓存甚至能配合 AI Agent 通过命令控制播放。本文带你从装好依赖、扫码登录到读懂核心代码和配置一步步把它真正用起来。 安装依赖与系统环境MusicBox 要求Python 3.10 及以上。真正发声的部分依赖外部解码器按你需要的音质分两档装系统必装MP3可选FLAC / Hi-Res工具macOSmpg123mpvbrew install mpg123 mpv uvUbuntu / Debianmpg123mpvsudo apt-get install mpg123 mpvCentOS / Red Hatmpg123mpvsudo yum install -y mpg123 mpv 低配设备如树莓派建议只装mpg123跳过mpv避免拉入一大串图形/视频依赖。装好系统依赖后推荐用uv或pipx把 MusicBox 装成全局命令uv tool install netease-musicbox # 或 pipx install NetEase-MusicBox想参与开发的话克隆仓库后在目录里执行uv tool install .开发期可加-e实现源码改动即时生效或干脆用uv run musicbox在本地直接跑。项目元数据与依赖都声明在 pyproject.toml 里。 首次运行与扫码登录安装完成后在终端敲musicbox即可进入 TUI 界面第一次进入登录相关功能时终端会画出一个二维码。现在只支持扫码登录不再支持账号密码。用网易云音乐手机 App 扫码并确认Cookie 就会写入数据目录默认~/.netease-musicbox/cookie.txt。几个容易踩的点二维码靠字符块渲染窗口建议 ≥ 25 行并使用等宽字体。必须用手机 App 扫码确认不支持直接打开 URL 完成登录。⌨️ 界面操作与 Vim 风格快捷键MusicBox 的交互逻辑在 menu.py渲染层在 ui.py。它刻意沿用了 Vim 的操作习惯上手后效率很高。几个高频键按键作用j/k下移 / 上移[/]上一曲 / 下一曲Space播放 / 暂停m回到主菜单f当前列表模糊搜索i当前歌曲信息Shift p切换播放模式q退出带数字修饰的快捷键如num j快速跳 n 首、num Shift g跳第 n 首需要先输入数字再按被修饰的键。完整键位表见 README.md 的快捷键章节。 核心模块速览整个播放器都在 NEMbox/ 目录下各文件职责清晰方便按需阅读模块文件职责数据接口api.py封装网易云搜索、歌单、榜单、歌词、播放链接等全部请求播放引擎player.py管理播放队列、模式并在mpg123/mpv两种后端间切换加密处理encrypt.pyEAPI 请求加密与解密登录与接口调用的底层依赖命令行cli.py面向脚本与 AI Agent 的无状态命令入口支持--json输出后台守护daemon.py常驻进程musicboxd持有唯一播放状态通过本地 socket 响应控制指令界面渲染ui.py用 curses 画菜单、进度条、歌词和登录二维码菜单逻辑menu.py处理按键事件、页面跳转与搜索持久化storage.py把用户、收藏、歌曲元数据存进database.json桌面歌词osdlyrics.py基于 Qt 在桌面悬浮窗显示滚动歌词程序入口在main.py带参数时走 CLI 分支不带参数则拉起 TUI而init.py 负责在导入时自动创建好配置、缓存与日志目录保证首次运行就有齐全的文件结构。⚙️ 配置与数据文件路径规则集中在 const.py并遵循 XDG 标准。常用文件如下文件默认位置用途config.json~/.netease-musicbox/config.json主配置音质、后端、快捷键、桌面歌词cookie.txt数据目录下扫码登录后的凭证database.json数据目录下本地收藏、播放历史等数据musicbox.log数据目录下运行日志排错时先查它cached/缓存目录下本地缓存歌曲主配置由 config.py 读写。最常改的两项music_quality音质等级可填数字或名称。值说明0/exhigh极高最高 320kbps3/lossless无损 FLAC4/hires高清臻音 96kHz/24bitjymaster超清母带 192kHz/24bitplayer_backend默认mpg123只播 MP3设为mpv则全程用mpv否则仅 FLAC 自动切到mpv。⚠️ 网易云歌曲接口目前只接受中国大陆访问。如果你在海外需要自行设置代理并确认出口 IP 属于大陆地区后再运行。 进阶CLI 与 AI Agent 控制除了 TUIMusicBox 还能被脚本和 AI Agent 直接驱动。数据类命令搜索、歌单、榜单无状态可单独调用播放控制类命令则依赖后台守护进程 daemon.pymusicbox search 周杰伦 --type song --json musicbox play --id 1847408145 --json musicbox status --json仓库里的 skills/musicbox/SKILL.md 给出了完整的命令速查与「搜歌→播放→读回状态」的操作配方可以让 Cursor、Claude Code 等 Agent 安全地控制播放。注意 TUI 和守护进程互斥二者共用同一把运行锁不能同时启动。 常见问题排错某些歌曲总时长显示00:01通常是版权问题属正常现象。特定终端无法出声先确认同一终端下mpg123能否正常播放再换终端试musicbox定位是解码器还是环境问题。查日志tail -f ~/.local/share/netease-musicbox/musicbox.log实时跟踪运行状态。想更新版本或了解改动细节可参考 CHANGELOG.md项目基于 MIT 协议开源。装好、扫码、敲下musicbox音乐就响在终端里了。【免费下载链接】musicbox网易云音乐命令行版本项目地址: https://gitcode.com/gh_mirrors/mu/musicbox创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关推荐

【Python培训】Python运行程序的三种方法分别是什么?
【Python培训】Python运行程序的三种方法分别是什么?

在中, 运行程序的方法其实还有很多种, 虽然大家刚刚开始学习的时候可能已经掌握了里面的某一些方法了, 但是为了让你们能够更好地去了解这方面的内容, 所以这一篇文章我们打算向大家介绍一下关于运行程序的三种具体的方法, 希望这样能够给大家带来一些实质性的帮助事情。关于运… · 2026/11/6 5:09:53

别再和 AI 瞎聊了:一套通用的“结构化提示词”编写框架(附模板)
别再和 AI 瞎聊了:一套通用的“结构化提示词”编写框架(附模板)

嗨, 你好。我是正雄, 想要和你一起来聊一聊关于ai行业的那些思考和想法。你是不是存在这样一种感觉: 在某些时刻人工智能表现得聪明得令人惊讶, 可是在另一些时刻人工智能又笨拙得让人觉得离谱? 针对同一个问题, 如果在今天提出并且去询问, 和如果在明天提出并且去询问, 所得到… · 2026/11/6 5:09:53

通过示例揭开 Python 类变量和实例变量的神秘面纱
通过示例揭开 Python 类变量和实例变量的神秘面纱

这个语言为面向对象编程, 也就是通常大家说的OOP这种方式, 提供了一整套非常丰富的功能。在OOP里面, 有两个特别基础的重要方面, 一个是类变量, 另一个则是实例变量。想要写出来的代码更加整洁并且运行效率也高, 那么搞清楚这两种变量的不同之处以及各自该怎么使用, 这简直就是… · 2026/11/6 5:09:53

邯郸电工证复审包过吗真实经历告诉你怎么搞定了
邯郸电工证复审包过吗真实经历告诉你怎么搞定了

邯郸电工证复审包过吗真实经历告诉你怎么搞定了 证书过期了不知道怎么复审延期,我身边就有个朋友,电工证到期后没及时处理,结果被单位暂停了工作,项目进度都耽误了。很多人觉得电工证复审就是走个流程,但其实没那么简单,尤其是像邯郸这种地方,政策收紧… · 2026/11/7 0:27:50

大专如何报考电工证 郑州报考避坑指南
大专如何报考电工证 郑州报考避坑指南

大专如何报考电工证 郑州报考避坑指南 怕考不过白交培训费?别急,今天我就来给你说说 大专如何报考电工证 ,还带你看一看 郑州报考避坑指南 ,从材料准备到考试流程,一网打尽,帮你省下冤枉钱。… · 2026/11/7 0:27:50

梅村考电工证网上查询不难,怕考不过白交培训费的看这篇
梅村考电工证网上查询不难,怕考不过白交培训费的看这篇

梅村考电工证网上查询不难,怕考不过白交培训费的看这篇 你是不是正在为梅村考电工证的事发愁?怕花了几千块培训费,结果考试一塌糊涂,钱打水漂?别急,这篇文章就是专门为你准备的,讲清楚梅村电工证怎么考、怎么查、怎么不踩坑。… · 2026/11/7 0:27:49

保山专业的电工证怎么考 郑州报考避坑指南
保山专业的电工证怎么考 郑州报考避坑指南

保山专业的电工证怎么考 郑州报考避坑指南 你是不是正在找保山专业的电工证,却又担心被中介坑?别急,这波经验都是老电工亲测的干货,直接抄作业就行。下面从报名、考试、复审、继续教育全流程,给你说清楚,保山本地的电工证怎么考才不踩坑。… · 2026/11/7 0:27:49

电子低压电工证查询,考前押题怎么用?电工找工作别慌
电子低压电工证查询,考前押题怎么用?电工找工作别慌

电子低压电工证查询,考前押题怎么用?电工找工作别慌 现在找工作, 急需特种作业证才能上岗 ,尤其是低压电工证,几乎是电工行业的“入场券”。很多刚入行的电工朋友都遇到过一个问题:电子低压电工证查询流程复杂,考试不通过、复审过期怎么办?今天就从… · 2026/11/7 0:27:49

隆回电工证培训机构排名2026河南最新政策下怎么选
隆回电工证培训机构排名2026河南最新政策下怎么选

隆回电工证培训机构排名2026河南最新政策下怎么选 工地太忙根本没时间复习考试,这是很多电工从业者的真实写照。2026年河南最新政策对特种作业证的报考、考试、复审提出了更严格的要求,尤其是像低压电工证、高压电工证这些证书,不仅关系到个人职业… · 2026/11/7 0:26:49

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/5 10:27:59

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/5 10:28:03

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/6 10:29:23

澳洲水电工证考试:证书过期了不知道怎么复审延期?电子证书怎么弄?
澳洲水电工证考试:证书过期了不知道怎么复审延期?电子证书怎么弄?

澳洲水电工证考试:证书过期了不知道怎么复审延期?电子证书怎么弄? 证书过期了不知道怎么复审延期?别慌,很多人在拿到【澳洲水电工证考试】的电子证书后,一不小心就忽略了复审时间,结果证书失效,工作受阻,甚至被单位追责。今天就从【澳洲水电工证考试… · 2026/11/7 0:00:41

电工作业提示版通过率揭秘:怎么考才能一次过?
电工作业提示版通过率揭秘:怎么考才能一次过?

电工作业提示版通过率揭秘:怎么考才能一次过? 怕考不过白交培训费?别急,今天我就从驻马店应届工程类毕业生的视角,带你全面了解电工作业提示版的考试流程、备考要点和真实通过率,帮你少走弯路、提高一次通过率。… · 2026/11/7 0:00:41

电工证年审报名千万别踩坑 外省证转过来要搞清这几点
电工证年审报名千万别踩坑 外省证转过来要搞清这几点

电工证年审报名千万别踩坑 外省证转过来要搞清这几点 之前考的证在外省能不能转过来?这个问题是很多电工从业者最关心的,特别是像你这样在商丘从事公路工程的人员,经常需要跨省流动,证书的 有效性 和 可迁移性… · 2026/11/7 0:00:41

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/5 10:27:59

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/5 10:28:03

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/6 10:29:23

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码