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.

Guía de instalación y configuración

Todo listo en un par de minutos. Elige tu plataforma, instala y lanza el primer escaneo. Una licencia cubre todos tus dispositivos.

macOS Windows Linux iPhone y Android Servidor 24/7 Activar la licencia Solución de problemas

macOS notarizado

Descarga el .dmg y ábrelo.
Arrastra DeviceShelf a tu carpeta Aplicaciones.
Ábrelo desde Launchpad o desde Aplicaciones. Está notarizado por Apple, así que se abre sin más, sin aviso de seguridad.

Requisitos: macOS 12 o posterior (Apple Silicon e Intel). El ancho de banda en vivo por dispositivo necesita permisos elevados — consulta ancho de banda en vivo. Todo lo demás funciona de entrada.

Windows

Descarga el instalador (.exe) — x64 para Intel/AMD, o la versión ARM64 para PC Snapdragon / Copilot+.
Ejecútalo. Windows SmartScreen puede avisar de que el editor no está verificado (la compilación no está firmada): haz clic en Más información → Ejecutar de todas formas.
Sigue el instalador y abre DeviceShelf.

Para el ancho de banda en vivo: instala Npcap. En Windows, el ancho de banda por dispositivo se obtiene capturando paquetes, y eso requiere Npcap. El instalador te lleva a él; también puedes descargar Npcap y reiniciar DeviceShelf. El escaneo, los puertos, el informe de seguridad y todo lo demás funcionan sin Npcap.

Más: activar el ancho de banda en vivo.

Linux

DeviceShelf se distribuye como AppImage (funciona en cualquier sitio, sin instalar) y como paquetes nativos .deb / .rpm, para x86-64 y ARM64.

¿Vas a instalar el .deb? Usa la terminal, no el doble clic — en Ubuntu 24.04 un .deb abierto con doble clic acaba en el App Center y puede fallar sin decir nada:

sudo apt install ./DeviceShelf-*.deb

La guía completa de Linux (AppImage, .rpm, permisos de captura): Instalar en Linux.

iPhone y Android

DeviceShelf para iPhone y iPad está en la App Store. Android se distribuye como APK directo que instalas tú mismo: no hay ficha en Google Play. Tu clave de licencia sirve en escritorio y en móvil, así que una compra cubre todos tus dispositivos.

Ejecutarlo 24/7 en un servidor incluido

Para una vigilancia continua existe una edición de servidor sin interfaz: en Docker, mediante .deb o como servicio de Windows. Apúntala a las redes que quieras vigilar a todas horas. Tu licencia actual la cubre: la misma clave, sin coste extra.

Nuevo en 1.5.3: el servidor incluye un servidor MCP local — conecta Claude, Cursor o cualquier agente de IA y pregunta por tu red en lenguaje natural. Guía de conexión →

La instalación, las alertas, la configuración del token y los ejemplos de conexión MCP están en la guía del servidor.

Home Assistant

La edición de servidor publica tus dispositivos en Home Assistant por MQTT. Home Assistant los descubre solo, así que de su lado no hay que instalar nada más allá de la integración MQTT y un broker: ni add-on, ni componente propio.

Comprueba que en Home Assistant la integración MQTT apunta a tu broker (sirve el add-on de Mosquitto, y también cualquier broker externo).
En el panel del servidor abre Ajustes → Integraciones → Home Assistant, escribe la dirección del broker (192.168.1.10:1883 basta) y añade usuario y contraseña si tu broker los pide.
Marca Publicar en Home Assistant y pulsa Probar conexión. Las entidades aparecen en un intervalo de escaneo.

Cada dispositivo exportado se convierte en un dispositivo de Home Assistant con un sensor de presencia, la IP y la latencia, y lleva fabricante, modelo, tipo, sistema y puertos abiertos como atributos. Junto a ellos hay contadores de red y una entidad de evento que se dispara con dispositivos nuevos, con dispositivos que desaparecen y con puertos recién abiertos, así que una automatización puede reaccionar cuando un aparato desconocido entra en tu red.

Los favoritos y la infraestructura (puerta de enlace, routers, switches, puntos de acceso, NAS, impresoras) se publican automáticamente. Cualquier otro dispositivo se añade o se excluye uno a uno desde su vista de detalle.

Activa tu licencia

Tras la compra recibes una clave de licencia por correo.
En la aplicación: Ajustes → Licencia, pega la clave y haz clic en Activar.
En iPhone y Android, abre el correo de la licencia en el dispositivo y toca el botón de activación: el resto va solo.

Sin cuenta y sin comprobación en línea: la activación es offline. La misma clave activa también todos tus demás dispositivos. Más: activar DeviceShelf.

Los permisos de un vistazo

Función	Qué necesita
Escaneo, puertos, informe de seguridad, IA	Nada: funciona en todas partes, de entrada
Ancho de banda en vivo por dispositivo	Windows: Npcap · macOS/Linux: permisos elevados (`sudo` o BPF/`setcap`)
Huella DHCP pasiva	Permisos elevados en macOS/Linux · no disponible en Windows

Sin ellos la aplicación funciona igualmente: solo queda inactiva la función correspondiente.

Cuando algo no funciona

El escaneo no encuentra nada, o casi nada

El escáner ve la red a la que está conectado. En un Wi-Fi de invitados, una VLAN o con una VPN activa escaneas ese segmento en lugar de tu red principal: la causa más común de una lista casi vacía. En macOS, revisa además Ajustes del Sistema › Privacidad y seguridad › Red local: si DeviceShelf no está permitido ahí, el escaneo no devuelve nada. Y dale medio minuto: los equipos alcanzables aparecen en segundos; nombres e identificación llegan después.

El ancho de banda en directo queda vacío o gris

El ancho de banda por dispositivo usa captura de paquetes, que requiere permisos adicionales: Npcap en Windows, sudo o acceso BPF en macOS/Linux. Todo lo demás en la app funciona sin ello. La página de ancho de banda explica la configuración por plataforma.

Windows avisa de un editor desconocido

SmartScreen lo muestra con instaladores sin firmar. Haz clic en Más información → Ejecutar de todas formas. La suma SHA-256 de la descarga se publica junto a cada versión, para que compruebes lo que ejecutas.

El .deb no se instala en Ubuntu

Un .deb abierto con doble clic pasa por el App Center de Ubuntu, que puede fallar sin avisar. Instálalo desde el terminal: sudo apt install ./DeviceShelf-*.deb. Detalles en la página de Linux.

La licencia no se activa

Pega el token completo del correo de compra en Ajustes › Licencia, sin saltos de línea. La verificación funciona sin conexión, así que ningún cortafuegos puede interferir. Si el token es rechazado, responde al correo de compra y lo resolvemos.