mordomus

Python client for the Mordomus / iThink home-automation HTTP API.

pip install mordomus

from mordomus import Mordomus

with Mordomus("http://192.168.8.46:8888", user="user", password="1234") as home:
    for light in home.devices.lights():
        print(light.cod, light.name, light.value)

    home.devices.on("MDO17")
    home.devices.set_value("MDO17", 100)
    home.climate.set_temperature(room=2, celsius=22)

Async:

import asyncio
from mordomus import AsyncMordomus

async def main():
    async with AsyncMordomus("http://192.168.8.46:8888", user="user", password="1234") as home:
        states = await home.devices.states()
        print(states)

asyncio.run(main())

Auth

Login is session-cookie based (IDHTTPSESSIONID). Credentials are hashed as:

value  = md5(timestamp_ms + username.lower()) + md5(timestamp_ms + password)
value1 = str(3 * timestamp_ms)
GET /logas?value=...&value1=...

The client handles this automatically and re-authenticates on 401.

API surface

Home Assistant

Separate package: mordomus-homeassistant

pip install mordomus-homeassistant
mordomus-ha install /config          # or: mordomus-ha install ~/.homeassistant
# restart Home Assistant → Add integration → Mordomus

See home-assistant/README.md.

Development

uv sync
uv run pytest

Publish to PyPI

Two packages, two versions (keep them in sync for paired releases):

# 1. Bump version in pyproject.toml (+ home-assistant/pyproject.toml + manifest.json)
# 2. Build + upload (API token required)
export UV_PUBLISH_TOKEN=pypi-...
./scripts/publish.sh both            # production PyPI
./scripts/publish.sh both --test     # TestPyPI first
./scripts/publish.sh lib --dry-run   # build only

Or publish from GitHub Actions on release (trusted publishing) — see .github/workflows/publish.yml.