Skip to content
AutomationHub
back to the app directory

DataForge

// sniffs the port, decodes the telegrams, judges nothing

DataForge app icon

TCP Protocol Monitor — “The Silent Witness”

WindowsLinuxElectron

Point it at a host and a port and DataForge watches every byte that crosses it — framed, decoded, laid out in a live message feed. It is a monitor for the protocols that never shipped a manual: your wire layout in a TOML template, your telegrams in words humans can read.

Templates describe the wire byte by byte — field, offset, size, endianness — and the decoder turns each frame into a line like src=SRC123 piece=PIECE-0042 cell=0007. Frames no template claims show up as UNMATCHED, which is how you find the telegrams you forgot about.

Screenshots

// numbered drop-in — 01.png, 02.png, … — whatever exists, shows

// screenshots pending — drop 01.png+ into apps/dataforge/

Features

  • Live monitor. Connect to a host and a port, pick the framing delimiter — STX/ETX, CRLF, whatever your protocol uses — and watch the feed.

  • Message decoder. TOML templates map the wire layout to readable output: field name, offset, size, endianness, a colour per telegram type.

  • Ships with templates. The SICK/Körber scanner protocol and the AMZ line are in the box; the template editor handles the protocol you invented yourself.

  • Feed with a filter bar. Search, per-telegram-type toggles, and an UNMATCHED switch for the frames nobody claimed.

  • Logging and replay. Dump the raw stream to a hex file, then replay that hex file through the same decoder. Same bytes, second opinion.

  • Update check. The app checks the releases feed and offers the new build; the factory remembers you.

Requirements

  • Windows or Linux. That is the whole list. The installer bundles the runtime — nothing to install, nothing to configure, just a port to point at.

  • Build from source. Node.js 20+, then:

    npm install
    npm run package:linux   # or: npm run package:win

Tech stack

Shell Electron 41 (electron-vite)
UI React + Tailwind
Decoder TOML templates (smol-toml), YAML (js-yaml)
Packaging electron-builder + block maps
Updates electron-updater against the Gitea releases feed

Notes from the factory

The Silent Witness sees everything on its port and reports to no one — the feed is local, the logs are yours.

Templates only decode what you have described. A frame no template claims shows up as UNMATCHED rather than guessed at: no template has ever been seen to hallucinate a field.