Thonny Files

🇺🇦 Thonny 5 is dedicated to Ukraine fighting the Russian invasion. Please support Ukraine! 🇺🇦

Thonny 5 was originally planned to include many new features, but because they are taking longer than expected, we are releasing version 5 as an intermediate bug-fix release, mainly to add compatibility with newer Python versions. The major version number has been increased only because of dependency upgrades in the bundles. All new features have been moved to the version 6 milestone.

Installation instructions

NB! It is recommended to uninstall Thonny 4 before installing Thonny 5. Also note that you may get an error when you start up new Thonny as your previous configuration referred to the Python executable in another location. In this case click on the button in the lower-right corner of Thonny's window and select new interpreter.

Windows

The main Windows installer (thonny-5.0.0-x64.exe) is 64-bit and comes with Python 3.14 -- this means it is suitable only for 64-bit Windows 10 and 11. Installers for Windows 7, 8 and 32-bit Windows 10 are not published anymore, but you can install an older Python version and Thonny separately.

Since 5.0 we publish a separate installer for Windows on Arm.

macOS

Since 5.0 we publish separate installers for Intel and Apple silicon Macs (M1, M2, etc) -- thonny-5.0.0-x64.pkg and thonny-5.0.0-arm64.pkg. The minimum supported macOS version for these installers is 10.15 (Catalina), but you can install an older Python version and Thonny separately on older macOS-s.

Linux

Since 5.0 we don't publish binary bundles for Linux anymore. Instead use thonny-5.0.0.bash which uses your system Python and creates a venv for installing Thonny and its dependencies.

NB! ~/apps/thonny/bin/thonny is broken in this release, use the generated desktop launcher or ~/apps/thonny/bin/python -m thonny for launching.

Changes since 4.1.7

Breaking changes

• Upgrade bundled Python version to 3.14. This means the Windows installer now requires at least Window 10 and macOS installer requires at least Catalina! Python 3.8 is still supported, so in principle you can use this version in Windows 7, but you wouldn't gain much over 4.1.7.
• Stop publishing binaries for Linux, [#3210]. The Linux installation script now creates a private venv (based on system python3) for Thonny even in x84_64.
• Stop publishing XXL bundle as it is not trivial to prepare bundles for all popular architectures while making sure there are no version conflicts between the large number of packages. For teachers who relied on the XXL bundle, the work-around is to prepare a suitable requirements.txt, which can be used as input in Thonny's package manager.
• Start publishing separate installers for Intel and Arm Macs.
• Stop publishing installers for 32-bit Windows.
• Start publishing installers for Arm-Windows.
• "For all users" installation in Windows now ends up in "C:\Program Files" instead of earlier "C:\Program Files (x86)"

Other changes and fixes

• By default, Tk file dialogs are now used instead of Zenity in Linux (uncheck "Tools => Options => Use Tk file dialogs instead of Zenity" to revert this choice)
• Add support for Python 3.11, 3.12, 3.13, 3.14, 3.15 (#3213, [#3577], [#3799], [#2739], [#3744] by @mkluson, [#3082], [#3729], [#3552] by @plexus)
• Fix macOS crash when opening package selection dialog
• Check if in virtual environment on boot, [#3112] by @scottfp
• Add Python coloring for pyx-files, [#3450]
• Use subprocess.CREATE_NO_WINDOW when creating subprocess in Windows, [#2817], tipped by @Damian-2001
• Allow stopping auto-scroll in Shell by scrolling up, [#1988]
• Get rid of a find-replace warning, [#3593]
• Add support for newer setuptools versions
• Add support for newer Tkinter versions (#3744 by @mkluson)
• Upgrade several bundled dependencies (Pylint, Mypy, esptool, etc.)
• Add Arabic, Bulgarian, Hindi, Indonesian, Icelandic and Malayalam translation. Update several other translations. Thanks for all contributors! Please see https://poeditor.com/projects/view?id=256075 for credits! Please note that Thonny's maintainers have not reviewed the translations!
• Make flashing dialogs support more families, [#3847]

Regressions fixed since 5.0.0b1

• Fix broken GUI entry script (most relevant in Linux, ~/apps/thonny/bin/thonny now works again), [#3844]
• Fix sending file paths as arguments to Windows Thonny launcher, [#3835]
• Fix clipboard management in Windows, [#3832]
• Fix "There is no current event loop in thread 'MainThread'" error in UF2 dialog in Linux, [#3775] by @matejmatuska