Dart · Library · Apache-2.0

matter_dcl

A Dart package that turns the vendor and product numbers a Matter device broadcasts into real names, using the official Matter registry.

View on GitHub View on pub.dev

Every Matter light tells you two numbers: one for the company and one for the product. This is the code the Firedance app uses to turn them into something a person recognises, like “WiZ P45.E27”.

It looks them up in the Distributed Compliance Ledger, the public registry run by the Connectivity Standards Alliance. Every certified Matter product is listed there, so one lookup covers every brand.

What it looks like

Here’s the package’s own example and what it printed when we ran it against the live registry:

The matter_dcl example looking up vendor 0x1423 and product 8580, and the output: Feit, WiZ P45.E27 and Signify WiZ P45.E27

The first line shows why the names need care. Vendor 0x1423 is Feit Electric, the company that registers LIFX lights, so a raw lookup would show “Feit” for a LIFX bulb. deviceName joins the company and product the way people expect, and the registry’s product and support links come back too when the maker has filled them in.

Built for an app, not a script

  • Lookups never throw. An unregistered number, a timeout or a bad response all come back as “not found”, so a lookup can’t crash a pairing screen.
  • Results are cached. The same light is only looked up once, which matters when a room has twenty of the same bulb.
  • It runs anywhere Dart does. Flutter on phones and computers, and Dart on servers.

We use it in the Firedance app to name lights as they join, and to tell people which brand a light is when its box has long gone.

Get started

dart pub add matter_dcl

Full instructions are in the README on GitHub.

Read the announcement: matter_dcl: a Matter device lookup for Dart.

Get updatesGet the early-bird price

Firedance isn't available yet. Leave your email and we'll let you know when it launches.

Leave your email and you'll hear first when Firedance launches, so you can get the early-bird price.