Skip to content

Repository files navigation

Teufel Raumfeld

GitHub Downloads HACS Default hassfest CodeQL

Home Assistant integration for Teufel Smart Speakers (Raumfeld multiroom system). Control your Teufel speakers directly from Home Assistant — volume, playback, groups, and more.

The API logic lives in the companion library hassfeld.


Features

  • Media control — Play, Pause, Stop, Next, Previous, Shuffle, Repeat, Seek
  • Volume — per-room and global, with configurable step sizes
  • Source selection — Line-In, Spotify, Tidal, Internet radio, Podcasts, local music
  • Room groups — Combine rooms into groups, control via services
  • Snapshots — Save and restore playback state
  • Announcements — System sounds and TTS announcements via the play_sound service
  • Auto-discovery — Rooms and groups detected automatically
  • Config-Flow — Set up directly through the Home Assistant UI

Supported platforms: media_player, sensor, select, number


Installation

HACS (recommended)

  1. Make sure HACS is installed
  2. HACS → Integrations → Search for Teufel Raumfeld and install
  3. Restart Home Assistant

Manual

Download the latest release and extract it to /config/custom_components/teufel_raumfeld/.

Then restart Home Assistant.


Configuration

After installation:

  1. Settings → Devices & Services → Add Integration
  2. Select Teufel Raumfeld
  3. Enter the hostname/IP of your Raumfeld host (default port: 47365)
  4. The integration auto-discovers rooms and groups

Links

Documentation Wiki
Issue tracker GitHub Issues
Discussions GitHub Discussions
Source code GitHub
hassfeld (API) GitHub

License

GNU General Public License v3 (GPLv3)

About

Integration for Teufel smart speaker (aka Raumfeld Multiroom) into https://www.home-assistant.io/.

Topics

Resources

Stars

43 stars

Watchers

11 watching

Forks

Releases

Packages

Used by

Contributors

Languages