# PyMitsubishi
[](https://badge.fury.io/py/pymitsubishi)
[](https://pypi.org/project/pymitsubishi/)
[](https://pepy.tech/project/pymitsubishi)
[](https://opensource.org/licenses/MIT)
A Python library for controlling and monitoring Mitsubishi MAC-577IF-2E air conditioners.
## Home Assistant Integration
For Home Assistant users, check out our official integration: [homeassistant-mitsubishi](https://github.com/pymitsubishi/homeassistant-mitsubishi)
## Features
- **Device Control**: Power, temperature, mode, fan speed, and vane direction control
- **Status Monitoring**: Real-time device status, temperatures, and error states
- **Group Code Analysis**: Advanced protocol analysis for enhanced device understanding
- **Encryption Support**: Full support for Mitsubishi's encryption protocol
## Installation
```bash
pip install pymitsubishi
```
## Quick Start
```python
from pprint import pprint
from pymitsubishi import MitsubishiAPI, MitsubishiController, DriveMode
# Initialize the API and controller
api = MitsubishiAPI(device_host_port="192.168.1.100")
controller = MitsubishiController(api=api)
# Fetch device status
controller.fetch_status()
pprint(controller.data)
# Control the device
controller.set_power(True)
controller.set_temperature(24.0)
controller.set_mode(DriveMode.COOLER)
# Clean up
api.close()
```
## API Reference
### MitsubishiAPI
Core communication class handling encryption and HTTP requests.
### MitsubishiController
High-level control interface for device operations.
### Data Classes
- `PowerOnOff`: Power state enumeration
- `DriveMode`: Operating mode enumeration
- `WindSpeed`: Fan speed enumeration
- `VerticalWindDirection`, `HorizontalWindDirection`: Vane direction enumerations
## Requirements
- Python 3.12+
- requests
- pycryptodome
## License
MIT License - see LICENSE file for details.
## Contributing
Contributions are welcome! Please see our [Contributing Guidelines](CONTRIBUTING.md) for detailed information on development setup, code standards, and the contribution process.
Raw data
{
"_id": null,
"home_page": null,
"name": "pymitsubishi",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": "Ashleigh Hopkins <ashleigh@example.com>",
"keywords": "mitsubishi, aircon, air conditioner, home automation, MAC-577IF-E",
"author": null,
"author_email": "Ashleigh Hopkins <ashleigh@example.com>",
"download_url": "https://files.pythonhosted.org/packages/a6/83/05de3023ad072a0f6e02f9e862ed51c50ab4a51237a44b19f0dc9ee39612/pymitsubishi-0.4.1.tar.gz",
"platform": null,
"description": "# PyMitsubishi\n\n[](https://badge.fury.io/py/pymitsubishi)\n[](https://pypi.org/project/pymitsubishi/)\n[](https://pepy.tech/project/pymitsubishi)\n[](https://opensource.org/licenses/MIT)\n\nA Python library for controlling and monitoring Mitsubishi MAC-577IF-2E air conditioners.\n\n## Home Assistant Integration\n\nFor Home Assistant users, check out our official integration: [homeassistant-mitsubishi](https://github.com/pymitsubishi/homeassistant-mitsubishi)\n\n## Features\n\n- **Device Control**: Power, temperature, mode, fan speed, and vane direction control\n- **Status Monitoring**: Real-time device status, temperatures, and error states\n- **Group Code Analysis**: Advanced protocol analysis for enhanced device understanding\n- **Encryption Support**: Full support for Mitsubishi's encryption protocol\n\n## Installation\n\n```bash\npip install pymitsubishi\n```\n\n## Quick Start\n\n```python\nfrom pprint import pprint\nfrom pymitsubishi import MitsubishiAPI, MitsubishiController, DriveMode\n\n# Initialize the API and controller\napi = MitsubishiAPI(device_host_port=\"192.168.1.100\")\ncontroller = MitsubishiController(api=api)\n\n# Fetch device status\ncontroller.fetch_status()\npprint(controller.data)\n\n# Control the device\ncontroller.set_power(True)\ncontroller.set_temperature(24.0)\ncontroller.set_mode(DriveMode.COOLER)\n\n# Clean up\napi.close()\n```\n\n## API Reference\n\n### MitsubishiAPI\n\nCore communication class handling encryption and HTTP requests.\n\n### MitsubishiController\n\nHigh-level control interface for device operations.\n\n### Data Classes\n\n- `PowerOnOff`: Power state enumeration\n- `DriveMode`: Operating mode enumeration\n- `WindSpeed`: Fan speed enumeration\n- `VerticalWindDirection`, `HorizontalWindDirection`: Vane direction enumerations\n\n## Requirements\n\n- Python 3.12+\n- requests\n- pycryptodome\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Contributing\n\nContributions are welcome! Please see our [Contributing Guidelines](CONTRIBUTING.md) for detailed information on development setup, code standards, and the contribution process.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Control and monitor Mitsubishi Air Conditioners",
"version": "0.4.1",
"project_urls": {
"Documentation": "https://github.com/pymitsubishi/pymitsubishi#readme",
"Homepage": "https://github.com/pymitsubishi/pymitsubishi",
"Issues": "https://github.com/pymitsubishi/pymitsubishi/issues",
"Repository": "https://github.com/pymitsubishi/pymitsubishi.git"
},
"split_keywords": [
"mitsubishi",
" aircon",
" air conditioner",
" home automation",
" mac-577if-e"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "22c44f745171787889dbf9692fcbb6eb684813d32b2b5bd792ea8ed765b2f23a",
"md5": "0fb86418915ab9884f81f96ec330ae3a",
"sha256": "750184bc153126bbc98c623b52fd0a137f2229ddbd7b2f019d21b29cf6ecdc7a"
},
"downloads": -1,
"filename": "pymitsubishi-0.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0fb86418915ab9884f81f96ec330ae3a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 16536,
"upload_time": "2025-10-29T15:50:18",
"upload_time_iso_8601": "2025-10-29T15:50:18.349388Z",
"url": "https://files.pythonhosted.org/packages/22/c4/4f745171787889dbf9692fcbb6eb684813d32b2b5bd792ea8ed765b2f23a/pymitsubishi-0.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a68305de3023ad072a0f6e02f9e862ed51c50ab4a51237a44b19f0dc9ee39612",
"md5": "f8649058a913fbc892cd4a023b29cd30",
"sha256": "9db47cb58f493528b61793d4ef618f8db0dda39f2bed15d4b5af423b5788bd16"
},
"downloads": -1,
"filename": "pymitsubishi-0.4.1.tar.gz",
"has_sig": false,
"md5_digest": "f8649058a913fbc892cd4a023b29cd30",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 27970,
"upload_time": "2025-10-29T15:50:20",
"upload_time_iso_8601": "2025-10-29T15:50:20.714395Z",
"url": "https://files.pythonhosted.org/packages/a6/83/05de3023ad072a0f6e02f9e862ed51c50ab4a51237a44b19f0dc9ee39612/pymitsubishi-0.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-29 15:50:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pymitsubishi",
"github_project": "pymitsubishi#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "requests",
"specs": []
},
{
"name": "pycryptodome",
"specs": []
}
],
"lcname": "pymitsubishi"
}
JSON
