listen1_chrome_extension README

The project's README from github.com/listen1/listen1_chrome_extension. As one markdown file: README.md.

Listen 1 (Chrome Extension) V2.33.0

(最后更新于 2025 年 6 月 17 日)

Software License

English Version

缘起

当我发现找个想听的歌因为版权听不了,需要打开好几个网站开始搜索,来回切换让我抓狂的时候,我知道是时候该做点什么了。

妈妈再也不用担心我找不到我想听的歌了。

支持音乐平台

搜歌,听歌,就用 Listen1。

imgur

V2.9.0 新特性:自动切换播放源(Beta)

当一首歌的播放源不可用时,会自动搜索其他平台,获得可用的播放源。避免了用户手动搜索的麻烦。

还有精选歌单哦。

官方商店安装(推荐)

按你的浏览器类型点击下面的链接安装

感谢 @TNT-c 维护 Firefox 的发布渠道

感谢 @dhxh 维护 Microsoft Edge 的发布渠道

Chrome 下载安装

  1. 下载项目的 zip 文件,在右上方有个 Download ZIP, 解压到本地

  2. chrome 右上角的设置按钮下找到更多工具,打开扩展程序

  3. 选择 加载已解压的扩展程序(如果没有显示先选中开发者模式),选中解压后的文件夹,完成!

Firefox 打包安装

  1. 将根目录下 manifest_firefox.json 替换 manifest.json

  2. cd listen1_chrome_extension

  3. zip -r ../listen1.xpi *, 完成打包 xpi 文件

  4. 打开 Firefox,加载 xpi 文件,完成安装

QQ 音乐举报 Listen1 导致代码库临时关闭事件 (2017 年 11 月)

Listen1 的用户,有个坏消息希望和大家分享。Listen1 最近收到了QQ 音乐的 DMCA Takedown Notice, 主要代码库已经因为此原因而临时关闭。悲观一点看,Listen1 项目可能会在今年内彻底消失。

Listen1 诞生的初衷从不是和大公司的争夺版权利益,而是为了给予热爱音乐的人更好的收听体验,所以,Listen1 是开源,免费的,并且不接受任何形式的捐助。正是因为有热爱音乐的 Listen1 的你们,Listen1 才发展到今天这一步。不管结果如何,Listen1 团队感谢所有支持过这个项目的人们。

在这个关系项目生死存亡的时刻,我寻求项目因为 DMCA 被 github 关闭的援助。如果有对这个比较了解如何解决的人,或者你想对这个事情发表看法和建议,可以在issue留言,或者发送邮件到 [email protected]。我们会尽最大努力,来守护 Listen1,即使可能它即将成为历史。

更新日志

2025-06

修复:

功能改进:

2023-08 ~ 2024-04

修复:

2023-07

修复:

2022-12 ~ 2023-03

功能改进:

修复:

2022-11

功能改进:

修复:

2022-09

功能改进

修复:

2022-08

修复:

2022-07

功能改进:

修复:

2022-06

功能改进

2022-02 ~ 2022-03

功能改进:

修复:

2021-08 ~ 2022-01

修复:

优化:

2021-07

修复:

2021-04

功能改进:

重构和优化:

修复:

2021-03

功能改进:

重构和优化:

修复:

2021-02

功能改进:

重构:

修复:

2021-01

功能改进:

重构:

bug 修复:

2020-12-28

2020-12-27

2020-12-22

2020-12-20

2020-12-12

2020-10-28

2020-10-27

2020-10-26

2020-10-18

2020-09-12

2020-08-24

2020-08-04

2020-07-10

2020-06-29

2020-06-28

2020-04-30

2020-04-27

2019-11-27

2019-09-07

2019-08-09

2019-07-03

2019-06-24

2019-06-23

2019-05-26

2019-04-26

2019-03-03

2019-02-26

2018-12-30

2018-12-29

2018-12-24

2018-12-22

2018-12-21

2018-12-05

2018-08-25

2018-06-15

2018-06-10

2018-06-10

2018-06-05

2018-05-30

2018-04-23

2018-02-18

2018-02-15

2018-02-14

2017-12-26

2017-12-20

2017-11-27

2017-11-18

2017-11-17

2017-10-16

2017-10-03

2017-09-14

2016-05-27

2016-05-21

2016-05-14

2016-05-13

2016-05-08

2016-05-02

License

MIT

listen1_chrome_extension (listen1/listen1_chrome_extension)

Searching Database…

What is this?Listen 1 is a browser extension that pulls free music streams from major Chinese platforms (NetEase Cloud Music, QQ Music, Kugou, Kuwo, Bilibili, Migu, Qianqian) into one unified player, so you do not have to jump between sites looking for a copy of a song that is not blocked.
Is this just a Chrome add-on, or is there more to it?It is primarily a browser extension for Chrome, Firefox and Edge, but the project also ships an Electron-based desktop build for Windows and Mac that adds local file playback and desktop-only features.
Do I need anything besides a browser to run it?No, just Chrome, Firefox, or Edge; the only extra step is for a manual Firefox build, where you swap in manifestfirefox.json and zip the folder into an .xpi yourself.
Does every song actually play?No, playback still depends on each platform's copyright licensing, so some tracks are blocked; the project even survived a 2017 DMCA takedown notice from QQ Music that temporarily shut down its main repo. An experimental auto-source-switching feature tries other platforms when a track fails.
What happens if a song's source stops working?An automatic source-switching feature (introduced as a Beta in v2.9.0) searches other supported platforms for a playable copy instead of making you search manually.
Can I back up or sync my playlists?Yes, there is a built-in feature to sync your playlists to a GitHub Gist, added in late 2017, so you can restore them on another install.
Does it show song lyrics?Yes, it displays lyrics (with translation for platforms like NetEase and QQ Music), and the desktop build also supports loading local .lrc lyric files.
Can I play my own local music files?Yes, but only in the desktop (Electron) build, which supports importing local files including FLAC and WAV formats.
Creator
listen1
Size
4.9 MB
Stars
12.1K
Age
10y
Commits · 90 Days