# ThingPulse/esp8266-oled-ssd1306

Driver for the SSD1306 and SH1106 based 128x64, 128x32, 64x48 pixel OLED display running on ESP8266/ESP32

Repository: https://github.com/ThingPulse/esp8266-oled-ssd1306
Canonical: https://ross.abutalabs.com/products/esp8266-oled-ssd1306
Homepage: https://thingpulse.com
Language: C++
License: NOASSERTION
License Family: other
Topics: i2c, spi, arduino, driver, ssd1306, esp8266, esp32, sh1106, mbed-os, oleddisplay
Last push: 2026-05-28T05:53:06+00:00

## Health v2 (maintenance only)
Score: 69/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 84, release rhythm 33, longevity 100
- inputs: {"age_days": 3947, "days_push": 97, "days_rel": 236, "gap_med": null, "n_releases_24m": 1}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2176, forks 671 (observed 2026-08-28T04:06:22.190097+00:00)

## What it is
An Arduino/ESP8266/ESP32/mbed-os driver library for SSD1306 and SH1106 based OLED displays in 128x64, 128x32, 64x48, and 64x32 resolutions, supporting both I2C and SPI connections. It includes a UI framework with frames, indicators, and overlays, and is distributed via the Arduino Library Manager and PlatformIO.

## Use cases
- drive an SSD1306 OLED display from an ESP8266 or ESP32
- display text and graphics on a 128x64 I2C OLED with Arduino
- use an SH1106 OLED over SPI on ESP32
- build a weather station display with an ESP8266
- add an OLED screen to an mbed-os project
- render progress bars and menus on a small OLED

## When to choose
- you use ESP8266, ESP32, or mbed-os with an SSD1306 or SH1106 OLED
- you want I2C or SPI support with a built-in UI framework
- you work in the Arduino or PlatformIO ecosystem

## When to avoid
- you use a different microcontroller platform like Raspberry Pi Pico SDK or STM32 HAL
- you need color OLEDs or different display controllers
- you need e-paper or LCD support

## Facets
- artifact type: library
- maturity: stable
- function: embedded, graphics, sdk
- domain: embedded-systems, iot, hardware
- platform: embedded, iot, cpp
- tags: ssd1306, sh1106, oled-display, esp8266, esp32, arduino, i2c, spi, mbed-os

## Member repositories
- ThingPulse/esp8266-oled-ssd1306 (main) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:22.190097+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:48:51.995068+00:00, confidence not recorded.
  - readme: https://github.com/ThingPulse/esp8266-oled-ssd1306 (fetched 2026-08-28T04:06:22.190097+00:00, sha 5491f09b64f3)
  - homepage: https://thingpulse.com (fetched 2026-08-29T10:28:54.183066+00:00, sha 539a96014db8)
  - site_page: https://thingpulse.com/about (fetched 2026-08-29T10:28:54.192067+00:00, sha c04a8bc7af84)
  - site_page: https://thingpulse.com/about/contact (fetched 2026-08-29T10:28:54.193674+00:00, sha 89958d40005e)
- Data as of 2026-08-30T08:39:29.467469+00:00.