Ferdinand99/iSmarGate-HACS-Integration
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
12 commits 1 branch 0 tags 69 KiB
  • Python 100%
Find a file
Exact
Ferdinand99 48b66d37cb
Some checks failed
Sync to Forgejo / mirror (push) Has been cancelled
Details
Validate / Home Assistant hassfest (push) Has been cancelled
Details
Validate / HACS validation (push) Has been cancelled
Details
Delete .github/workflows/.github/workflows/sync-to-forgejo.yml
2026-03-21 22:56:29 +01:00
.github Delete .github/workflows/.github/workflows/sync-to-forgejo.yml 2026-03-21 22:56:29 +01:00
custom_components/ismartgate_cloud Bumped version to 0.2.1 2026-03-19 17:00:24 +01:00
.editorconfig First Release 2026-03-19 16:16:41 +01:00
.gitattributes First Release 2026-03-19 16:16:41 +01:00
.gitignore First Release 2026-03-19 16:16:41 +01:00
CHANGELOG.md Fixed temperature sensor and battery sensor 2026-03-19 16:51:17 +01:00
CONTRIBUTING.md First Release 2026-03-19 16:16:41 +01:00
hacs.json Fixed Validation 2026-03-19 16:35:15 +01:00
LICENSE First Release 2026-03-19 16:16:41 +01:00
README.md Added installation manual 2026-03-19 17:17:10 +01:00

README.md

iSmartGate Cloud (Custom HACS Integration)

Unofficial Home Assistant custom integration for controlling iSmartGate through the cloud endpoint pattern used by the Homey community app.

This integration uses:

  • UDI
  • username
  • password

And communicates with:

  • https://<UDI>.isgaccess.com/api.php

Important

  • This is not an official iSmartGate integration.
  • Cloud behavior may change without notice.
  • Use at your own risk.

Features

  • Config flow (UI setup)
  • Cover entities for enabled doors/gates
  • Battery and temperature sensors (when exposed by device)
  • Polling via Home Assistant DataUpdateCoordinator

Installation (recommended via HACS)

  1. Open HACS in Home Assistant.
  2. Select Integrations.
  3. Open the menu (three dots) and choose Custom repositories.
  4. Add repository URL:
    • https://github.com/Ferdinand99/iSmarGate-HACS-Integration
  5. Select category:
    • Integration
  6. Click Add.
  7. Search for iSmartGate Cloud in HACS and install it.
  8. Restart Home Assistant.
  9. Go to Settings -> Devices & Services -> Add Integration.
  10. Search for iSmartGate Cloud and complete setup.

Installation (manual)

  1. Copy custom_components/ismartgate_cloud to your Home Assistant custom_components folder.
  2. Restart Home Assistant.
  3. Go to Settings -> Devices & Services -> Add Integration.
  4. Search for iSmartGate Cloud.

HACS repository structure

This repository is HACS-ready:

  • hacs.json in repository root
  • integration code in custom_components/ismartgate_cloud

GitHub repository setup included

This repository now includes:

  • CI validation workflow for Home Assistant and HACS.
  • Tag-based release workflow creating ismartgate_cloud.zip.
  • Issue templates for bugs and feature requests.
  • CODEOWNERS, CONTRIBUTING.md, CHANGELOG.md, and LICENSE.

Release process

  1. Bump version in custom_components/ismartgate_cloud/manifest.json.
  2. Update CHANGELOG.md.
  3. Create and push a git tag (example: v0.1.1).
  4. GitHub Actions builds a release ZIP and publishes a Release.

Notes

  • If your controller and Home Assistant can reach each other locally, use the built-in iSmartGate/GogoGate2 integration first.
  • This custom integration is intended for cloud-based access scenarios.