pypi PySimpleGUI 6.3
6.3 Summer 2026

4 hours ago

Lots of new features, enhancements, fixes in this release. And I might have finally posted a release this year without a major hiccup.

Release notes from documentation...

6.3 Released 2-Aug-2026

  • Mouseover Image - New feature for Image and Button elements
  • Listbox - New method get_active_index. Returns the index of where the cursor is located.
  • Window new features and fixes
    • Window Anchors
      • Window Location Anchor - New location option for creating and getting location for a window. Anchors are specified using these constants:
        WIN_ANCHOR_UPPER_LEFT
        WIN_ANCHOR_UPPER_RIGHT
        WIN_ANCHOR_LOWER_LEFT
        WIN_ANCHOR_LOWER_RIGHT
        WIN_ANCHOR_CENTER
      • Added location_anchor parameter to all the popups.
      • New center_on_location parameter that changes the location within a window to use for initial creation. Default if upper left corner.
      • Added window_anchor parameter easy_print and the debug window.
      • Updated Window.move to use anchors when moving. The anchor used when window created can be overridden using anchor parameter
    • New use_min_size boolean parameter - If True and the window is resizable, set the minimum size to the size of window when created
    • Bug fix in Window.settings_restore. If a value was not yet set for an element, then should save the setting that was specified
    • Finally got the rtype docstring right for Window __getitem__. It fixed the type warnings and improved the autocomplete
    • Added parameters tooltip_text_color, tooltip_background_color, tooltip_font, tooltip_time, tooltip_offset to Window object.
  • Added automatic key creation for non-input element. Input type element already get assigned a unique key if one is not specified. Previously, static elements have no key unless explicitly set (e.g. Text elem). Now all those static elements will get a key with format "KeyID 41B56A4C50" if a key is not specified.
  • Fixed bug 6896 (Tree object has no attribute BType). Needed to check the element type is a Button before checking the type of button
  • Placeholder - new feature for Input elements. When the input is empty and it doesn't have focus and the mouse is not over it, then a "placeholder" text will be shown in the input area. Considering adding to Combo and other input-style elements.
  • Added new symbols:
    • SYMBOL_GEAR = '⛭'
    • SYMBOL_DEGREE = '°'
    • SYMBOL_REFRESH = '⟳'
  • Right click menu
    • Added propogate_to_window param to Element.set_right_click_menu.
    • Fixed right click problem of both a window and an element getting the click event.
  • Automatically restart user's program after upgrading to the PySimpleGUI maint release.
  • Changed a LOT of docstrings for parms that are location and size type of parameters. Added (None, None) to valid types.
  • Expanded the set_tooltip method's parameters to include the text/background colors, tooltip time, tooltip offset, skip bind. Expanded ToolTip object to include the same parms.
  • Added border_color parm to the Frame.update method so that the border color can be changed dynamically
  • Added font parm to element.set_tooltip. Now all aspects of the tooltip are controllable through this interface.
  • Added 'thickness' parameter to HorizontalSeparator and VerticalSeparator elements. If no thickness is specified, then the current Separator elements are used which as based on TTK Line widgets. If a thickness is specified, then a Frame widget is used to draw the line. The added benefit of this addition is that the color of the Frame based lines will match the color used in Frame Elements.
  • User Settings - Native support for tuples in UserSettings files (json). They're now automatically serialized.
  • Graph Element
    • Fixed Graph.draw_arc docstring. It incorrectly stated the available styles. Should have been 'pieslice', 'chord', 'arc'
    • Graph.draw_line - added capstyle which determines how the end of the line should appear
    • Graph.draw_lines - added arrow, arrow_shape, joinstyle, capstype parameters.

Don't miss a new PySimpleGUI release

NewReleases is sending notifications on new releases.