Control your Aigostar lights directly from Home Assistant — no local flashing required. The integration communicates with the same backend as the AigoSmart app.
- Automatic device discovery — all bulbs linked to your AigoSmart account are added automatically
- Periodic device sync — new bulbs added via the AigoSmart app are detected every 5 minutes
- Manual sync service —
aigostar.sync_devicesto force device re-discovery - Automatic token refresh — iotToken is renewed before expiration
- Brightness control (1–100%)
- Color temperature (2700K warm – 6500K cool)
- Email verification support (when the server requires a security code)
- Multilingual UI — English and Italian translations included
Aigostar smart fans on the same AigoSmart account are supported as well. They are
detected automatically (categoryKey: fan) and exposed as a proper fan entity
instead of an unusable light.
| Control | Entity | TSL property |
|---|---|---|
| On / off, speed 1-3 | fan.* |
powerstate, windspeed |
| Preset modes: Normal, Natural, Sleep | fan.* |
mode |
| Left/right swing | fan.* |
angleAutoLROnOff |
| Auto-off timer, 0-24 h | number.* |
appointmentClosingTime |
| Key beep | switch.* |
buzzerSwitch |
The fan also reports CuTemperature. It is not exposed: the probe sits next to
the motor and reads its warm air, not the room temperature.
Verified on a 5-blade Aigostar tower fan (productKey a1mZFNZz7pq). Other fans using
the same TSL should work; open an issue with the output of /thing/tsl/get if yours
differs.
| Device | Chipset | Protocol | Status |
|---|---|---|---|
| Aigostar smart bulb (E27/E14/GU10) | TG7100C (Bouffalo Lab) | AigoSmart | Tested |
Other Aigostar smart devices using the AigoSmart app may work but have not been tested.
Click the button above, or manually:
- Open HACS in Home Assistant
- Go to Integrations → ⋮ (top right) → Custom repositories
- Add this repository URL:
https://github.com/MarcoM1993/ha-aigostar - Select Integration as the category
- Click Add, then find Aigostar Smart Lights in the list and install it
- Restart Home Assistant
- Download or clone this repository
- Copy the
custom_components/aigostarfolder to your Home Assistantconfig/custom_components/directory - Restart Home Assistant
Or manually:
- Go to Settings → Devices & Services → Add Integration
- Search for Aigostar Smart Lights
- Enter your AigoSmart account email and password
- If the server requests a verification code, enter the code sent to your email
- All bulbs linked to your account will be discovered automatically
Force re-discovery of all devices from your Aigostar account. New devices are added automatically. You can call this service from:
- Developer Tools → Services
- Automations or scripts
The integration uses the same 5-step login flow as the AigoSmart Android app (reverse-engineered via APK decompilation):
- UC Login — authenticate with email/password on Aigostar User Center
- UC Authorize — obtain an authorization code
- Region Discovery — resolve the correct EU OAuth API gateway
- OAuth Login — exchange the authCode for an OA session ID
- IoT Session — exchange the session ID for an iotToken
Device control is performed via the same API gateway used by the AigoSmart app.
- Verify your email and password are correct (same as the AigoSmart app)
- If you get a verification code prompt, check your email inbox (including spam)
- The bulb must be powered on and connected to Wi-Fi
- Check that the bulb works in the AigoSmart app first
- Wait up to 5 minutes for auto-sync, or call
aigostar.sync_devices - You can also reload the integration: Settings → Integrations → Aigostar → ⋮ → Reload
This integration was built from scratch by reverse engineering the AigoSmart app — no public API, no documentation, just hours of packet sniffing and APK decompilation.
If it saved you time or you just enjoy using it, consider buying me a coffee. It keeps the project alive and motivates new features and device support.
Every contribution — no matter how small — is truly appreciated. Thank you!
For questions, suggestions, or bug reports: marcomicheli1993@gmail.com
This integration is unofficial and not affiliated with Aigostar. It was developed through reverse engineering of the AigoSmart Android app for personal and educational use. Use at your own risk.