Skip to content

Discourse plugin to add Onebox support for MusicBrainz.org.

License

Notifications You must be signed in to change notification settings

phw/discourse-musicbrainz-onebox

Repository files navigation

Discourse MusicBrainz Onebox plugin

This plugin adds Onebox support for MusicBrainz.org to Discourse. Use it to quickly display information about artists, releases, labels and more.

This plugin is primarily used in the MetaBrainz Community forums. See this forum post for some examples of oneboxes provided by this plugin.

Supported entities

  • Artists
  • Release Groups
  • Releases
  • Works
  • Recordings
  • Labels
  • Places
  • Events
  • Series
  • Instruments
  • Areas
  • DiscIDs
  • Public collections

Installation

Please follow this official plugin installation how-to. Use https://github.com/phw/discourse-musicbrainz-onebox.git as the git clone URL.

Settings

You can configure the MusicBrainz oneboxes in the Discourse admin interface. The following options are available:

musicbrainz enabled: Enable MusicBrainz Oneboxes. Default: enabled.

musicbrainz load caa images: Enable, to load images for releases and release groups from Cover Art Archive. Default: enabled.

musicbrainz load wikimedia images: Enable, to load images from Wikimedia Commons. This requires the MusicBrainz entity to either have a link to an image on Wikimedia or have a Wikidata entry. Default: enabled.

musicbrainz load other images: Enable, to load images from other sources. This requires the MusicBrainz entity to link to an external image with a URL relationship. This is currently mainly used by label logos and for some instruments. Default: enabled.

musicbrainz show wikipedia link: Show a link to the item's Wikipedia page. This requires the MusicBrainz entity to be linked to Wikidata. Default: enabled.

musicbrainz genre limit: If a onebox shows the genres associated with the linked MusicBrainz entity, this setting limits the number of genres shown. Default: 5.

License

Discourse MusicBrainz Onebox plugin © 2016-2023 Philipp Wolfer ph.wolfer@gmail.com

Published under the MIT license, see LICENSE.txt for details.