ITADN
impliedchaos/mopidy-bandcamp
impliedchaos/mopidy-bandcamp · 文件 下载 ZIP
文件最后提交记录最后更新时间
README.md
以下内容由 AI 翻译,如有问题请点此提交 issue 反馈

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::

javascript:s='http://hostname:6680/bandcamp/';f=document.createElement('form');f.action=s;i=document.createElement('input');i.type='hidden';i.name='url';i.value=window.location.href;f.appendChild(i);document.body.appendChild(f);f.submit();

注意:请将 hostname6680 替换为您的 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>_