Pimatic plugin for tradfri support

Usage no npm install needed!

<script type="module">
  import pimaticTradfri from 'https://cdn.skypack.dev/pimatic-tradfri';



build status version downloads license

This plugin provides a tradfri interface for pimatic.

IMPORTANT: This plugin needs at least gateway version 1.2.42 !


  • Discover devices, groups, and scenes
  • Tradfri Hub as presence device available
  • Control lights
  • Control groups
  • Observe changes
  • Scenes/moods per Group
  • Action providers for all features
  • All bulbs are supported (RGB / color temperature)


Just activate the plugin in your pimatic config. The plugin manager automatically installs the package with his dependencies.

Software dependencies

This plugin depends on tradfri-coapdtls.


You can load the plugin by adding following in the "plugins" section in config.json from your pimatic server:

You only need the security id which is backside of the gateway (i.e. Security Code) and the gateway's IP address. At startup the plugin discovers the gateway.

  "plugin": "tradfri",
  "secID": "GATEWAY KEY",
  "hubIP": "GATEWAY IP"

Configuration after discovery.

  "plugin": "tradfri",
  "secID": "GATEWAY KEY",
  "hubIP": "GATEWAY IP",
  "identity": "",
  "psk": "",
  "debug": true


Install the tradfri gateway in your network and make an normal initialization over the trafri smartphone app. If wanted with groups.

After the lights are paired with the gateway, go to the pimatic screen and make an autodiscover.


set color temp <dev> to <colortemperature> (0-100)
set color rgb <dev> to <#0011ff> (rgb value in hex with leading hash )

Note that you can also use the standard pimatic actions for dimmers, sensors and switches.
See https://pimatic.org/guide/usage/rules/ for examples.

Example: dim <dev> to <dimpercentage>


The first connection to the gateway creates a session key. This key with a uniq identifier is automatically stored in the configuration file. If you have problems with your connection, remove the psk from the config.

Sometimes the Tradfri Gatway doesn't inform the observers about new devices states. I think that the stability of the gateway in newer firmware versions is improved.

If you press the power button of the 5-button remote, the remote toggles the group. So if the lights are not syncron, the lights will change the state not in same way.


  • firmware updates