Server for the ListenBrainz project
The ListenBrainz project is similar to the original AudioScrobbler®. Unlike the original project, ListenBrainz is open source and publishes its data as open data.
A team of former Last.fm and current MusicBrainz hackers created the first version of ListenBrainz in a weekend. Since the original project was created, technology has advanced at an incredibly rapid pace, which made re-creating the original project fairly straightforward.
The project has two main goals:
- Allow users to preserve their existing Last.fm® data
- Make this incredibly useful music usage data available to the world
These instructions help you get started with the development process. Installation in a production environment may be different.
ListenBrainz uses Google BigQuery to calculate statistics. You need a
BigQuery credentials file called
bigquery-credentials.json to the
credentials directory for it to work. This file is obtained from the Google
BigQuery site by creating a new project. The
WRITE_TO_BIGQUERY variable in
config.py needs to be set to
The stats are automatically calculated in the
scheduler container, but if you
want to manually start statistic calculation, run this.
docker-compose -f docker/docker-compose.yml -p listenbrainz run --rm web python manage.py stats calculate
Full documentation for the ListenBrainz API is available at listenbrainz.readthedocs.org. You can also build the documentation locally:
cd listenbrainz-server/docs make clean html
listenbrainz-server - Server for the ListenBrainz project Copyright (C) 2017 MetaBrainz Foundation Inc. 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 2 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, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA