ListenBrainz Logo

API Documentation

  • ListenBrainz API
    • Reference
      • Core
      • Playlists
      • Recordings
      • Statistics
      • Metadata
      • Social
      • Recommendations
      • Art
      • Miscellaneous
    • Rate limiting
  • Usage Examples
    • Prerequisites
    • Examples
      • Submitting Listens
      • Getting Listen History
      • Lookup MBIDs
      • Love/hate feedback
      • Latest Import
  • JSON Documentation
    • Submission JSON
    • Fetching listen JSON
    • Payload JSON details
    • Client Metadata examples
      • BrainzPlayer on the ListenBrainz website playing a video from YouTube
      • BrainzPlayer on the ListenBrainz website playing a video from Spotify
      • Using Otter for Funkwhale on android, and submitting with Simple Scrobbler
      • Rhythmbox player listening to Jamendo
      • Listening to a recording from Bandcamp and submitting with the browser extension WebScrobbler
  • Client Libraries
    • Haskell
    • Go
    • Rust
    • .NET
    • Python
    • Java
  • Last.FM Compatible API for ListenBrainz
    • AudioScrobbler API v1.2
    • Last.FM API
      • For development
      • For users
  • Data Dumps
    • Dump mirrors
    • File Descriptions
      • listenbrainz-public-dump.tar.xz
      • listenbrainz-listens-dump.tar.xz
      • listenbrainz-listens-dump-spark.tar.xz
    • Structure of the listens dump
    • Incremental dumps (BETA)

Developer Documentation

  • Server development
    • Set up ListenBrainz Server development environment
    • Clone listenbrainz-server
    • Install docker
    • Register a MusicBrainz application
      • Update config.py
    • Initialize ListenBrainz containers
    • Initialize ListenBrainz databases
    • Run the magic script
    • Listenbrainz containers
    • Test your changes with unit tests
    • Lint your code
    • Using develop.sh
  • Spark development
    • Set up the webserver
      • Create listenbrainz_spark/config.py
    • Initialize ListenBrainz Spark containers
    • Bring containers up
    • Import data into the spark environment
    • Working with request_consumer
    • Test your changes with unit tests
  • Architecture
    • Services
    • Listen Flow
    • Frontend Rendering
  • Spark Architecture
    • Developing request_consumer
      • Start the webserver
      • Start the spark containers
      • Start the spark reader
  • MBID Mapping
    • Database tables
    • Fuzzy lookups
    • MBID Mapper
  • Scripts
    • ListenBrainz
      • ./develop.sh manage
    • Dump Manager
      • ./develop.sh manage dump
    • ListenBrainz Spark
      • python spark_manage.py
      • ./develop.sh manage spark

Maintainer Documentation

  • Production Deployment
    • Cron
  • Building Docker Images
    • Production Images
    • Test Images
    • Using Github Actions
    • Using docker/push.sh script
  • Data Dumps
    • Check FTP Dumps age script
    • Logs
    • Manually triggering dumps
  • MBID Mapping
    • Containers
    • Data sources
    • Debugging lookups
  • Debugging Spotify Reader
  • Updating Production Database Schema
  • Pull Requests Policy
ListenBrainz
  • »
  • Search

© Copyright 2017-2018, MetaBrainz Foundation. Revision 3527273f.

Built with Sphinx using a theme provided by Read the Docs.
Read the Docs v: latest
Versions
latest
stable
production
Downloads
pdf
html
epub
On Read the Docs
Project Home
Builds