Toshiba AC control (community)

Python library to control Toshiba AC units over Toshiba's cloud service - HTTP login, device discovery, and real-time state updates over AMQP.

This is the community-maintained protocol library behind the Toshiba AC (Community) Home Assistant integration. It is published on PyPI as toshiba-ac-community; the Python import name is toshiba_ac.

Originally created by Kamil Sroka (KaSroka) - full credit for the protocol work. This repository is maintained independently so fixes and improvements can ship on their own schedule.

Installation

pip3 install toshiba-ac-community

Requires Python 3.10 or newer.

Note: this package pins the pre-release azure-iot-device==2.15.0rc1. Installers that refuse pre-release transitive dependencies (e.g. uv) need azure-iot-device==2.15.0rc1 installed first, or pre-releases enabled.

Installation for development

1. Clone this repository:

   git clone https://github.com/vmvelev/Toshiba-AC-control.git

2. Install the package (editable if you want to edit the code):

   cd Toshiba-AC-control && pip3 install -e .

Usage

import asyncio

from toshiba_ac.device_manager import ToshibaAcDeviceManager


async def main():
    # Must be constructed inside a running event loop
    device_manager = ToshibaAcDeviceManager(username, password)
    sas_token = await device_manager.connect()
    devices = await device_manager.get_devices()
    ...
    await device_manager.shutdown()


asyncio.run(main())

Sample script

Sample GUI application samples/toshiba_ac_gui.py demonstrates usage of this package. It allows switching basic functionalities of the AC and shows current status.

It requires env variables with login information:

TOSHIBA_USER=<USER_NAME> TOSHIBA_PASS=<PASSWORD> python3 samples/toshiba_ac_gui.py

Reporting issues

• Library / device communication issues: open an issue here
• Home Assistant integration issues: home-assistant-toshiba_ac

License

Apache-2.0, same as the original project.