Skip to content

Commit

Permalink
HACS readme updates.
Browse files Browse the repository at this point in the history
  • Loading branch information
thlucas1 committed Jun 13, 2024
1 parent 07b158f commit 1e15b58
Show file tree
Hide file tree
Showing 3 changed files with 107 additions and 1 deletion.
105 changes: 105 additions & 0 deletions INFO.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
# SoundTouchPlus Card

[![GitHub Release][releases-shield]][releases] [![License][license-shield]](LICENSE) [![docs][docs-shield]][docs] [![hacs][hacs-shield]][hacs]

![Project Maintenance][maintenance-shield] [![BuyMeCoffee][buymecoffee-shield]][buymecoffee]

_Home Assistant UI card that supports features unique to the [SoundTouchPlus](https://github.com/thlucas1/homeassistantcomponent_soundtouchplus) custom integration._
Extended support for the Bose SoundTouch line of speaker products for use in Home Assistant.

## Features

* Media player interface with customizable controls and information display
* Display / Select / Store SoundTouch Device Presets
* Display / Select User-Defined Presets
* Display / Select SoundTouch Device Recently Played items
* Display / Select your Pandora Stations
* Display / Select Source Inputs
* Card Configuration Editor User-Interface for changing options

with more to come!

## How it Looks

Here's a quick overview on what the card can look like. The card is highly customizable when it comes to the information displayed. Check out the [UI Dashboards wiki](https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card/wiki/UI-Dashboards) page for more examples and YAML configuration.

#### Media Player Control (Panel Mode)
![player_nofooter_panel](./images/player_nofooter_panel.png)

#### SoundTouch Recently Played (Panel Mode)
![recentlyplayed_nofooter_panel](./images/recentlyplayed_nofooter_panel.png)

#### User-Defined Presets (Panel Mode)
![presets_user_nofooter_panel](./images/presets_user_nofooter_panel.png)

#### SoundTouch Device Presets (Panel Mode)
![presets_device_nofooter_panel](./images/presets_device_nofooter_panel.png)

#### SoundTouch Sources (Panel Mode)
![sources_nofooter_panel](./images/sources_nofooter_panel.png)

#### Pandora Stations (Panel Mode)
![pandora_nofooter_panel](./images/pandora_nofooter_panel.png)

#### Editor UI, General Options
![general_editor_options](./images/general_editor_options.png)


## HACS Installation Instructions (recommended)

- On your Home Assistant sidebar menu, go to HACS > Frontend
- Click on the 3-dot overflow menu in the upper right, and select `custom repositories` item.
- Copy / paste `https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card` in the Repository textbox and select `Lovelace` for the category entry.
- Click on `Add` to add the custom repository.
- You can then click on the `SoundTouchPlus Card` repository entry (you may need to filter your list first to find the new entry).
- Click on `download` to start the download. It will install the card to your `/config/www/community/homeassistantcomponent_soundtouchplus_card` directory.
- Go back on your dashboard and click on the icon at the right top corner then on Edit dashboard.
- You can now click on Add card in the bottom right corner and search for "Custom: SoundTouchPlus Card".

## Manual Installation

- using the tool of choice open the directory (folder) for your HA configuration (where you find `configuration.yaml`).
- change directory to the `www` folder; if you don't have this directory, then create it.
- download the `soundtouchplus-card.js` file from the [GitHub repository](https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card) into your `<config>/www` folder.
- on your dashboard click on the icon at the right top corner then on Edit dashboard.
- click again on that icon and then on Manage resources.
- click on Add resource.
- copy and paste this: `/local/soundtouchplus-card.js?v=1`.
- click on JavaScript Module then Create.
- go back and refresh your page.
- you can now click on Add card in the bottom right corner and search for "Custom: SoundTouchPlus Card".
- after any update of the file you will have to edit `/local/soundtouchplus-card.js?v=1` and change the version (e.g. `v=1`) to any higher number (e.g. `v=1.2`).


## More Information

Check out the following links for more information:

- [Card Wiki Home](https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card/wiki)
- [Card Features](https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card/wiki/Card-Features)
- [Card Configuration](https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card/wiki/Configuration-Options)
- [Card UI Examples](https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card/wiki/UI-Dashboards)
- [SoundTouchPlus Integration](https://github.com/thlucas1/homeassistantcomponent_soundtouchplus)


## Reporting a Problem

Submit a [Bug Report](https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card/issues/new?assignees=&labels=Bug&projects=&template=bug.yml) to bring the issue to my attention. I receive a notification when a new issue is opened, and will do my best to address it in a prompt and professional manner.

## Request a New Feature

Do you have an idea for a new feature that could be added to the integration? Submit a [Feature Request](https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card/issues/new?assignees=&labels=Feature%2BRequest&projects=&template=feature_request.yml) to get your idea into the queue. I receive a notification when a new request is opened, and will do my best to turn your idea into the latest and greatest feature.

***

[releases-shield]: https://img.shields.io/github/release/thlucas1/homeassistantcomponent_soundtouchplus_card.svg?style=for-the-badge
[releases]: https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card/releases
[license-shield]: https://img.shields.io/github/license/thlucas1/homeassistantcomponent_soundtouchplus_card.svg?style=for-the-badge
[docs]: https://github.com/thlucas1/homeassistantcomponent_soundtouchplus_card/wiki
[docs-shield]: https://img.shields.io/badge/Docs-Wiki-blue.svg?style=for-the-badge
[hacs]: https://github.com/hacs/integration
[hacs-shield]: https://img.shields.io/badge/HACS-Default-41BDF5.svg?style=for-the-badge

[maintenance-shield]: https://img.shields.io/badge/maintainer-Todd%20Lucas%20%40thlucas1-blue.svg?style=for-the-badge
[buymecoffee]: https://www.buymeacoffee.com/thlucas1
[buymecoffee-shield]: https://img.shields.io/badge/buy%20me%20a%20coffee-donate-yellow.svg?style=for-the-badge
1 change: 1 addition & 0 deletions SoundTouchPlusCard.njsproj
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@
<Content Include="LICENSE" />
<Content Include="package-lock.json" />
<Content Include="package.json" />
<Content Include="INFO.md" />
<Content Include="rollup.config.js" />
<Content Include="src\types\hassentityattributes-soundtouchplus.ts">
<SubType>Code</SubType>
Expand Down
2 changes: 1 addition & 1 deletion hacs.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,5 @@
"filename": "soundtouchplus-card.js",
"hide_default_branch": true,
"homeassistant": "2023.8.0",
"render_readme": true
"render_readme": false
}

0 comments on commit 1e15b58

Please sign in to comment.