funkwhale/docs/user/plugins/listenbrainz.md

3.5 KiB

ListenBrainz plugin

The ListenBrainz plugin enables you to submit ({term}scrobble<Scrobbling>) listens to your ListenBrainz account. Scrobbling listens helps you build up a profile of your music tastes. It also enables you to keep a record of your listens. To set up the ListenBrainz plugin:

::::{tab-set}

:::{tab-item} Desktop :sync: desktop

  1. Log in to your account.
  2. Select the cog icon ({fa}cog) or your avatar to expand the user menu.
  3. Select {guilabel}Settings.
  4. Scroll down to the {guilabel}Plugins section.
  5. Select {guilabel}Manage plugins.
  6. Find the {guilabel}ListenBrainz plugin.
  7. Toggle the {guilabel}Enabled switch.
  8. Enter {guilabel}Your ListenBrainz user token. You can find this on your ListenBrainz profile.
  9. Select {guilabel}Save.

:::

:::{tab-item} Mobile :sync: mobile

  1. Log in to your account.
  2. Select the cog icon ({fa}cog) or your avatar to open the {guilabel}Options menu.
  3. Select {guilabel}Settings.
  4. Scroll down to the {guilabel}Plugins section.
  5. Select {guilabel}Manage plugins.
  6. Find the {guilabel}ListenBrainz plugin.
  7. Toggle the {guilabel}Enabled switch.
  8. Enter {guilabel}Your ListenBrainz user token. You can find this on your ListenBrainz profile.
  9. Select {guilabel}Save.

::: ::::

That's it! You've set up the ListenBrainz plugin. When you listen to tracks, the plugin sends the information to ListenBrainz.

Enable data synchronization

The ListenBrainz plugin supports synchronizing listenings and track favorites with Funkwhale. To enable support for synchronization:

::::{tab-set}

:::{tab-item} Desktop :sync: desktop

  1. Log in to your account.
  2. Select the cog icon ({fa}cog) or your avatar to expand the user menu.
  3. Select {guilabel}Settings.
  4. Scroll down to the {guilabel}Plugins section.
  5. Select {guilabel}Manage plugins.
  6. Find the {guilabel}ListenBrainz plugin.
  7. Enter {guilabel}Your ListenBrainz user name. You can find this on your ListenBrainz profile.
  8. Select the data you want to synchronize. The following options are available:
    • {guilabel}Enable listenings submission to ListenBrainz: submit your Funkwhale listens to ListenBrainz.
    • {guilabel}Enable listenings sync: pull listening data from ListenBrainz into Funkwhale.
    • {guilabel}Enable favorite submission to ListenBrainz services: submit your Funkwhale favorites activity to ListenBrainz.
    • {guilabel}Enable favorite sync: pull favorites data from ListenBrainz into Funkwhale.
  9. Select {guilabel}Save.

:::

:::{tab-item} Mobile :sync: mobile

  1. Log in to your account.
  2. Select the cog icon ({fa}cog) or your avatar to open the {guilabel}Options menu.
  3. Select {guilabel}Settings.
  4. Scroll down to the {guilabel}Plugins section.
  5. Select {guilabel}Manage plugins.
  6. Find the {guilabel}ListenBrainz plugin.
  7. Enter {guilabel}Your ListenBrainz user name. You can find this on your ListenBrainz profile.
  8. Select the data you want to synchronize. The following options are available:
    • {guilabel}Enable listenings submission to ListenBrainz: submit your Funkwhale listens to ListenBrainz.
    • {guilabel}Enable listenings sync: pull listening data from ListenBrainz into Funkwhale.
    • {guilabel}Enable favorite submission to ListenBrainz services: submit your Funkwhale favorites activity to ListenBrainz.
    • {guilabel}Enable favorite sync: pull favorites data from ListenBrainz into Funkwhale.
  9. Select {guilabel}Save.

::: ::::