kohler

Python library for controlling Kohler DTV+ shower systems over your local network.

Features

• 🚿 Full shower control (start, stop, quick shower with valve configuration)
• 💡 Light module control with adjustable intensity
• 🎵 Music playback with volume control
• 🌧️ Chromatherapy rain effects (color or experience modes)
• ♨️ Steam control with temperature and duration
• 👤 User session management
• 🔧 System info, firmware updates, error logs, and factory reset
• 📤 Firmware upload via multipart POST
• ✅ Fully typed with inline type hints (PEP 561)

Installation

pip install kohler

From source (development):

git clone https://github.com/niemyjski/kohler-python.git
cd kohler-python
pip install -e ".[dev]"

Quick Start

import asyncio
from kohler import Kohler

async def main():
    kohler = Kohler(kohler_host="192.168.1.50")
    
    # Shower control
    await kohler.quick_shower()
    await kohler.stop_shower()

    # Lights
    await kohler.light_on(module=1, intensity=75)
    await kohler.light_off(module=1)
    
    # Music
    await kohler.music_on(volume=80)
    await kohler.music_off()

    # Steam
    await kohler.steam_on(temp=110, time=10)
    await kohler.steam_off()

    # Chromatherapy rain
    await kohler.rain_on(color=120)
    await kohler.rain_off()

asyncio.run(main())

API Reference

Initialization

Shower Control

Lighting

Music

Steam & Rain

System & Configuration

Diagnostics

Error Handling

The library raises KohlerError when communication with the device fails unexpectedly:

import asyncio
from kohler import Kohler, KohlerError

async def main():
    kohler = Kohler(kohler_host="192.168.1.50")

    try:
        await kohler.system_info()
    except KohlerError as e:
        print(f"Device communication error: {e}")

asyncio.run(main())

Contributing

# Clone and install dev dependencies
git clone https://github.com/niemyjski/kohler-python.git
cd kohler-python
pip install -e ".[dev]"

# Run checks
ruff check .          # Lint
ruff format --check . # Format check
mypy kohler/          # Type check
pytest -v             # Tests

Disclaimer

USE AT YOUR OWN RISK. This library interacts with a physical water, steam, and electrical device (Kohler DTV+). The authors and contributors of this library are NOT affiliated with Kohler Co. and are NOT responsible for any damage, leaks, burns, flooding, or hardware failures that may occur from the use of this software. You are solely responsible for setting safe maximum temperatures and using this integration safely.

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.