rtplot — real-time plotting over ZMQ

rtplot pushes live data from a Python script to a browser plot — locally or across a network — in a few lines of code. The plot page also hosts interactive widgets (buttons, sliders, dials, numeric / text displays) that feed values back to the sender in real time.

Typical use: a robot or data-acquisition script runs on a Raspberry Pi, and you watch signals and tweak gains from a laptop on the same Wi-Fi.

How it works

Two processes talking over ZMQ, plus a browser viewer:

flowchart TD
    script["Your Python script<br/>send_array() · poll_controls()"]
    subgraph server["rtplot-server"]
        browser["browser tab<br/>localhost:8050"]
    end
    script -- "data :5555" --> server
    server -- "controls :5556" --> script

Sender and server don't have to be on the same machine — see the networking guide.

Install

Server — grab the prebuilt binary from the Releases page:

Platform	Asset
Windows	`rtplot-server-<version>-windows-x64.exe`
Linux	`rtplot-server-<version>-linux-x86_64.tar.gz`
macOS (Apple Silicon)	`rtplot-server-<version>-macos-arm64.tar.gz`

No Python needed on the viewing machine. On Windows the binary opens a small Tk status window showing the listening URL.

Client — pip install in the env that runs your script:

pip install better-rtplot

(If you'd rather run the server from Python too, use pip install "better-rtplot[browser]" — see the API reference.)

Your first plot

flowchart TD
    t1["terminal 1: start the server"]
    t2["terminal 2: run your script"]
    br["browser: open localhost:8050"]
    t1 --> t2 --> br

Terminal 1 — start the server. Run the prebuilt rtplot-server binary you downloaded above. Open http://localhost:8050 in a browser — the page is blank until data arrives.

Terminal 2 — run your sender script. Save as my_plot.py:

from rtplot import client
import time

client.local_plot()
client.initialize_plots(["my signal"])

for i in range(1000):
    client.send_array(i * 0.01)
    time.sleep(0.01)

python my_plot.py

A rising line now draws itself in the browser tab.

Highlights

Fast. Binary WebSocket deltas up to 1 kHz; the browser coalesces samples into one repaint per requestAnimationFrame, so rendering tracks your monitor refresh rate regardless of sample rate.
Browser-based. aiohttp + uPlot, no desktop GUI toolkit, works over SSH port forwarding.
Remote-friendly. Sender or plot host can bind. Live Bind / Connect buttons retarget without restart.
Config lives with the data. The sender declares plot layout.
Interactive controls. Buttons, sliders, dials, displays — polled from your loop, no threads, no callbacks.
LaTeX labels. Use $...$ or $...$ in plot and control text; the server bundles KaTeX and works offline.
Static HTML snapshots. save_snapshot("out.html") writes a self-contained file with the current trace and math rendering embedded.

Where to go next

API reference — every rtplot.client function, the plot-layout schema, interactive controls, snapshots, browser UI, and rtplot-server CLI flags.
Networking guide — Mode A vs. Mode B, viewing from a phone or second laptop, the WSL2 wrinkle, Cloudflare Tunnel, Tailscale.
Examples — runnable scripts with embedded HTML snapshots you can open offline.

Issues and feature requests: github.com/jmontp/rtplot/issues.

Release files for better-rtplot 0.4.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for better-rtplot 0.4.14
File	Size	Uploaded
better_rtplot-0.4.14.tar.gz	433.6 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for better-rtplot 0.4.14
File	Interpreter	ABI	Platform	Reset
better_rtplot-0.4.14-py3-none-any.whl 438.7 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 872.3 kB

Release files / better_rtplot-0.4.14.tar.gz

Download URL	better_rtplot-0.4.14.tar.gz
Size	433.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`2611f05714bf0e5b61e3439a8f06619b93273f764311549a056ae21f71d7e6ba`
BLAKE2b-256 checksum How to use checksums	`3173e21131ad6026638f6262ce11788f420d426ad468ad42e04b7ba110a08ef6`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.2 CPython/3.12.3 Linux/6.18.33.2-microsoft-standard-WSL2`

Release files / better_rtplot-0.4.14-py3-none-any.whl

Download URL	better_rtplot-0.4.14-py3-none-any.whl
Size	438.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d0579e41a6012defec0b7096cff04922b69842ab520c52cb77aac7a4cbeae94e`
BLAKE2b-256 checksum How to use checksums	`61a72edde8c798b44bb6a366503052346db42c5c9104e47575cba07c5c05d0f2`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.2 CPython/3.12.3 Linux/6.18.33.2-microsoft-standard-WSL2`