Mopidy-Bandcamp
.. image:: https://img.shields.io/pypi/v/Mopidy-Bandcamp?logo=PyPI :target: https://pypi.org/project/Mopidy-Bandcamp :alt: Latest PyPI version
.. image:: https://img.shields.io/github/v/release/impliedchaos/mopidy-bandcamp?logo=GitHub :target: https://github.com/impliedchaos/mopidy-bandcamp/releases :alt: Latest GitHub release
.. image:: https://img.shields.io/github/commits-since/impliedchaos/mopidy-bandcamp/latest?logo=GitHub :target: https://github.com/impliedchaos/mopidy-bandcamp/commits/master :alt: Latest GitHub Commits
.. image:: https://img.shields.io/github/actions/workflow/status/impliedchaos/mopidy-bandcamp/CI.yml?logo=GitHub&label=CI%20build :target: https://github.com/impliedchaos/mopidy-bandcamp/actions :alt: CI build status
.. image:: https://img.shields.io/codecov/c/github/impliedchaos/mopidy-bandcamp?logo=Codecov&label=Test%20coverage :target: https://app.codecov.io/gh/impliedchaos/mopidy-bandcamp/ :alt: Code Coverage
.. image:: https://img.shields.io/badge/PRs-welcome-brightgreen :target: https://makeapullrequest.com/ :alt: Pull Requests Welcome
Mopidy <http://www.mopidy.com/>_ 用于播放来自
Bandcamp <http://bandcamp.com/>_ 的音乐。
此后端允许搜索 bandcamp 并播放免费的 128kbps MP3 流媒体。
自 v1.1.0 起,已添加对浏览和播放您的 bandcamp 收藏的初步支持。 身份验证过程较为繁琐,具体说明如下。 请预期功能可能存在不稳定之处, 并在遇到无法正常工作的问题时创建 issue。 此外,由于需要抓取 bandcamp 网站而非使用 API,因此速度较慢。 (此插件将尝试播放您收藏中歌曲的较高质量 mp3-v0 流。)
安装
通过运行以下命令进行安装::
sudo python3 -m pip install Mopidy-Bandcamp
身份验证
如果您希望浏览/播放收藏中的音乐,则需要对 bandcamp.com 进行身份验证。
身份验证是通过从 bandcamp 网站的 cookies 中获取您的 :code:identity token 来完成的。 将浏览器指向 https://bandcamp.com,如果尚未登录,请登录。
对于 chrome,您可以直接访问
chrome://settings/cookies/detail?site=bandcamp.com <chrome://settings/cookies/detail?site=bandcamp.com>_
查看 bandcamp.com 的 cookies。 点击 "identity" 并复制 "Content" 下列出的数据。
对于 Firefox 和大多数其他浏览器,打开浏览器的开发者工具(通常通过按 Ctrl-Shift-I 或 F12)。 当工具弹出时,导航到 "Storage" 选项卡,然后选择 "Cookies" 以查看 该网站的 cookies。 复制 "identity" cookie 的值。
它应该看起来像这样:
.. code::
7%09xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx%3D%09%7B%22ex%22%3Ax%2C%22id%22%3Axxxxxxxxxx%7D
现在将其添加到您的 Mopidy 配置文件中,如下所示:
.. code::
[bandcamp] identity = 7%09xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx%3D%09%7B%22ex%22%3Ax%2C%22id%22%3Axxxxxxxxxx%7D
Usage
可以搜索或浏览专辑和曲目。 此外,你可以通过在 URL 前添加 "bandcamp:" 并将其添加到 Mopidy 中,强制 Mopidy-Bandcamp 为你抓取 bandcamp URL。 例如, 在命令行上使用 mpc:
.. code:: shell
$ mpc add "bandcamp:https://louiezong.bandcamp.com/album/jazz"
会将该 bandcamp 专辑添加到队列中。
注意:通过点击搜索结果中的艺术家或手动抓取艺术家的 bandcamp 页面来添加艺术家,可能会花费很长时间,具体取决于该艺术家。这是因为 Mopidy-Bandcamp 会尝试加载 该艺术家的完整唱片目录。
Mopidy-Bandcamp 还支持 bndcmpr.co 播放列表。只需从 bndcmpr 网址中获取播放列表 ID,在前面加上 "bandcamp:bndcmpr",然后将其添加到 Mopidy 中。例如,要在命令行中使用 mpc 添加此 bndcmpr 播放列表 "https://bndcmpr.co/4dfdd589":
.. code:: shell
$ mpc add "bandcamp:bndcmpr:4dfdd589"
会将 bndcmpr 播放列表中的所有曲目添加到队列中。
Web Client
自 v1.1.2 起,已添加一个简单的 webclient,以便更轻松地抓取页面。无需访问 http://hostname:6680/bandcamp/ 并输入一个 url(虽然你可以这样做),而是将以下 作为书签的 URL 添加到你的 web 浏览器中:
.. code::
注意:请将 hostname 和 6680 替换为您的 mopidy 服务器的主机名和配置的 HTTP 端口。
现在,当您在浏览 bandcamp(或 bndcmpr 播放列表)时,只需点击该书签即可将 当前页面添加到 Mopidy。 (这在 Chrome 和 Firefox 中有效。 我懒得检查其他浏览器。)
配置
示例:
.. code::
[bandcamp] discover-tags = French House, Brit Pop, Tokyo, New Wave, Industrial
- :code:
identity- 用于与 Bandcamp 进行身份验证的来自您的 bandcamp cookies 的身份令牌。 - :code:
collection_items- 从您的收藏中获取的项目数量(每页)(如果已认证)。 默认值:50 - :code:
discover_tags- 要发现的标签列表。您真的应该将其更改为您感兴趣的任何标签。 - :code:
discover_genres- 要发现的 bandcamp 流派列表。 您只想编辑此列表以移除不需要的流派。 - :code:
discover_pages- 在浏览发现部分中加载的页面数量。 默认值:1 - :code:
image_sizes- 返回给 mopidy 用于专辑封面的图像尺寸 ID 列表。 默认值:10, 5, 2 (1200x1200, 700x700, 350x350)
Bandcamp 图像尺寸 ID:
+----+-------+--------+--------+ | ID | 宽度 | 高度 | 宽高比 | +====+=======+========+========+ | 1 | 原始(通常较大) | +----+-------+--------+--------+ | 10 | 1200 | 1200 | 正方形 | +----+-------+--------+--------+ | 20 | 1024 | 1024 | 正方形 | +----+-------+--------+--------+ | 5 | 700 | 700 | 正方形 | +----+-------+--------+--------+ | 13 | 380 | 380 | 正方形 | +----+-------+--------+--------+ | 14 | 368 | 368 | 正方形 | +----+-------+--------+--------+ | 2 | 350 | 350 | 正方形 | +----+-------+--------+--------+ | 4 | 300 | 300 | 正方形 | +----+-------+--------+--------+ | 9 | 210 | 210 | 正方形 | +----+-------+--------+--------+ | 44 | 200 | 200 | 正方形 | +----+-------+--------+--------+ | 11 | 172 | 172 | 正方形 | +----+-------+--------+--------+ | 7 | 150 | 150 | 正方形 | +----+-------+--------+--------+ | 50 | 140 | 140 | 正方形 | +----+-------+--------+--------+ | 12 | 138 | 138 | 正方形 | +----+-------+--------+--------+ | 15 | 135 | 135 | 正方形 | +----+-------+--------+--------+ | 8 | 124 | 124 | 正方形 | +----+-------+--------+--------+ | 21 | 120 | 120 | 正方形 | +----+-------+--------+--------+ | 3 | 100 | 100 | 正方形 | +----+-------+--------+--------+ | 42 | 50 | 50 | 正方形 | +----+-------+--------+--------+ | 22 | 25 | 25 | 正方形 | +----+-------+--------+--------+ | 26 | 800 | 600 | 4:3 | +----+-------+--------+--------+ | 36 | 400 | 300 | 4:3 | +----+-------+--------+--------+ | 32 | 380 | 285 | 4:3 | +----+-------+--------+--------+ | 33 | 368 | 276 | 4:3 | +----+-------+--------+--------+ | 37 | 168 | 126 | 4:3 | +----+-------+--------+--------+ | 38 | 144 | 108 | 4:3 | +----+-------+--------+--------+ | 29 | 100 | 75 | 4:3 | +----+-------+--------+--------+ | 28 | 768 | 432 | 16:9 | +----+-------+--------+--------+ | 27 | 715 | 402 | 16:9 | +----+-------+--------+--------+
项目资源
Source code <https://github.com/impliedchaos/mopidy-bandcamp>_Issue tracker <https://github.com/impliedchaos/mopidy-bandcamp/issues>_