Bring the best of OSS JavaScript development to your projects with npm Orgs - private packages & team management tools.Learn more »


0.1.22 • Public • Published


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 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
  • more actionproviders


  • 0.1.6 - first public alpha version

  • 0.1.7 - New functions:

    • Control light temperature
    • Observing changes
    • Goup function
    • Gateway check
    • Support for more lights
    • code refactoring
    • bugfixes
  • 0.1.8:

    • code refactoring
    • autoreconnect
    • bugfixes
  • 0.1.9:

    • Scenes/Moods
    • Stepless light temperature change
    • New device option: transition time for smooth changes
    • Action provider for all features
  • 0.1.10:

    • BUG FIX
  • 0.1.11:

    • Remote and motion sensor as presence device with battery observation
    • BUG FIX
  • 0.1.12:

    • BUG FIX (#12) (#10)
    • RGB Support
    • Dimming slider for groups
  • 0.1.13:

    • BUG FIX
  • 0.1.14:

    • Support for gateway version 1.2.42
  • 0.1.15:

    • BUG FIX (#18)
    • compatibility warning removed
  • 0.1.16:

    • BUG FIX (#19)
    • Reboot and pairing mode buttons for hub device
    • Floalt Support added
    • auto discovery of the gateway at startup
  • 0.1.17:

    • Hotfix dependency bug
  • 0.1.18:

    • some small changes
  • 0.1.19:

    • add support for smart wall plugs (beta)
  • 0.1.20:

    • fix for smart wall plugs
  • 0.1.21:

    • hotfix for smart wall plugs
  • 0.1.22:

    • hotfix for tradfri gateway version 1.8.25
    • you must remove the identity and psk config parameters after upgrade





npm i pimatic-tradfri

Downloadsweekly downloads









last publish


  • avatar
Report a vulnerability