mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-13 04:16:48 +00:00
57 lines
1.6 KiB
Markdown
57 lines
1.6 KiB
Markdown
---
|
|
layout: page
|
|
title: Discogs Sensor
|
|
description: "Instructions on how to set up Discogs sensors within Home Assistant."
|
|
date: 2017-12-04 22:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
ha_category: Multimedia
|
|
ha_release: 0.61
|
|
logo: discogs.png
|
|
ha_iot_class: Cloud Polling
|
|
---
|
|
|
|
The `discogs` platform allows you to see the current amount of records in your [Discogs](https://discogs.com) collection.
|
|
|
|
## {% linkable_title Setup %}
|
|
|
|
First, you'll need to get a personal access token from your Discogs account.
|
|
You can generate a token from your profile's [Developer settings](https://www.discogs.com/settings/developers).
|
|
|
|
## {% linkable_title Configuration %}
|
|
|
|
To enable this sensor, add the following lines to your `configuration.yaml`:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
sensor:
|
|
- platform: discogs
|
|
token: YOUR_TOKEN
|
|
```
|
|
|
|
The monitored conditions can create a sensor which displays the amount of records currently in your collection and/or wantlist, and an option to pick a random record from your collection.
|
|
|
|
{% configuration %}
|
|
token:
|
|
description: The Discogs API token to use as identification to get your collection.
|
|
required: true
|
|
type: string
|
|
name:
|
|
description: Name to use in the frontend.
|
|
required: false
|
|
type: string
|
|
monitored_conditions:
|
|
description: A list of sensor to include.
|
|
required: false
|
|
type: list
|
|
keys:
|
|
collection:
|
|
description: Shows the amount of records in the user's collection.
|
|
wantlist:
|
|
description: Shows the amount of records in the user's wantlist.
|
|
random_record:
|
|
description: Proposes a random record from the collection to play.
|
|
{% endconfiguration %}
|