Philips Hue Tap Dial - Media Controls (Native Hue Hub)

Blueprints Exchange
1

Philips Hue Tap Dial - Media & Light Controls (Native Hue Hub)

Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.

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, long press (repeat), and long release custom actions.

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.

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

  1. Import the blueprint using the badge above
  2. Create a new automation from the blueprint
  3. Select your Hue Tap Dial Switch device
  4. Choose your Volume Player and Transport Player (can be the same device)
  5. Optionally select a Light Entity for dial brightness control
  6. Set the Dial Behaviour to Volume Only, Light Only, or Smart
  7. Expand the Dial Controls - Volume and Dial Controls - Light sections to fine-tune rotation sensitivity if needed
  8. 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

Source

GitHub Gist