A simple ListenBrainz client library for Python
pylistenbrainz is a simple Python library for the ListenBrainz Web API.
pylistenbrainz will help you start getting data from and submitting data to ListenBrainz very quickly.
Here's an example of getting the listening history of a ListenBrainz user::
import pylistenbrainz client = pylistenbrainz.ListenBrainz() listens = client.get_listens(username='iliekcomputers') for listen in listens: print("Track name:", listen.track_name) print("Artist name:", listen.artist_name)
Here's another quick example of how to submit a listen to ListenBrainz::
import pylistenbrainz import time auth_token = input('Please enter your auth token: ') listen = pylistenbrainz.Listen( track_name="Fade", artist_name="Kanye West", release_name="The Life of Pablo", listened_at=int(time.time()), ) client = pylistenbrainz.ListenBrainz() client.set_auth_token(auth_token) response = client.submit_single_listen(listen)
More detailed documentation is available at Read The Docs.
pylistenbrainz provides easy access to all ListenBrainz endpoints, handles ratelimits automatically and supports the ListenBrainz authorization flow.
For details on the API endpoints that can be used via pylistenbrainz, take a look at the ListenBrainz API Documentation.
Install or upgrade pylistenbrainz with:
pip install pylistenbrainz --upgrade
You can ask questions about how to use pylistenbrainz on IRC (freenode #metabrainz).
You can also email me at
iliekcomputers [at] gmail [dot] com.
If you have found a bug or have a feature request, let me know by opening an issue (or a pull request).
pylistenbrainz - A simple client library for ListenBrainz Copyright (C) 2020 Param Singh <firstname.lastname@example.org> This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size pylistenbrainz-0.4.0-py3-none-any.whl (28.7 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size pylistenbrainz-0.4.0.tar.gz (11.1 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for pylistenbrainz-0.4.0-py3-none-any.whl