PyodideTk

⚠️ This project is in early development and is not yet stable. Expect breaking changes and missing features.

Run Tkinter with Python in the browser.

Built on top of Pyodide; Tk's X11 calls are handled by the sibling project em-x11. Optional Tcl→DOM bridge commands (::tcldide::dom, ::tcldide::jscall) are built from the sibling tcldide project's opt/tcldide.c.

Prerequisites

• Linux
• Emscripten 5.0.3 (emcc must be on PATH)
• Node.js ≥ 20, pnpm ≥ 9
• em-x11 cloned as a sibling directory (Makefile auto-builds the native/ subset — no manual build needed)
• tcldide cloned as a sibling directory (optional — only needed for ::tcldide::* Tcl→DOM commands)
• curl + tar — xbuildenv (wasm CPython headers) is auto-downloaded by pnpm install

Quick start

pnpm install   # downloads sources, builds .so side modules, stages assets
pnpm dev       # starts Vite dev server

pnpm install detects missing external dependencies (em-x11), auto-downloads xbuildenv, and prints install instructions if anything is absent.

Build

pnpm build     # build:native → stage-assets → build:web (vite)

Run

pnpm dev

Known Issues

These are known issues that remain unresolved despite repeated attempts.

• In EmX11, running both TWM and Tcldide simultaneously causes the web page to freeze.

• When attempting to open any dialog box in Common Dialogs, the web page freezes. (See dialog-issues.md for details.)

License

MIT (see LICENSE.md).