Home
Softono
home-assistant-toshiba_ac

home-assistant-toshiba_ac

Open source Python
GitHub
199
Stars
36
Forks
31
Issues
16
Watchers
1 month
Last Commit
Home Automation

About home-assistant-toshiba_ac

Toshiba AC integration into home-assistant.io

Platforms

Web Self-hosted

Languages

Python

Links

Source Code
h
Published by
h4de5
Visit View Profile

README.md

View on GitHub

HACS Validate hassfest Validate Github Release Github Commit since Github Open Issues Github Open Pull Requests

Toshiba - Air conditioning

Toshiba AC integration into home-assistant.io

Requirements

You need a supported (or compatible) Toshiba AC device with either a built-in Wifi module or an adapter. See list of compatible devices

Installation

Installation with HACS

  • In HACS go to integrations and search for 'Toshiba AC'
  • Click Install
  • Reboot Home Assistant
  • Follow common integration manual

or: Manual installation

  • Download latest release
  • Create a folder: custom_components in your home-assistant config directory
  • Extract content (the folder toshiba_ac) of the release zip into the newly created directory
  • Reboot Home Assistant
  • Follow common integration manual

Common manual to activate the integration

  • The integration should be available as Toshiba AC in the Add integration dialog
  • You need to enter your Toshiba AC account credentials (same as within the app)
  • There is no bounding/registering of new AC units possible with this code - please continue to use the app for this

Troubleshooting

Setup Tips

  • Avoid long or complex passwords: Some users report issues with passwords that are too long or contain special characters. If you have trouble setting up, try using a simpler password in the Toshiba app first.
  • Use the official app first: Make sure your AC unit is properly set up and working in the official Toshiba app before adding it to Home Assistant.

Connection Issues

Most connection problems are caused by Toshiba's cloud service being temporarily unavailable.

Important:

  • A single failed setup after a Home Assistant restart is not a bug - the cloud may just be temporarily unreachable
  • Do NOT restart Home Assistant repeatedly - this will trigger rate limiting on Toshiba's servers and make things worse
  • Best approach: Wait 1-2 hours and try again

If you continue to have issues:

  1. Enable debug logging (see below)
  2. Check if the official Toshiba app works
  3. Wait and retry after some time

Debug Logging

Add this to your configuration.yaml to enable detailed logging:

logger:
  default: warning
  logs:
    custom_components.toshiba_ac: debug
    toshiba_ac: debug

Reporting Issues

Compatible devices

If your device is compatible with the official Toshiba AC mobile app or Toshiba Home AC Control it has good chances to be supported by this integration. Furthermore it has been tested with the following hardware: List of Supported Devices - feel free to update that list!

⚠️ North America Users: Toshiba distributes their AC devices with a completely different app and system in the US: Toshiba AC NA. This integration will NOT work with North American devices. Instead, try midea-ac-py which may be able to control NA-edition AC units without requiring an account.

More links and resources