TK-Form — Visual Tkinter GUI Designer for VS Code

Design Tkinter interfaces with drag & drop in VS Code, preview the real Tkinter window, and export clean, runnable Python code — no coordinate math, no hand-written layout code.

TK-Form brings a WinForms-style visual workflow to Tkinter: place widgets on a canvas, edit properties and events in an inspector, run the real Tkinter preview, and export a working Python starting point — all without leaving VS Code.

Hand-writing Tkinter layout means guessing pixel coordinates, fighting pack() and grid() options, and running the app over and over just to move a button. TK-Form replaces that loop with a visual designer backed by a readable .tkform.json project file and a validation engine, so the thing you see on the canvas is one click away from the thing your users will run.

• Visual drag & drop designer — place, resize, align, snap, and zoom widgets on a canvas with multi-select and a widget tree.
• Real Tkinter preview — run the actual interface in a local Python runtime, not a mock-up.
• Validation before export — cross-references, prop allow-lists, layout rules, name collisions, and event-handler syntax are checked before code generation.
• Three export modes — a single-file create_window() script, an App(tk.Tk) class, or a split ui_<project>.py + app.py pair.
• place, grid, and pack layouts — including grid row/column stretch weights and pack fill/expand options.
• ttkbootstrap 2.x support — 30 themes, per-widget bootstyle, seven provider widgets (Meter, Tableview, DateEntry, …), and themed dialogs, toast, and tooltips.
• Widget animations — seven presets (slide, shake, bounce, pulse, color, fill, grow) with triggers, easing curves, and generated start_*()/stop_*() APIs.
• Event Editor with autocompletion — inline Python handlers with in-scope suggestions for widgets, Tk variables, and generated APIs.
• Background threading & charts — run handler code off the UI thread with BackgroundWorker/ThreadPool components, and render bar/line/pie charts with zero third-party dependencies (optional matplotlib renderer).
• AI-friendly — a readable JSON project format plus a ready-made AI skill for Codex, Copilot, Cursor, and other coding agents.

Classic Tk: Button, Label, Entry, Text, Checkbutton, Radiobutton, Listbox, Scale, OptionMenu, Spinbox, Scrollbar, Menubutton, Message · Containers: Frame, LabelFrame, Canvas, PanedWindow, Notebook, Toplevel · ttk: Progressbar, Combobox, Treeview, Sizegrip, Separator, TtkPanedWindow · Charts: Chart (bar/line/pie) · ttkbootstrap providers: DateEntry, LabeledScale, Meter, Floodgauge, Tableview, ScrolledText, ScrolledFrame.

Non-visual components: Timer, FileDialog, ColorChooser, MessageBox, BackgroundWorker, ThreadPool, plus ttkbootstrap TtkMessagebox, Querybox, DatePickerDialog, ColorPickerDialog, ToastNotification, and ToolTip. See the full technical scope.

code --install-extension Byeong-cheolKim.tk-form

1. Download tk-form-<version>.vsix from Releases.
2. In VS Code, open the Extensions view and choose Install from VSIX... from the ... menu.

VSIX-installed extensions may not auto-update — check the Releases page for new versions.

1. Open a trusted local folder, then run TK-Form: Open Example Project and pick an example (six included — from a minimal login form to ttkbootstrap widget showcases).
2. Edit the design on the canvas, then run Check Python → Validate → Preview to see the real Tkinter window.
3. Run Export Python and save the generated .py file — a runnable starting point you can extend.

User documentation is available in three languages:

• 한국어 문서
• English documentation
• 简体中文文档

Highlights: Widget Animations · ttkbootstrap Projects · Technical Scope · Troubleshooting

The TKform-skill folder ships the tkform-author skill for AI coding agents (Codex, Copilot, Cursor, Claude, ZCode, etc.). It teaches an agent how to author and edit .tkform.json project files instead of guessing the Tkinter JSON structure, bundles the same JSON Schema as the extension, and includes a validator script backed by the extension's Python engine.

Point your agent at the folder to register the skill:

https://github.com/atk-bckim/tk-form/tree/main/TKform-skill

See TKform-skill/SKILL.md for the full guide.

Report bugs and suggest features through Issues. Please include reproduction steps, your VS Code, operating-system, and Python versions, plus the output from TK-Form: Copy Support Summary. Do not include project source or event code in an initial report.

For commercial licensing or purchasing inquiries, contact bckim7639@gmail.com. Personal use is free; commercial/enterprise use requires a paid license.

Sponsorship: Ko-fi · GitHub Sponsors