CasaTunes is a Multi-Room audio system. With CasaTunes, you can pick and choose from our flexible line of music servers and matrix amplifiers to create the perfect multiroom audio solution for your customers, whether looking for an entry, value, or high performance solution.
This repository is a community-maintained fork of the original CasaTunes custom integration for Home Assistant. The goal is to keep the integration working with current Home Assistant releases and real CasaTunes REST API behavior as long as practical.
Support is best-effort. Issues and pull requests are welcome, especially with Home Assistant logs, CasaTunes API responses, and details about the CasaTunes server version being used.
The original upstream repository is not currently maintained for newer Home Assistant releases. This fork is the maintained version for users who need an actively updated CasaTunes integration.
- Ensure HACS is installed.
- Add this repository URL to custom repositories in HACS.
- Install and restart Home Assistant.
- If CasaTunes isn't detected after restart you should be able to add it via the integrations screen.
Download or clone and copy the folder custom_components/casatunes into your Home Assistant custom_components/ directory.
Your CasaTunes unit should be discovered automatically. If this doesn't happen, go to integrations and add it manually with the IP address of your unit.
- Keep the integration compatible with recent Home Assistant versions.
- Work around CasaTunes REST API payload shape differences that can otherwise crash polling.
- Improve media browsing, now-playing data, artwork proxying, grouping, search, TTS, and doorbell behavior.
Some CasaTunes servers can return duplicate rows for custom Internet Stations and Favorites from the CasaTunes API itself. This integration does not hide those duplicates with a Home Assistant-side filter, so the underlying CasaTunes data/cache issue remains visible and can be fixed at the source.
- alphasixtyfive for maintaining this fork.
- jonkristian for the earlier CasaTunes integration work this fork is based on.
- This component uses the excellent integration_blueprint from ludeeus.
If you want to contribute to this please read the Contribution guidelines