vedetta

Home Assistant app: a local network scanner that finds, recognizes and explains every device on your LAN (name, brand, model, presence, latency). No cloud, no accounts.

Automatically checked · GitHub checked 2026-11-13

vedetta

Overview

Vedetta — know every device on your network

Your router says “Unknown device”.
Vedetta tells you what it is — and shows you why.

A Home Assistant app that finds the devices on your LAN, works out what each one is, and shows the evidence.

No cloudNo accountsNo telemetryRead-only access to Home AssistantExports masked before they are createdOpen source (MIT)

Home Assistant Version License OpenSSF Scorecard Live Demo

🌐 Try Live Demo · Install in 2 minutes · How it explains itself · Report a device · Docs · Roadmap

🌐 Try the live interactive demo — experience Vedetta with 39 household devices directly in your browser. No installation or setup required.

Vedetta dashboard on a computer in tile view, dark theme, with the phone list view in light theme in front of it

Tiles or list · light or dark · one tap to the evidence behind every name


What is Vedetta

You have a few dozen devices on your network. Your router lists their IP addresses and, if you are lucky, a name like Android_7F3A or “Unknown device”. Home Assistant knows some of them. The rest are a guess.

Vedetta is the lookout of your LAN. It does three things, in this order:

🔭 Discover🧠 Recognize🔎 Explain
Finds every device on your network, with presence and latency history.Works out name, brand, model and category from many weak clues, and stays honest when it does not know.For every answer, shows the clues behind it and how much each one counted.

It is a Home Assistant app (not a custom integration): install it from the App store, no YAML. It reads Home Assistant’s registry to learn the names and rooms you already chose, and publishes back only what you decide to share.

Not another network scanner

A scanner gives you a list. Vedetta gives you an answer and the reason. The same device, seen two ways (an example):

A typical scannerVedetta
What you see192.168.1.23 · AA:BB:CC:… · Espressif Inc.Kitchen light · Shelly · smart switch
When it is not sure“Unknown device”, Android_7F3AIt says so and keeps the device in Other
Why that nameNot explainedEvery clue behind it is one tap away, with its weight
What you set by handCan be lost at the next scanIs never overwritten

Show your work

Every clue is weak on its own. Vedetta weighs them together, counts a repeated fact once, and shows doubt as doubt. The weights are public.

Ten weak clues are fused by family into name, brand, model, category and area; your own choice is never overwritten, and debug mode shows the reason

The pop-up of the Type shows each clue with its weight and the hypotheses that were rejected

Tap the (i) next to a name, brand or type: every clue, its weight, and what was ruled out

Sources, weights and certainty bars: Recognition.

🐞 A device is wrong or unknown? Tell me.

Report a device

Every report is read and becomes a fix or a new recognition rule, and Vedetta is updated. Attach the encrypted export: it is safe to post.

Want to do more? Teach it a device.

[!IMPORTANT] Give it a day or two. Right after the install Vedetta only knows what it could see in the first minutes. Phones sleep, names are announced now and then, and the presence history is what tells a phone with a changing MAC from a fixed device. A deep search also runs by itself every night at 03:00. Please leave it running for 24 hours (48 is better) before judging a device. Why, and what to do if one is still wrong.

Install

[!NOTE] Needs Home Assistant OS or Supervised (Settings shows Apps). Home Assistant Container or Core has no app store.

  1. Add the repository with this button, or add https://github.com/Sived80/vedetta by hand in the App store:

    Add the Vedetta repository to my Home Assistant

  2. Search Vedetta in the App store and press Install.

  3. Switch on Show in sidebar, press Start, open Vedetta and press Scan network.

Step by step, the local-app option and the first launch: Installation.

⭐ If Vedetta names your devices right, a star helps others find it. Watch → Custom → Releases tells you when a new version comes out.

☕ Support the project

Vedetta is free and open source, and it stays that way. If it saved you time, you can help to keep it going:

Support Vedetta on Ko-fi

Gallery

Vedetta dashboard on a computer with the phone view in front of it, in light and dark theme and in tile and list view, changing one after the other

Tiles or list · light or dark · computer or phone

Also inside

📱 Sleeping phones remembered · 📊 Presence and latency history · 🔭 Three search levels, you choose the risk · 🏠 Home Assistant and optional MQTT · 🌐 Devices on other networks, seen through Home Assistant · 🩺 A network doctor: duplicate addresses, repeated restarts, devices that drop together, a slower gateway

All the details: How Vedetta works.

🌍 Your language?

Vedetta speaks English, Italian, Czech and German (thanks to the community for the Czech; the German is a first translation, not yet read by a native speaker). Adding yours takes no code: copy the en folder, translate the texts, open a pull request. Step by step →

Documentation

PageWhat it covers
InstallationBoth install options, first launch, updating, permissions
How Vedetta worksWhat it is, features, search methods
RecognitionSources, weights, certainty bars, phones
Home Assistant · MQTTThe two directions of the integration, MQTT setup
Networks seen by Home AssistantShowing the devices of other networks (VLANs) through your router integration, without probing them
Privacy and safetyWhat stays local, exports, reporting a mistake
TroubleshootingThe first 24 hours, common problems
RoadmapWhat is done, with date and version, and what is planned
How Vedetta is testedReal exports replayed, a virtual LAN, the numbers of the last release
DevelopmentTeach it a new device or logo, tests, stack
ChangelogEvery version

📜 License and credits

Vedetta is open source under the MIT License. Everything it builds on is listed, with its license, in THIRD_PARTY_NOTICES.md.

  • 🧰 Nmap and arp-scan are installed from the Alpine package repository when the app is built on your Home Assistant. They are not included in this repository; Vedetta runs them as separate programs.
  • 🏭 MAC vendor names come from the public IEEE registries; icons from Material Design Icons (Apache-2.0).
  • ™️ Brand and product names are used only to describe the devices Vedetta recognizes. This project is not affiliated with or endorsed by any of them.