Why does the network scan find nothing, or almost nothing?

The scanner sees the network it is connected to. On a guest Wi-Fi, a VLAN or with a VPN active you scan that segment instead of your main one, which is the most common cause of a nearly empty list. On macOS, also check System Settings, Privacy & Security, Local Network: if DeviceShelf is not allowed there, a scan returns nothing at all. And give it half a minute: live hosts appear in seconds, names and identification follow.

Why does live bandwidth stay empty or greyed out?

Per-device bandwidth uses packet capture, which needs extra rights: Npcap on Windows, sudo or BPF access on macOS/Linux. Everything else in the app works without it.

Windows warns about an unknown publisher — is the download safe?

SmartScreen shows this warning for unsigned installers. Click More info, then Run anyway. The download's SHA-256 checksum is published next to every release, so you can verify what you run.

Why does the .deb not install on Ubuntu?

A double-clicked .deb opens Ubuntu's App Center, which can fail silently. Install it from the terminal instead: sudo apt install ./DeviceShelf-*.deb.

Why does my license not activate?

Paste the complete token from your purchase e-mail into Settings, License, with no line breaks. Verification runs offline, so no firewall can be in the way. If the token is rejected, reply to the purchase e-mail.

Guide d'installation & de configuration

Opérationnel en quelques minutes. Choisissez votre plateforme, installez, lancez votre premier scan. Une seule licence couvre tous vos appareils.

macOS Windows Linux iPhone & Android Serveur 24/7 Activer la licence Dépannage

macOS notarisé

Téléchargez le .dmg et ouvrez-le.
Glissez DeviceShelf dans votre dossier Applications.
Ouvrez-le depuis le Launchpad ou le dossier Applications. Il est notarisé par Apple, donc il s'ouvre directement, sans avertissement de sécurité.

Prérequis : macOS 12 ou plus récent (Apple Silicon & Intel). La bande passante en direct par appareil demande des droits élevés — voir bande passante en direct. Tout le reste fonctionne d'emblée.

Windows

Téléchargez l'installeur (.exe) — x64 pour Intel/AMD, ou la version ARM64 pour les PC Snapdragon / Copilot+.
Lancez-le. Windows SmartScreen peut signaler un éditeur non vérifié (la version n'est pas signée) : cliquez sur Informations complémentaires → Exécuter quand même.
Suivez l'installeur, puis lancez DeviceShelf.

Pour la bande passante en direct : installez Npcap. Sous Windows, la bande passante par appareil passe par la capture de paquets, qui exige Npcap. L'installeur vous y renvoie ; vous pouvez aussi télécharger Npcap puis relancer DeviceShelf. Le scan, les ports, le rapport de sécurité et tout le reste fonctionnent sans Npcap.

Pour aller plus loin : activer la bande passante en direct.

Linux

DeviceShelf est fourni en AppImage (fonctionne partout, sans installation) et en paquets natifs .deb / .rpm, pour x86-64 et ARM64.

Vous installez le .deb ? Passez par le terminal, pas par le double-clic — sous Ubuntu 24.04, un .deb ouvert par double-clic atterrit dans l'App Center et peut échouer sans rien dire :

sudo apt install ./DeviceShelf-*.deb

Le guide Linux complet (AppImage, .rpm, droits de capture) : Installer sous Linux.

iPhone & Android

DeviceShelf pour iPhone et iPad est sur l'App Store. Android est distribué en APK direct que vous installez vous-même — il n'y a pas de fiche Google Play. Votre clé de licence vaut sur ordinateur comme sur mobile : un seul achat couvre tous vos appareils.

Le faire tourner 24/7 sur un serveur inclus

Pour une surveillance continue, il existe une édition serveur sans interface : dans Docker, via .deb ou comme service Windows. Pointez-la vers les réseaux à surveiller en permanence. Votre licence actuelle la couvre : même clé, aucun surcoût.

Nouveau en 1.5.3 : le serveur inclut un serveur MCP local — connectez Claude, Cursor ou tout agent IA et interrogez votre réseau en langage naturel. Guide de connexion →

Installation, alertes, configuration du jeton et exemples de connexion MCP se trouvent dans le guide serveur.

Home Assistant

L'édition serveur publie vos appareils vers Home Assistant en MQTT. Home Assistant les découvre tout seul : de son côté, rien à installer au-delà de l'intégration MQTT et d'un broker — pas d'add-on, pas de composant personnalisé.

Vérifiez que l'intégration MQTT de Home Assistant pointe bien vers votre broker (l'add-on Mosquitto convient, n'importe quel broker externe aussi).
Dans le tableau de bord du serveur, ouvrez Réglages → Intégrations → Home Assistant, saisissez l'adresse du broker (192.168.1.10:1883 suffit) et ajoutez un utilisateur et un mot de passe si votre broker les exige.
Cochez Publier vers Home Assistant et appuyez sur Tester la connexion. Les entités apparaissent en l'espace d'un intervalle de scan.

Chaque appareil exporté devient un appareil Home Assistant doté d'un capteur de présence, de l'IP et de la latence, avec le fabricant, le modèle, le type, le système et les ports ouverts en attributs. À côté figurent des compteurs réseau et une entité d'événement qui se déclenche à l'arrivée d'un appareil, à sa disparition et à l'ouverture d'un port — une automatisation peut donc réagir dès qu'un appareil inconnu rejoint votre réseau.

Les favoris et l'infrastructure (passerelle, routeurs, commutateurs, points d'accès, NAS, imprimantes) partent automatiquement. Tout autre appareil s'ajoute ou s'exclut individuellement depuis sa fiche détaillée.

Activer votre licence

Après l'achat, vous recevez une clé de licence par e-mail.
Dans l'application : Réglages → Licence, collez la clé, cliquez sur Activer.
Sur iPhone et Android, ouvrez l'e-mail de licence sur l'appareil et touchez le bouton d'activation : le reste se fait tout seul.

Pas de compte, pas de vérification en ligne : l'activation se fait hors ligne. La même clé réactive tous vos autres appareils. Pour aller plus loin : activer DeviceShelf.

Les permissions en un coup d'œil

Fonction	Ce qu'elle demande
Scan, ports, rapport de sécurité, IA	Rien — fonctionne partout, d'emblée
Bande passante en direct par appareil	Windows : Npcap · macOS/Linux : droits élevés (`sudo` ou BPF/`setcap`)
Empreinte DHCP passive	Droits élevés sous macOS/Linux · indisponible sous Windows

Sans eux, l'application tourne quand même : seule la fonction concernée reste inactive.

Quand quelque chose ne fonctionne pas

L'analyse ne trouve rien, ou presque rien

Le scanner voit le réseau auquel il est connecté. Sur un Wi-Fi invité, un VLAN ou avec un VPN actif, vous scannez ce segment au lieu de votre réseau principal — la cause la plus fréquente d'une liste presque vide. Sous macOS, vérifiez aussi Réglages Système › Confidentialité et sécurité › Réseau local : si DeviceShelf n'y est pas autorisé, l'analyse ne renvoie rien du tout. Et laissez-lui une demi-minute — les appareils joignables apparaissent en quelques secondes, noms et identification suivent.

La bande passante en direct reste vide ou grisée

La bande passante par appareil utilise la capture de paquets, qui demande des droits supplémentaires : Npcap sous Windows, sudo ou l'accès BPF sous macOS/Linux. Tout le reste de l'application fonctionne sans. La page bande passante détaille la configuration par plateforme.

Windows signale un éditeur inconnu

SmartScreen affiche cela pour les installateurs non signés. Cliquez sur Informations complémentaires → Exécuter quand même. La somme SHA-256 du téléchargement est publiée à côté de chaque version, pour vérifier ce que vous exécutez.

Le .deb ne s'installe pas sous Ubuntu

Un .deb ouvert par double-clic passe par l'App Center d'Ubuntu, qui peut échouer sans rien dire. Installez plutôt depuis le terminal : sudo apt install ./DeviceShelf-*.deb. Détails sur la page Linux.

La licence ne s'active pas

Collez le jeton complet de votre e-mail d'achat dans Réglages › Licence, sans sauts de ligne. La vérification se fait hors ligne, aucun pare-feu ne peut donc gêner. Si le jeton est refusé, répondez à l'e-mail d'achat et nous réglerons cela.