Listen1 从安装到进阶：音乐聚合扩展的 4 个实用场景

【免费下载链接】listen1_chrome_extensionone for all free music in china (chrome extension, also works for firefox)项目地址: https://gitcode.com/gh_mirrors/li/listen1_chrome_extension

在网易云音乐里一首歌提示“因版权限制无法播放”时，不用挨个打开各平台官网，而是打开 Listen1 浏览器扩展，在顶部搜索框输入歌名回车，网易云、QQ 音乐、bilibili 等七个平台的结果会出现在同一个列表里。

Listen1 是一个开源浏览器扩展（Chrome/Firefox/Edge），一次搜索同时查七个国内音乐平台，播放源不可用时自动切换到其他平台。它解决的是“曲库分散在各平台、版权卡住一首歌”的问题，适合在多个平台之间来回找歌、想把歌单集中管理的人。

🔧 装完先做这一步：按浏览器选对安装方式

商店方式（推荐）

• Chrome/Edge：在对应商店搜索 “Listen 1”，点击添加即完成
• Firefox：在附加组件商店搜索 “Listen1” 安装

手动方式（需要改源码或商店不可达时）

1. 获取源码：git clone https://gitcode.com/gh_mirrors/li/listen1_chrome_extension
2. Chrome/Edge：打开扩展管理页（chrome://extensions/），开启“开发者模式”，点“加载已解压的扩展程序”，选择解压后的项目根目录（含manifest.json的那一层），装完点工具栏图标打开界面
3. Firefox：用根目录的manifest_firefox.json替换manifest.json，再执行zip -r ../listen1.xpi *打包，在 Firefox 里加载这个 xpi 文件

装完先做一件事：点右上角设置图标，选一个主题（现代白/现代黑）并确认界面语言；想看到“我的歌单”和推荐内容，再去登录网易云、QQ 音乐等平台账号。搜索框里能查到哪些平台，取决于 js/provider/ 下各平台模块的注册情况，七个平台各对应一个独立文件。

日常会用的 4 件事

一次搜索七个平台，版权情况直接可见

在顶部搜索框输入歌名或歌手，回车后各平台结果并列返回，双击某一行即可播放。可感知的效果是：一首歌在哪个平台能听、哪边有版权限制，看列表就知道，不用再逐个网站试探。搜不到时换个关键词（加歌手名、改拼音写法）通常比换平台有效。

播放源挂掉时自动换

自动切换播放源是 V2.9.0 加入的功能：当前播放源不可用时，它会去其他平台检索可用的播放地址，省掉手动搜索。你可以在设置里配置参与自动换源搜索的平台范围；不想等自动换的话，也可以直接在搜索框指定某个平台，只在该平台内检索。

一个歌单收多个平台的歌，再同步到 Gist

“我的歌单”里可以新建歌单，把不同平台的歌曲拖进同一个歌单，支持拖拽调整顺序和歌单内搜索。担心歌单丢失的话，在设置里绑定 GitHub 账号，歌单会同步为一个私有 Gist，实现见 js/github.js：它把歌单数据写成listen1_backup.json，换电脑后重新授权、按 Gist 导入即可恢复，不需要手动导文件。

⌨️ 不碰鼠标听歌

内置快捷键覆盖了高频操作：p播放/暂停，[和]上一首/下一首，u/d音量加减，m静音，l显示/隐藏播放列表，s在顺序/随机/单曲循环间切换，f聚焦搜索框。在界面里按?可以看到全部快捷键说明。

进阶：三个值得知道的事

• 后台播放：Chrome 版已升级为 Manifest V3，背景逻辑跑在 Service Worker 里（见 manifest.json 的service_worker字段），切换标签页、最小化窗口时播放不中断；Chrome 的媒体控制里也能拖动进度、切歌。
• 音质：接口支持选择播放码率，QQ 音乐最高到 320kbps（2023 年加入）。如果某首歌码率偏低，先确认是不是平台源本身限制，再怀疑插件。
• 歌词翻译与封面背景：“正在播放”页有歌词翻译开关，还可以把歌曲封面设为播放页背景，听外语歌时比较实用。

⚠️ 避坑：3 个高频问题

Q：某首歌提示版权无法播放，怎么办？先在设置里开启“自动切换播放源”，给它一次换源机会；再确认其他平台是否真有这首歌（部分歌曲确实全线无源）。同时检查广告拦截扩展有没有拦到音乐域名——插件声明的host_permissions列表就在manifest.json里，被拦截会导致播放地址请求失败。

Q：Chrome 加载已解压扩展后，图标不出现或页面打不开？十有八九是选错了目录：需要选择包含manifest.json的项目根目录，不是它的上级目录。另外确认浏览器版本足够新、能支持 Manifest V3，过老的 Chromium 内核装完可能页面空白。

Q：Firefox 版更新后不能用了？Firefox 走的是 Manifest V2 渠道（manifest_firefox.json），和 Chrome 版的 V3 升级不同步。项目更新后手动安装的用户需要重新下载源码、替换 manifest 再打包 xpi；从商店安装的用户等商店推送即可。

Listen1 免费且开源（MIT 协议），核心就两条：一次搜索覆盖七个平台、歌单经 Gist 跟着你走。如果你也在用，欢迎给项目点个 Star，或者照着js/provider/的模块结构提你的第一个 PR。

【免费下载链接】listen1_chrome_extensionone for all free music in china (chrome extension, also works for firefox)项目地址: https://gitcode.com/gh_mirrors/li/listen1_chrome_extension