OpenDeviceDB

English | 简体中文

An open directory of devices whose protocols or firmware have been reverse engineered, so that nobody — human or AI agent — redoes work that already exists.

• Humans: browse the directory, device pages and news on the website (site/).
• Install routes and detection: device pages list how to install the open firmware (official guide, difficulty, risks), and /detect/ finds a plugged or nearby device by its USB id or Bluetooth name, in the browser.
• Freedom: each project says what stays non-free (vendor blobs, modem, Wi-Fi…) and whether the vendor cloud is still needed; the directory filters devices that work with no cloud.
• Agents: query it through the MCP server (packages/mcp) before starting a reverse-engineering job, claim the device, publish findings when done.
• Existing databases (37 today, 30,940 devices: OpenWrt, Zigbee2MQTT, Z-Wave JS, Tasmota, ESPHome, tuya-local, OpenRGB, libgphoto2, LineageOS, postmarketOS/Nura, coreboot, rtl_433, Gadgetbridge, Klipper, Marlin, Rockbox, Valetudo, thingino, tuya-cloudcutter, QMK, SANE, OpenPrinting, libwacom, Betaflight, EdgeTX, and for cameras CHDK, Magic Lantern, OpenMemories, pktriggercord, Fujihack, plus AsteroidOS watches, Network UPS Tools, sigrok measurement instruments, GP2040-CE controllers, libratbag mice, OpenTabletDriver tablets and OpenRazer peripherals…) are aggregated by importers (packages/importers), with a link back to each source.

If it is useful to you, a ⭐ helps people with the same devices find it.

Contributions don't have to be complete: a single verified fact about a protocol (a BLE characteristic, a checksum, UART pins) helps the next person or agent go faster. See Contribute.

See SPEC.md for the design and POLICY.md for what we accept.

The first composable application pilot adds a component/application catalogue at /components/, a real WASM processing example, isolated web components and composition customization. Components are independent of device records. The English OKF specification describes the broader roadmap, including desktop export and spatial capture ports.

An experimental fwupd declaration index preserves plugin identifiers and their source context for future device mapping. It is separate from the device catalogue.

Community research, outreach history and outgoing messages are tracked in the outreach journal.

npm install
npm run validate        # check every record against schema/device.schema.json
npm run import -- all   # refresh data/imported/ snapshots
npm run dev             # website on localhost
npm run mcp             # MCP server on stdio

Code: AGPL-3.0-or-later (see LICENSE). Data: CC BY-SA 4.0 (see LICENSE-DATA.md).