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.

To arrange several plots side by side, start the server with ./rtplot-server --columns 2 (or --columns 3). The Python server accepts the same option: python -m rtplot.server_browser --columns 2. See the multi-column example.

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.15

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.15
File	Size	Uploaded
better_rtplot-0.4.15.tar.gz	434.5 kB	Sep 17, 2026	Details

Built distribution (wheel)

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

Total release size: 873.6 kB

Release files / better_rtplot-0.4.15.tar.gz

Download URL	better_rtplot-0.4.15.tar.gz
Size	434.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`8c7c456ac6e8c2c25708ee054a60623b10107e6d8f22f112198c53559604cfe0`
BLAKE2b-256 checksum How to use checksums	`1e4e3124c56e63ea383672c147e459f41b37666a0b64ed8c7e578113cf814ffd`
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.15-py3-none-any.whl

Download URL	better_rtplot-0.4.15-py3-none-any.whl
Size	439.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9539ad2001d6057141f686e9bd637120e66ffe2ea456eb399f9bbf2b8de7da0a`
BLAKE2b-256 checksum How to use checksums	`cf276e0fbad1af5aa700480e8c0332cd396744a43bf957460fd81e7ead24400b`
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`