Skip to main content

Airtouch 4 & 5 Python TCP API

An api allowing control of AC state (temperature, on/off, mode) of an Airtouch 4 controller locally over TCP. Airtouch 5 support is experimental as of 28 Nov 2022, and is fully interface compatible with AT4.

All you need to do is initialise and specify the correct AirTouchVersion (if you don't, it assumes 4).

Warning

I am using this with my own Airtouch 4 and see no issues. Please don't blame me if you have any issues with your Airtouch 4 or AC system after using this - I don't know much about AC systems and will probably not be able to help!

Others are using it with Airtouch 5 and see no issues.

Usage

To initialise:

  • airTouch = AirTouch("192.168.1.19")
  • airTouch = AirTouch("192.168.1.1", AirTouchVersion.AIRTOUCH5)

As a test:

Use the demo.py file and pass in an AirTouch IP. It takes you through a few tests.

Notes

AirTouch5: If you turn off all zones, the AC itself turns off. Turning on a zone does not turn the AC back on by itself. You must turn it back on too. Same behaviour in 'official' app.

To load:

  • await airTouch.UpdateInfo(); -- This loads the config from the AirTouch. Make sure you check for any errors before using it. It will load the Group/Zone info, the AC info, then capabilities. This needs to happen prior to using.

The following functions are available:

Group Level Functions:

  • SetGroupToTemperature (async)
  • TurnGroupOn (async)
  • TurnGroupOff (async)
  • SetCoolingModeByGroup (async)
  • SetFanSpeedByGroup (async)
  • GetSupportedCoolingModesByGroup -- Based on the loaded config.
  • GetSupportedFanSpeedsByGroup -- Based on the loaded config.

AC Level Functions

  • TurnAcOn (async)
  • TurnAcOff (async)
  • SetFanSpeedForAc (async)
  • SetCoolingModeForAc (async)
  • GetSupportedCoolingModesForAc
  • GetSupportedFanSpeedsForAc
  • GetAcs

Metadata

Release files for airtouch4pyapi 1.0.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for airtouch4pyapi 1.0.8
File Size Uploaded
airtouch4pyapi-1.0.8.tar.gz 11.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for airtouch4pyapi 1.0.8
File Interpreter ABI Platform
airtouch4pyapi-1.0.8-py3-none-any.whl Python 3 none any Details

Total release size: 22.8 kB

Release files / airtouch4pyapi-1.0.8.tar.gz

Download URL airtouch4pyapi-1.0.8.tar.gz
Size 11.2 kB
Tags Source
SHA-256 checksum
How to use checksums
fdb3d17a467f0ef34a9ce7e04e38de41ba661ff65c1523fe1e406c8cbe3dce75
BLAKE2b-256 checksum
How to use checksums
1be9f16962de46563a761d12d79f697d3fa1f34210a3e2776209257c85b90430
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.11.1

Release files / airtouch4pyapi-1.0.8-py3-none-any.whl

Download URL airtouch4pyapi-1.0.8-py3-none-any.whl
Size 11.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e11577566a5e6b37021f798b66baad1477078b518e6b0a7b77ad4943e52e3153
BLAKE2b-256 checksum
How to use checksums
1b00b7538dd8b9264393b1b93686156f0ca9a9e54b3ac807f5d3b7a87083874c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.11.1

Release history Release notifications | RSS feed

This release

1.0.8 This release

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

1 release file

1.0.4

1 release file

1.0.3

1 release file

1.0.2

1 release file

1.0.1

1 release file

1.0.0

2 release files

0.1.0

2 release files

0.0.19

2 release files

0.0.18

2 release files

0.0.17

2 release files

0.0.16

2 release files

0.0.15

2 release files

0.0.14

2 release files

0.0.13

2 release files

0.0.12

2 release files

0.0.11

2 release files

0.0.10

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page