Guía de instalación y configuración

1. Descarga el .dmg y ábrelo.
2. Arrastra DeviceShelf a tu carpeta Aplicaciones.
3. Á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.

1. Descarga el instalador (.exe) — x64 para Intel/AMD, o la versión ARM64 para PC Snapdragon / Copilot+.
2. 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.
3. 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.

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.

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.

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.

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.

1. 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).
2. 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.
3. 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.

Tu router conoce dispositivos que el escaneo no alcanza: móviles en reposo, dispositivos en otra VLAN. DeviceShelf puede leer la lista de clientes directamente del router, en el ordenador, en el móvil y en el servidor. Cada uno pregunta al router por su cuenta; nada pasa por nuestros servidores.

1. Abre Ajustes → Router / controlador (aplicación de escritorio y panel del servidor) o Ajustes → Router en el móvil.
2. Elige la marca de tu router o deja Detectar automáticamente. Si el router es tu puerta de enlace, deja la dirección vacía.
3. Escribe lo que pide la nota bajo la marca. La mayoría de los routers domésticos (FRITZ!Box, ASUS, Netgear, TP-Link …) piden la contraseña de su interfaz web. Controladores como UniFi, pfSense, OPNsense, FortiGate y Omada suelen pedir una clave de API.
4. Pulsa Probar conexión. Verás qué marca respondió y cuántos dispositivos devolvió.

La contraseña se queda en tu dispositivo (Llavero en el Mac, el almacenamiento seguro del sistema en iPhone y Android, un archivo cifrado en Windows y Linux) y solo se envía a tu router. Algunos routers solo hablan HTTP sin cifrar dentro de la red; entonces cualquiera que escuche en ella puede leer el inicio de sesión.

ASUS: DeviceShelf pregunta primero por HTTPS. Si la prueba de conexión avisa de HTTP sin cifrar, activa HTTPS en el router en Administration → System → Local Access Config.

Probados con hardware real hasta ahora: UniFi y Zyxel. Las demás marcas se basan en las interfaces que documentan los fabricantes. Si tu router no responde como esperas, escríbenos.

1. Tras la compra recibes una clave de licencia por correo.
2. En la aplicación: Ajustes → Licencia, haz clic en Pegar y activar. O pega la clave tú mismo y haz clic en Activar.
3. En iPhone y iPad no hay campo para la clave: abre el correo de la licencia en el dispositivo y toca el botón de activación, o activa primero en el escritorio y escanea su código QR (Ajustes → Licencia → Activar en tu teléfono) con la cámara del iPhone. En Android también funciona, o pega la clave en Ajustes → Licencia.
4. Edición servidor: pega la misma clave en el panel del servidor en Ajustes → General → Licencia, o define DEVICESHELF_LICENSE en el entorno (Docker, .deb, servicio de Windows).

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.

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

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.

macOS

1. Si configuraste el ancho de banda en directo: abre Ancho de banda en DeviceShelf y pulsa Quitar el acceso BPF. Te pide la contraseña de administrador y elimina el programa auxiliar que Ajustes del Sistema muestra como DeviceShelf-Helper. Ajustes del Sistema puede seguir mostrando la entrada hasta que reinicies el Mac.
2. Cierra DeviceShelf y arrástralo de Aplicaciones a la Papelera. La entrada «abrir al iniciar sesión» desaparece con la app.
3. Para borrar también la lista de dispositivos, los ajustes y las contraseñas guardadas, elimina la carpeta ~/Library/Application Support/DeviceShelf.

Las versiones anteriores guardaban las contraseñas en el llavero. Para quitarlas también, abre Acceso a Llaveros, busca DeviceShelf y borra las entradas que aparezcan.

¿Ya moviste la app a la Papelera con el ancho de banda en directo configurado? Estos comandos en Terminal eliminan el programa auxiliar:

sudo launchctl bootout system /Library/LaunchDaemons/app.deviceshelf.ChmodBPF.plist
sudo rm -f /Library/LaunchDaemons/app.deviceshelf.ChmodBPF.plist
sudo rm -rf "/Library/Application Support/DeviceShelf"
sudo chown root /dev/bpf*

Windows

1. Abre Configuración → Aplicaciones → Aplicaciones instaladas, busca DeviceShelf y elige Desinstalar.
2. La lista de dispositivos y los ajustes se quedan en %AppData%\DeviceShelf. Borra esa carpeta para eliminarlos también.
3. Npcap tiene su propia entrada en la misma lista. Quítalo solo si ningún otro programa del PC lo usa, por ejemplo Wireshark.

Linux

1. AppImage: borra el archivo. Paquete: sudo apt remove deviceshelf (.deb) o sudo dnf remove deviceshelf (.rpm).
2. La lista de dispositivos y los ajustes están en ~/.config/DeviceShelf. Borra esa carpeta para eliminarlos también.

• Instalar en Linux
• Ejecutar la edición de servidor 24/7
• Activar el ancho de banda en vivo
• Activa tu licencia
• Versiones anteriores y vuelta atrás
• Preguntas frecuentes
• ¿Sigues atascado? Escríbenos

• Ver todos los dispositivos de la red y encontrar su dirección IP
• ¿Quién está en mi Wi-Fi? Ver todos los dispositivos
• Protege tu red doméstica paso a paso
• Qué significa realmente un puerto abierto
• Encuentra dispositivos IoT en tu red
• Por qué tu móvil muestra una dirección MAC aleatoria
• Escanear una red en Windows
• Escanear una red desde Linux
• Monitorización de red autoalojada