Skip to content
sarinrPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MirAIe

Control panel for Panasonic MirAIe air conditioners, ported from the Home Assistant integration.

Features

  • 🔐 Authentication with MirAIe cloud (email/mobile + password)
  • 📡 Device discovery via REST API
  • 🌡️ Real-time device control via MQTT
  • 🎛️ Full AC control: power, mode, temperature, fan speed, swing, and special modes
  • 💻 Responsive web UI with React + Tailwind CSS

Project Structure

miraie/
├── api/                    # Elysia.js REST API
│   └── src/
│       ├── index.ts        # API server with endpoints
│       ├── constants.ts    # API URLs, MQTT config
│       ├── types.ts        # TypeScript definitions
│       └── services/
│           ├── auth.ts     # Authentication service
│           ├── devices.ts  # Device management
│           └── mqtt.ts     # MQTT handler
└── web/                    # React + Vite + Tailwind UI
    └── src/
        └── App.tsx         # Main UI component

Requirements

  • Bun runtime (v1.0+)
  • MirAIe account (same credentials as the mobile app)

Quick Start

# Install all dependencies
bun install
cd api && bun install
cd ../web && bun install
cd ..

# Run both API and Web UI
bun run dev

This starts:

Running Separately

# API only
bun run dev:api

# Web UI only (with API proxy)
bun run dev:web

API Endpoints

Authentication

Method Endpoint Description
POST /auth/login Login with email/mobile + password
POST /auth/logout Logout
GET /auth/status Check auth status

Device Management

Method Endpoint Description
POST /devices/discover Discover AC devices
GET /devices List all devices
GET /devices/:id/status Get device status
POST /devices/:id/control Send control command

MQTT

Method Endpoint Description
POST /mqtt/connect Connect to MQTT broker
POST /mqtt/disconnect Disconnect from MQTT
GET /mqtt/status MQTT connection status

Device Control Options

Property Values
power "on", "off"
mode "auto", "cool", "heat", "dry", "fan"
temperature 16 - 30 (°C)
fanSpeed "auto", "low", "medium", "high", "quiet"
verticalSwing "off", "vertical", "horizontal", "both"
nanoe true, false
powerful true, false
economy true, false

Usage Flow

  1. Login with your MirAIe credentials
  2. Discover devices to find your AC units
  3. Connect MQTT to enable real-time control
  4. Control devices via the web UI or API

Credits

Ported from hass-panasonic-miraie by chrissmartin.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages