---
title: Libre.fm
toc_min_heading_level: 2
toc_max_heading_level: 5
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import CodeBlock from '@theme/CodeBlock';
import JsonConfig from '!!raw-loader!@site/../config/librefm.json.example';

This Source **monitors your Libre.fm scrobble history** and re-scrobbles new activity to configured [Clients.](/configuration/clients)

:::tip[Other Uses]

* To **scrobble to** Libre.fm, create a [Libre.fm (Client)](/configuration/clients/librefm)

:::

To configure this Source use the same registration instructions and configuration data shown in [Libre.fm (Client)](/configuration/clients/librefm) with the difference being `"configureAs": "source"` defined in the File/AIO configuration below.

## Configuration

<Config config="LibrefmSourceConfig" fileContent={JsonConfig} name="librefm">
        | Environmental Variable        | Required? | Default                                  | Description                                                                                      |
        | ----------------------------- | --------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------ |
        | `SOURCE_LIBREFM_ENABLE`       | No        |                                          | Set to `true` to enable Libre.fm, if not using any of the below variables                        |
        | `SOURCE_LIBREFM_API_KEY`      | No        | `anything`                               | Optional API Key                                                                                 |
        | `SOURCE_LIBREFM_SECRET`       | No        | `anything`                               | Optional shared secret                                                                           |
        | `SOURCE_LIBREFM_REDIRECT_URI` | No        | `http://localhost:9078/librefm/callback` | Url to use for authentication. Must include `librefm/callback` somewhere in it                   |
        | `SOURCE_LIBREFM_SESSION`      | No        |                                          | Session id. Will be generated by authentication flow if not provided.                            |
        | `SOURCE_LIBREFM_URLBASE`      | No        |                                          | Use for custom Libre.fm instance only. The host + path prefix EX `https://my.libre.example/2.0/` |
</Config>