Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/rm-hull/luma.oled/llms.txt

Use this file to discover all available pages before exploring further.

This page documents the significant version milestones in luma.oled, including newly added device classes, dropped Python version support, and the instructions needed to migrate code when breaking changes were introduced.

​
Version 3.15.0 (current)

Released 5 March 2026. This is the current stable release. Added device classes:
  • ssd1305
  • ssd1315
  • ssd1316
  • ch1115 (128×64)
Also fixes SH1106 display of a rotated image, and drops support for Python 3.8.

​
Version 3.11.0

Released 26 January 2023. Added the sh1107 greyscale OLED device class.

​
Version 3.6.0

Released 24 September 2020. Added support for Winstar OLED (ws0010) parallel displays. This is the last version that supported Python 3.5.

​
Version 3.5.0

Released 4 July 2020. This is the last version that supported Python 2.7. From 3.5.0 onwards, Python 3.5 or newer is required.

​
Version 3.4.0

Released 19 January 2020. Added the ssd1362 device class for 256×64 greyscale OLED displays.

​
Version 2.4.0

Released 18 April 2018. Added the ssd1327 device class for 128×128 4-bit OLED displays.

​
Version 2.3.0

Released 30 October 2017. Added the ssd1351 device class for 128×128 color OLED displays.

​
Version 2.0.0

Released 11 January 2017.
Version 2.0.0 contains breaking changes. The project was renamed from ssd1306 to luma.oled, and the core functionality was moved into a separate luma.core package. All import statements in existing code must be updated.
The rename reflects the expanding scope of the library beyond a single controller chip. Core components (rendering, serial interfaces, emulators) were extracted into luma.core so that they could be shared with other display driver packages.

​
Migrating from 1.x to 2.0.0

1

Update device imports

Rename all imports of oled.device to luma.oled.device.
# Before
from oled.device import ssd1306

# After
from luma.oled.device import ssd1306
2

Update core imports

Rename any other oled.* imports to use luma.core.*.
# Before
from oled.render import canvas

# After
from luma.core.render import canvas
3

Install the new packages

Install both luma.oled and luma.core (the latter is pulled in automatically as a dependency):
pip install luma.oled

Build docs developers (and LLMs) love

Get started for freeTalk to us