Upgrading PySimpleGUI

Upgrading To The Latest Major Release

To upgrade to the newest version of PySimpleGUI from PyPI, you'll use this command:

python -m pip install --upgrade PySimpleGUI

Note the --upgrade flag. If you do not include this flag then Python will not install any version of PySimpleGUI if you've already installed PySimpleGUI previously.

Sometimes adding the flag --no-cache-dir is needed if you're trying to get a newly released version.

python -m pip install --upgrade --no-cache-dir PySimpleGUI

Just as with the initial install, on Linux systems, you may need to add sudo to the start of the command line.

Upgrading To a Development Build

As bugs are fixed and features are added to PySimpleGUI, they are made available to users prior to their release on PyPI. This allows you to obtain bug fixes quickly without waiting for testing and posting the release to PyPI.

Upgrading to a Development Build is done through the PySimpleGUI package itself. There are 2 methods for upgrading to a Development Build:

1. Open the Home Window & clicking the red "Get Latest Development Build" button
2. Run psgupgrade from the command line

Recovering From a Bad Development Build Release

If you run into a problem upgrading after upgrading to a Development Build, you can likely use pip to uninstall, then re-install from PyPI to see if you can upgrade to a Development Build again.

pip uninstall PySimpleGUI
pip install PySimpleGUI

Using Home Window

To open the PySimpleGUI Home Window, type psghome from the command line, or call sg.main() from your application (or a REPL prompt)

One advantage to using the Home Window is that you can see your current PySimpleGUI version number as well as the most recent version on PyPI and the current Development Build version number.

To upgrade, click the red "Get Latest Development Build" button.

Using psgupgrade

Typing psgupgrade will open a confirmation dialog box just as the Home Window does when upgrading to the Development Build.

Confirmation Dialog & Progress Window

After starting an upgrade to the latest Development Build (using the Home Window or psgupgrade command) you will be asked to confirm you want to upgrade. The confirmation window looks like this:

You are shown your current PySimpleGUI version number and the version you will be upgrading to. Choose "Yes" if you want to proceed with the upgrade. Just like major releases of PySimpleGUI, Python's pip operation is used to install Development Builds. A window showing the output of the upgrade pip command is shown so that you can see the progress and capture the output should there be an error that you need to report.

Some versions of PySimpleGUI include a "Show Release Notes" button which enables you to see all of the changes that are in the Development Build.

If you choose "Yes" to install the build, then the output of the pip install will be output to a scrolling window, in real time. At the end of the upgrade you are shown the version of PySimpleGUI that was installed.