Philips Hue Tap Dial - Media & Light Controls (Native Hue Hub)
Control your media players and lights with the Philips Hue Tap Dial Switch (RDM002) using the native Philips Hue integration (via Hue Bridge/Hub). No ZHA or Zigbee2MQTT required.
Features
Buttons
All 4 buttons support short press and long press custom actions (the long press action fires once when the button is released).
Default button layout:
| Button 1 - Play/Pause | Button 2 - Custom |
|---|---|
| Button 3 - Previous Track | Button 4 - Next Track |
The default short press behavior for buttons 1, 3, and 4 can be overridden by defining a custom action.
Dial - Three Modes
- Volume Only — Dial always controls media player volume
- Light Only — Dial always controls light brightness
- Smart — Dial controls volume when media is playing, and light brightness when stopped/paused
Separate Volume & Light Configuration
Volume and Light have independent dial settings:
- Small / Medium / Large rotation thresholds
- Small / Medium / Large rotation increments (%)
- Maximum volume / brightness cap
This lets you fine-tune the dial sensitivity for volume and brightness separately.
Separate Volume & Transport Players
You can assign different media players for:
- Volume Player — the speaker whose volume the dial controls (e.g., Google Home, Sonos)
- Transport Player — the player that handles play/pause and track navigation (e.g., Spotify, SpotifyPlus)
This is ideal for setups where Spotify casts to a separate speaker.
HomePods & other players without volume reporting
Some media players (notably HomePods) don't report their current volume to Home Assistant, so the dial can't compute "current volume + increment". The blueprint handles these automatically:
- By default the dial falls back to the device's own volume up/down steps — the number of steps per rotation size (Small/Medium/Large) is configurable, and 0 means "ignore that rotation size"
- For precise percentage-based control, create an
input_numberhelper (range 0–100) and select it as the Volume Helper in the Dial Controls - Volume section — the blueprint then tracks the assumed volume itself, and the %-increments and Maximum Volume cap work just like on a Sonos
Logbook Logging
Enable debug logging to see every event from the Hue Tap Dial in your HA Logbook, including button presses and rotation step values. Useful for tuning your rotation thresholds.
Requirements
- Home Assistant 2024.8.0 or newer
- Philips Hue Bridge (v2) with the native Hue integration
- Philips Hue Tap Dial Switch (RDM002)
Setup
- Import the blueprint using the badge above
- Create a new automation from the blueprint
- Select your Hue Tap Dial Switch device
- Choose your Volume Player and Transport Player (can be the same device)
- Optionally select a Light Entity for dial brightness control
- Set the Dial Behaviour to Volume Only, Light Only, or Smart
- Expand the Dial Controls - Volume and Dial Controls - Light sections to fine-tune rotation sensitivity if needed
- Customize button actions in the Button 1-4 sections as desired
Note: This blueprint is specifically for the native Philips Hue integration (Hue Bridge/Hub). If you use ZHA or Zigbee2MQTT, this blueprint will not work — look for a ZHA-specific version instead.
Version History
| Version | Date | Changes |
|---|---|---|
| 1.00 | Mar 04, 2026 | Initial Release |
| 1.01 | Mar 05, 2026 | Single device selector; all 4 buttons now have customizable short press actions |
| 1.02 | Mar 05, 2026 | Removed model filter from device selector to fix empty device list |
| 1.03 | Mar 05, 2026 | Fixed device selector model filter (Hue integration uses product name as model) |
| 1.04 | Mar 05, 2026 | Added light dimming support with three dial modes: Volume Only, Light Only, Smart |
| 1.05 | Mar 05, 2026 | Fixed Smart dial mode; added max volume/brightness limits; increased default rotation thresholds |
| 1.06 | Mar 06, 2026 | Moved Dial Behaviour to general config; split Volume/Light dial settings; fixed logbook logging |
| 1.07 | Mar 09, 2026 | Fixed event filter condition showing as "Unknown condition" in automation traces |
| 1.08 | Mar 16, 2026 | Fixed long press actions never firing; now uses long_release event instead of unreliable repeat; removed redundant long_release inputs |
| 1.09 | Jun 05, 2026 | Fixed dial volume on players that don't report volume_level (e.g. HomePods via HomeKit Controller): falls back to the device's relative volume_up/volume_down (scaled by rotation size) instead of setting an absolute level; precise %-control kept for players that do report it (Sonos, etc.) |
| 1.10 | Jun 12, 2026 | Finer dial volume control for players that don't report volume_level (e.g. HomePods): optional Volume Helper (input_number) restores precise %-increments and the Maximum Volume cap; fallback device-step counts per rotation size are now configurable (0 = ignore) |
