跳转到主要内容

一个简单的客户端库,用于向ListenBrainz服务器提交收听

项目描述

Python模块,用于将收听提交到ListenBrainz服务

一个简单的Python模块,用于将收听提交到ListenBrainz服务器。

支持提交单个收听、正在播放通知和导入多个收听。自动遵守ListenBrainz服务器的速率限制。

使用方法

import time
from listenbrainz_submit import ListenBrainzClient, Track


# The user's personal ListenBrainz token obtained from https://listenbrainz.org/profile/
user_token = "..."
client = ListenBrainzClient(user_token=user_token)

# Prepare a track to submit
track = Track(
    artist_name="Dool",
    track_name="Vantablack",
    release_name="Here Now, There Then",
    additional_info={
        "listening_from": "My great music player",
        "recording_mbid": "e225fb84-dc9a-419e-adcd-9890f59ec432",
        "release_mbid": "aa1ea1ac-7ec4-4542-a494-105afbfe547d",
        "artist_mbids": "24412926-c7bd-48e8-afad-8a285b42e131",
        "tracknumber": 1,
    }
)

# Inform ListenBrainz that this track is playing right now. ListenBrainz
# will display this track on the user's listens page as being currently played.
client.playing_now(track)

要实际提交一个已收听的曲目,请调用

# Submit the listen with a current timestamp
client.listen(int(time.time()), track)

有关API使用的详细信息,请参阅ListenBrainz API文档,特别是Payload JSON细节,它描述了可以提交的元数据。

许可协议

listenbrainz-submit © 2018-2023 Philipp Wolfer ph.wolfer@gmail.com

在MIT许可协议下发布,有关详细信息请参阅LICENSE。

项目细节


下载文件

下载适用于您的平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

listenbrainz_submit-1.0.1.tar.gz (4.7 kB 查看散列)

上传于

构建的发行版

listenbrainz_submit-1.0.1-py3-none-any.whl (5.7 kB 查看哈希值)

上传于 Python 3

由以下支持