Atlantic Cozytouch smart home integration, free and open source
Control Atlantic Cozytouch air conditioners and heat pumps (Takao M3) in Gladys Assistant.
Published by tchoinard38
- Devices
- Version 1.2.0
- Requires Gladys >=5.1.0
- ★ 0
Controllable modes
Besides mode, target (heat and cool) and swing: eco, boost, silence, presence/away and weekly program — the same capabilities as the Home Assistant integration. This integration brings Atlantic air conditioners and heat pumps controlled by Cozytouch (Takao M3 and other connected Atlantic equipment) into Gladys Assistant.
What it does
One device per controllable room of the Cozytouch account, with: on/off switch, mode select (off, heating, cooling, auto, fan), writable target temperature (heating or cooling capacity follows the current mode), room temperature sensor with history, state text, and a fan speed select (Auto/Low/Medium/High) when the equipment exposes it.
Prerequisites
- A Cozytouch account that works in the Atlantic app on your phone.
- Gladys Assistant 5.1 or later.
Setup
- Install the integration from Integrations in Gladys.
- In the Configuration tab, enter the Cozytouch e-mail and password, then click Test the connection: the number of controllable rooms is shown.
- Open the Discovery tab and create the rooms you want.
If a room is missing from discovery, find its numeric id (magellan deviceId in the app's developer tools) and enter it in the “Room id” field.
The integration talks to the Atlantic Magellan cloud over the Internet, like the official app; your credentials stay in the Gladys configuration (secret field).
Troubleshooting
- “0 controllable room(s) found”: check the credentials; for accounts with several installations, use the “Room id” field.
- The heating and cooling setpoints are a single feature in Gladys: the integration writes the capability matching the current mode.
Unofficial community integration, not affiliated with Groupe Atlantic.
Configuration settings
These are the settings Atlantic Cozytouch asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| Getting started | section | No | Use the e-mail and password of your Cozytouch account (the same as the Atlantic Cozytouch app). The integration talks to the Atlantic Magellan cloud, exactly like the official app. Unofficial integration, no affiliation with Atlantic. |
| Cozytouch e-mail | string | Yes | |
| Cozytouch password | secret | Yes | |
| Room id (optional) | number | No | Leave empty for automatic discovery. If a room is missing, find its numeric id in the Cozytouch app (magellan deviceId) and enter it here. |
| Labels language | select | No | |
| Refresh interval (s) | number | No | How often the rooms are read, in seconds (one minute minimum, to stay courteous with the Atlantic cloud). |
How to install Atlantic Cozytouch in Gladys
- In Gladys, open Integrations: Atlantic Cozytouch appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/tchoinard38/gladys-atlantic-cozytouch:1.2.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/tchoinard38/gladys-atlantic-cozytouch.
Atlantic Cozytouch requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
Atlantic Cozytouch is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by tchoinard38, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation