DeviceShelf — Linux
===================

Local-first network scanner & device discovery. Everything runs on your
machine: no account, no telemetry, no cloud.

Starting the app
----------------
  • From your application menu: search "DeviceShelf" (category: Network).
  • From a terminal:            deviceshelf

Live bandwidth & passive DHCP (optional)
----------------------------------------
These two features use packet capture, which needs elevated rights. Grant the
capability once (recommended — no need to run the whole app as root):

    sudo setcap cap_net_raw,cap_net_admin+eip /usr/bin/deviceshelf

Everything else — network scan, port scan, security report, AI device ID,
traceroute/ping/DNS/speed-test, export — works without any extra privileges.

About that "Permission denied (13)" note during install
-------------------------------------------------------
If you installed the package from your home folder with `apt install ./file.deb`
(or dnf), the package manager may print:

    N: Download is performed unsandboxed as root ... couldn't be accessed by
       user '_apt' ... Permission denied (13)

This is a NOTE, not an error. The unprivileged helper user (_apt) can't read a
file inside your home directory, so the package manager reads it as root and
installs normally. Your package is installed (you'll see "Setting up
deviceshelf" above it). To avoid the note, install from a world-readable path,
e.g. /tmp.

Supported platforms
-------------------
Built against glibc >= 2.34, GTK 3, webkit2gtk-4.1 and libpcap, for amd64 and
arm64. The .deb suits Debian/Ubuntu/Mint/Pop!_OS; the .rpm suits Fedora 40+ /
openSUSE. On other distributions, use the AppImage (no install needed:
`chmod +x DeviceShelf-*.AppImage && ./DeviceShelf-*.AppImage`).

Privacy — verify it yourself
----------------------------
With the optional online features off, DeviceShelf makes no connection to a
DeviceShelf server (no telemetry, no update check, no online license check; the
licence verifies offline). Step-by-step verification (tcpdump etc.):

    https://deviceshelf.app/privacy#verify

Support: hello@deviceshelf.app
