🌟 Alexa Share — Home Assistant Add-on

🇬🇧 English · 🇩🇪 Deutsch

Select exactly which entities you want to share with Amazon Alexa

Alexa Share is a Home Assistant add-on that gives you fine‑grained control over what your Amazon Alexa integration can see. Instead of exposing your entire smart home to Alexa, you choose exactly which entities are shared — nothing more, nothing less.

This means better privacy, cleaner Alexa device lists, and a more intentional voice assistant experience.

This repository is a fork of cfpinto/alexa_share and is maintained at git.krieger.icu/mkrieger/alexa_share.

---

✨ Why Alexa Share?

Home Assistant’s built‑in Amazon Alexa integration is powerful, but it can expose more entities than you’d like. If you’ve ever opened the Alexa app and found dozens of devices you never intended to share, you know the feeling.

Alexa Share solves that. With this add-on you can:

• 🟦 Select specific entities to expose to Alexa
• 🔒 Keep sensitive or internal entities private
• 🧹 Avoid clutter in the Alexa app
• ✏️ Give devices Alexa names and display categories right in the UI
• 🔍 Review every change before it is written

---

🧠 How It Works

Alexa Share provides a web interface where you can:

1. Browse all your Home Assistant entities, filter and search them
2. Switch the entities you want to share with Alexa — one by one, or many at once in the selection mode
3. Optionally edit the Alexa name, description and display categories
4. Review a preview of the changes to your configuration
5. Publish — the add-on writes the Alexa configuration for you

No YAML editing. No digging through configuration files. Backups of the changed file are kept automatically.

---

🚀 Key Features

• Entity table with sync switches — a flat table that follows your Home Assistant theme; changes stay pending until you publish and can be discarded at any time
• Made for phones and tablets — on narrow screens the list becomes cards with the device name, entity ID and small badges, the filters open as a drawer from the bottom, and a sort field replaces the column headers
• Filter panel and search — select several values per filter (domain, area, manufacturer, category, source and Home Assistant labels), with live counts for every value
• Selection mode — select single devices or everything that matches the filters and sync or unsync them in one step
• Remembered settings — filters, tab, page size, sort order and the filter panel come back the next time you open the page
• Pages or scrolling — 50 devices per page by default, or a list that loads more as you scroll
• Edit Alexa attributes — name, description and display categories; the device name is suggested and used when you leave the name empty
• Orphaned entries — find configuration of entities that no longer exist and remove it with the next publish
• Preview before publishing — see which lines change in the written file
• Clean removal — switching a device off also removes its entry from entity_config
• Backup rotation — the last backups of the changed file are kept (configurable)
• Works with alexa: !include — writes to the included file instead of configuration.yaml
• Translated — English and German, chosen by your browser language
• Runs on amd64 and aarch64 as a lightweight Next.js app with an optional sidebar entry

---

🛠️ Installation

Quick Install

Manual Installation

1. Go to Settings > Add-ons > Add-on Store
2. Click the menu (⋮) > Repositories
3. Add: https://git.krieger.icu/mkrieger/alexa_share
4. Find and install Alexa Share
5. Start the add-on and open the web UI
6. Choose which entities you want Alexa to see
7. Click Publish Changes, check the preview and confirm, then reload the Alexa configuration

That's it — Alexa now only knows what you want it to know.

---

📖 Documentation

For usage instructions, configuration options and troubleshooting, see the Documentation in English or German. Changes between versions are listed in the Changelog.

---

📄 License

This project is licensed under the MIT License.

Original work © 2025 cfpinto; modifications © 2026 Maximilian Krieger.