https://github.com/digital-alchemy-ts/synapse-extension

Custom component counterpart, powering the synapse library. Creates and manages entities within Home Assistant
https://github.com/digital-alchemy-ts/synapse-extension

custom-components digital-alchemy hacs-integration home-assistant home-automation

Last synced: about 2 months ago
JSON representation

Custom component counterpart, powering the synapse library. Creates and manages entities within Home Assistant

• Host: GitHub
• URL: https://github.com/digital-alchemy-ts/synapse-extension
• Owner: Digital-Alchemy-TS
• Created: 2024-02-16T17:49:16.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-03-26T01:36:30.000Z (10 months ago)
• Last Synced: 2024-03-26T02:40:42.672Z (10 months ago)
• Topics: custom-components, digital-alchemy, hacs-integration, home-assistant, home-automation
• Language: Python
• Homepage: https://docs.digital-alchemy.app/Synapse-Extension
• Size: 24.4 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
## 📘 Description

Welcome to the Synapse custom component for Home Assistant!

This library works with [@digital-alchemy/synapse](https://github.com/Digital-Alchemy-TS/synapse) to allow Typescript based applications to create custom entities.

- [Extended docs](https://docs.digital-alchemy.app/Synapse-Extension)

- [Discord](https://discord.gg/JkZ35Gv97Y)

### 📦 Via HACS (Recommended)

1. Ensure you have [HACS](https://hacs.xyz/) installed in Home Assistant.

2. Open HACS from the Home Assistant sidebar.

3. Navigate to "Integrations" > "+ Explore & add repositories."

4. Search for "Digital Alchemy Synapse" and select it from the list.

5. Click "Install this repository in HACS."

6. Restart Home Assistant to apply the changes.

### 📁 Manual Installation

If you prefer or need to install the integration manually:

1. Clone or download this repository.

2. Copy the `custom_components/synapse/` directory from the repository into the `/custom_components/` directory of your Home Assistant installation.

3. Restart Home Assistant.

## 📖 Usage

Once enabled, the Synapse integration automatically coordinates with the connected Node.js application to manage entities. This includes generating unique IDs, tracking history, and ensuring entities appear on dashboards and persist across Home Assistant restarts.

Switches can be manipulated via the Lovelace UI or service domain calls, just like native Home Assistant switches. Sensors follow a push model, with updates sent from the Node.js application to Home Assistant.

For more advanced automation and entity grouping, refer to `@digital-alchemy/automation`, which provides tools for creating "rooms" and managing entity states and scene activation.

## 📚 Documentation and Support

For more detailed documentation and support, visit the [GitHub repository](https://github.com/Digital-Alchemy-TS/synapse-extension). Please report any issues or feature requests there.