A lovelace card for Home Assistant to control a forked daapd instance
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Initial commit Oct 7, 2018
README.md Updated with new version info Jan 16, 2019
forked-daapd-card.js Updated lit dependency #2 Jan 16, 2019

README.md

Lovelace forked daapd card

A lovelace card for Home Assistant to control a forked daapd instance.

This card allow you to control your forked daapd instance through Home Assistant. The following controls are available: master volume, play/pause, next/previous, on/off, output selection, individual output volume.

Preview

Requirements

  • Forked daapd built with websocket support.
  • Forked daapd setup as an media_player (mpd component) in Home Assistant

Install

Simple install

  • Copy forked-daapd-card.js into your config/www ”folder.
  • Add a reference to the forked-daapd-card.js inside your ui-lovelace.yaml.
resources:
  - url: /local/forked-daapd-card.js?v=0.0.2
    type: module

Install using git

  • Clone this repository into your config/www folder using git.
git clone https://github.com/kalkih/forked-daapd-card.git
  • Add a reference to the card in your ui-lovelace.yaml.
resources:
  - url: /local/forked-daapd-card/forked-daapd-card.js?v=0.0.2
    type: module

Updating

  • Locate your forked-daapd-card.js in config/www or wherever you ended up storing it.
  • Replace it with the latest version of forked-daapd-card.js.
  • Add the new version number to the end of the cards reference url in your ui-lovelace.yaml like below.
resources:
  - url: /local/forked-daapd-card.js?v=0.0.2
    type: module

If you went the git clone route, just run git pull from inside your config/www/forked-daapd-card/ directory, to get the latest version of the code. Then add the new version number to the end of the card reference url in your ui-lovelace.yaml like below.

resources:
  - url: /local/forked-daapd-card/forked-daapd-card.js?v=0.0.2
    type: module

Using the card

Options

Name Type Default Since Description
type string required v0.0.1 custom:forked-daapd-card.
entity string required v0.0.1 The entity_id of your forked-daapd media_player (mpd) in home assistant.
ip string required v0.0.1 Set the IP address of your forked-daapd server.
port number 3689 v0.0.1 Set the port of your forked-daapd server.
ws_port number 3688 v0.0.1 Set the websocket port of your forked-daapd server.
name string optional v0.0.1 Set a custom friendly_name which is displayed beside the icon.
icon string optional v0.0.1 set a custom icon from any of the available mdi icons.
outputs list optional v0.0.1 If you want to only show specific outputs, include the id of each one in the list.
  • You can find the outputs ids by accessing http://<forked-daapd-ip>:<port>/api/outputs

Example usage

Normal

- type: "custom:forked-daapd-card"
  entity: media_player.multiroom_audio
  ip: "192.168.1.5"
  name: Multiroom

Show only specified outputs

- type: "custom:forked-daapd-card"
  entity: media_player.multiroom_audio
  ip: "192.168.1.5"
  name: Multiroom
  outputs:
    - "225176710053082"
    - "962995053492"
    - "24918234768"

Getting errors?

Make sure you have javascript_version: latest in your configuration.yaml under frontend:.

Make sure you have the latest versions of forked-daapd-card.js.

If you have issues after updating the card, try clearing your browser cache.

License

This project is under the MIT license.