Listen1：聚合七大平台免费音乐的浏览器插件，一篇上手指南

【免费下载链接】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、咪咕音乐、千千音乐等七大平台的免费音乐聚合到一个页面里，解决歌曲被版权分散在多个平台、需要来回切换 App 的问题。

它是什么：一个跨平台的音乐搜索与播放页

Listen1 的定位是"一个页面，全网免费音乐"。它通过各平台的网页接口检索歌曲并直接播放，歌单数据存在浏览器本地，不依赖自建服务器。对新手来说，可以理解为一个装在浏览器里的"音乐搜索框 + 播放器"。

适合谁

• 跨平台听歌的普通用户：想听的歌在某个平台听不了，安装后可以在同一界面直接切到别的平台继续听，不用反复打开新网页。
• 歌单分散在各处的用户：在网易云收藏过歌单、又在 bilibili 存过播放列表的用户，可以把它们导入到 Listen1 的"我的歌单"里统一管理、合并。
• 学生与上班族：需要长时间挂着背景音乐，用它搜索并整单播放，配合播放模式切换（顺序/随机/单曲循环）减少操作。

快速上手：安装与首次运行

Chrome / Edge 安装（解压加载）

1. 下载或克隆项目，地址：git clone https://gitcode.com/gh_mirrors/li/listen1_chrome_extension，得到listen1_chrome_extension文件夹。
2. 打开浏览器扩展管理页（Edge 输入edge://extensions/，Chrome 输入chrome://extensions/）。
3. 打开右上角"开发者模式"。
4. 点击"加载已解压的扩展程序"，选中该文件夹，安装完成。

Firefox 安装（打包 xpi）

1. 用根目录的manifest_firefox.json替换manifest.json。
2. 在项目目录执行打包命令：zip -r ../listen1.xpi *。
3. 在 Firefox 中通过"临时添加附加组件"加载生成的listen1.xpi。

首次运行

点击工具栏的 Listen1 图标，会打开一个独立的播放页面：顶部是搜索框，左侧可切换音乐平台，底部是播放器和播放列表。输入歌曲名回车，即可看到各平台的搜索结果；点击任意一首即开始播放。

功能详解：找歌 → 播放 → 管理歌单

找歌。搜索页支持按平台筛选或"平台聚合"一次搜全部，并提供翻页；"精选歌单"页展示各平台推荐歌单，点击即可加入当前播放列表或跳转原站。部分平台支持歌单搜索，可直接按歌单名查找。

播放。当前播放源因版权等原因不可用时，"自动切换播放源"功能会去其他平台检索同名歌曲并继续播放，免去手动重搜。播放页支持切换顺序、随机、单曲循环三种模式，可调整音量；部分平台提供多档码率可选。桌面版还支持导入本地音乐（含 flac、wav 及本地 lrc 歌词文件）。

管理歌单。"我的歌单"里可新建歌单、收藏已有歌单、从各平台链接导入歌单，也能把一个歌单合并进另一个。歌单内支持按歌曲搜索、拖动调整歌曲与歌单顺序；整单数据可导出，并可通过 GitHub Gist 同步到云端，在另一台电脑登录同一账号即可还原。

进阶与技巧

快捷键一览表（在 Listen1 页面内有效，按?可查看完整列表）：

常用个性化设置：

多语言支持：界面提供简体中文、繁体中文、英文、法文、韩文、葡萄牙文（巴西）六种语言，语言文件位于 i18n/，一般跟随浏览器语言自动匹配。

常见问题

Q：Listen1 收费吗？A：开源项目（MIT 许可），完全免费，无付费功能，也不接受捐赠。

Q：需要注册账号吗？A：不需要。基础搜索和播放开箱即用；仅"同步歌单到 Gist""登录网易云看个人歌单"等功能需要你自行登录相应平台账号。

Q：支持哪些系统和浏览器？A：支持 Windows、macOS、Linux，浏览器方面支持 Chrome、Edge（Chromium 系）和 Firefox，桌面版基于 Electron。

Q：某首歌一直无法播放怎么办？A：先开启"自动切换播放源"；或手动换一个平台再搜一次。多数情况是版权限制，换平台即可解决。仍不行时清除浏览器缓存或更新到最新版本。

Q：歌单数据存在哪里？A：默认存在浏览器本地存储，重装或换设备会丢失；建议用 Gist 同步或导出功能做备份。

架构速览

• 纯前端实现：无自建服务端，主体是一个基于 HTML/CSS/原生 JavaScript 的单页应用，扩展壳采用 Manifest V3，manifest.json 中声明了后台 service worker 与各平台 host 权限。
• 平台层：js/provider/ 下每个平台一个文件（netease、qq、kugou、kuwo、bilibili、migu、taihe 等），统一封装搜索、歌单、播放链接获取接口。
• 控制层：js/controller/ 按职责拆分播放、搜索、歌单、平台切换等逻辑，便于维护。
• 国际化：i18n/ 存放各语言文案，配合 i18next 运行。

参与项目

• 代码贡献：阅读对应平台的 provider 文件，提交 PR 修复播放/搜索问题或新增功能。
• 翻译贡献：修改i18n/下对应语言文件并校对，欢迎补充新语言。
• 问题反馈：把平台接口失效、播放异常等问题整理成 issue 提交，标注平台和复现步骤即可。

Listen1 用一个页面抹平了七大平台的版权边界，搜索、播放、歌单管理都在同一界面完成。现在按上文把扩展加载进浏览器，搜一首你想听的歌试试。

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