Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kalkih/forked-daapd-card
forked daapd card for Home Assistant Lovelace UI
https://github.com/kalkih/forked-daapd-card
automation forked-daapd hassio home-assistant lovelace lovelace-ui media-player multiroom
Last synced: about 1 month ago
JSON representation
forked daapd card for Home Assistant Lovelace UI
- Host: GitHub
- URL: https://github.com/kalkih/forked-daapd-card
- Owner: kalkih
- License: mit
- Created: 2018-10-07T16:48:27.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2022-05-27T21:11:35.000Z (over 2 years ago)
- Last Synced: 2024-10-23T11:44:17.745Z (about 2 months ago)
- Topics: automation, forked-daapd, hassio, home-assistant, lovelace, lovelace-ui, media-player, multiroom
- Language: JavaScript
- Homepage:
- Size: 8.79 KB
- Stars: 79
- Watchers: 11
- Forks: 12
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-home-assistant - forked-daapd Card - Control a forked daapd instance. (Dashboards / Custom Cards)
README
# Lovelace forked daapd card
A lovelace card for [Home Assistant](https://github.com/home-assistant/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`.
## 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`.
```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.
```bash
git clone https://github.com/kalkih/forked-daapd-card.git
```
- Add a reference to the card in your `ui-lovelace.yaml`.
```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](forked-daapd-card.js).
- Add the new version number to the end of the cards reference url in your `ui-lovelace.yaml` like below.
```yaml
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.
```yaml
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://:/api/outputs`
### Example usage
#### Normal
```yaml
- type: "custom:forked-daapd-card"
entity: media_player.multiroom_audio
ip: "192.168.1.5"
name: Multiroom
```
#### Show only specified outputs
```yaml
- 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.