Main Content

CircuitPython 5.0.0 released

This is CircuitPython 5.0.0, the latest major revision of CircuitPython, and is a new stable release.

5.0.0 features many improvements and enhancements to displayio, including grayscale OLED and e-paper displays, extensive additions and improvements to BLE support, support for the STM32F4, iMX RT10xx and Sony Spresense microcontroller families, and PWM audio support.

Download from
Downloads are available from! The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.

To install follow the instructions in our new Welcome to CircuitPython! guide. To install the latest libraries, see this page in that guide.

Try the latest version of the Mu editor for creating and editing your CircuitPython programs and for easy access to the CircuitPython serial connection (the REPL).

New features and improvements since 4.1.2
Many improvements to displayio
Revamped refresh API
Grayscale OLED support
e-paper display support
Groups can be hidden
Many _bleio improvements
Renamed bleio to _bleio to emphasize one should use the BLE library and that _bleio‘s API may change without a major CircuitPython version bump
Central support
Client support
Pairing and bonding support
Many audio fixes and improvements
MP3 decoding support
PWM audio out
nRF52840 I2S support
Mixer moved to audiomixer and now supports per-voice volume
Finalized _pixelbuf API for RGB pixel speedups
Additional chip families with beta support:
iMX RT 10xx
CXD56 (Sony Spresense)
Added Korean translation
Many translation improvements
Breaking Changes and Deprecations from 4.x
5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
The bleio module has been renamed to _bleio to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in _bleio since 4.0.0. Please use the latest adafruit_ble library for end-user BLE programming.
The displayio refresh API has been revamped to be simpler. wait_for_frame and refresh_soon have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The new auto_refresh property and refresh() function can be used to control when the screen refreshes and at a specific rate.
Moved audioio.Mixer to audiomixer.Mixer, which is only available on M4s. Moved audioio.RawSample, and audioio.WaveFile to the new module audiocore. However, for backwards compatibility, they are still available in audioio. They will be removed from audioio in 6.0.0. Thanks @jepler.
Added I2C.writeto_then_readfrom(). Deprecate stop= arg which will be removed in 6.x. Use I2C.writeto_then_readfrom() instead.
Removed re from CircuitPlayground Express Display build.
Removed gamepad from CircuitPlayground Express Crickit build.”

Link to article