Launch a Tkinter application with inspection enabled.

Starts the script with automatic Tkinter patching. The app will be inspectable via the other tools once launched.

Get the current UI layout as hierarchical JSON.

Returns a JSON structure containing the complete widget tree with:

• widget class names (Button, Label, Frame, etc.)

• unique widget IDs

• geometry (x, y, width, height)

• widget state (normal, disabled)

• text content where applicable

• nested children

Use this to understand the current state of the GUI.

Take a screenshot of the application window.

Returns a base64-encoded JPEG image of the current window state. Use this to visually inspect the GUI appearance.

Take a small thumbnail screenshot of the application window.

Returns a low-resolution preview for quick UI state checks. Use view_application for detailed inspection.

Returns: Base64-encoded JPEG string prefixed with data URI scheme.

Get basic information about the application window.

Returns JSON with window position and dimensions:

• x, y: Window position on screen

• width, height: Window dimensions in pixels

Useful for understanding window placement.

Click a widget by its ID.

Finds the widget with the given ID and triggers a click action. For buttons, this invokes the button command. For other widgets, this generates a click event.

Type text into an Entry or Text widget.

Clears the current content and inserts the new text. Only works with Entry and Text widgets.

Find a widget by its text content.

Searches the widget tree for a widget containing the specified text. Returns the widget ID if found.

Close the currently running Tkinter application.

Terminates the app gracefully.

Returns: JSON with success status

Check if an app is currently connected.

Returns: JSON with connection status

Set keyboard focus to a widget.

Get the currently focused widget.

Returns: JSON with the focused widget's ID or null if no widget has focus

Get the value of a widget based on its type.

Returns the appropriate value for the widget type:

• Entry/Text: text content

• Scale: numeric value

• Combobox: selected text

• Checkbutton: boolean (checked/unchecked)

• Radiobutton: variable value

• Listbox: list of selected item texts

• Spinbox: current value

Set the value of a widget based on its type.

Sets the appropriate value for the widget type:

• Entry/Text: sets text content

• Scale: sets numeric value (e.g., "50.0")

• Combobox: sets selected text

• Checkbutton: sets checked state ("true"/"false")

• Radiobutton: selects this radio button (value ignored)

• Listbox: selects item by index (e.g., "0", "1")

• Spinbox: sets value

Get available options for a Combobox or Listbox widget.

Returns the list of selectable options/items.

Perform drag and drop between two widgets.

Simulates dragging from one widget to another. Useful for drag-and-drop interfaces like chess boards, sortable lists, etc.