Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

An 8x8 grid of virtual LEDs implemented in Pygame.

Project Description

The ledgrid module contains a single LEDGrid class which aims to be as identical as possible to the public interface of the Raspberry Pi Sense HAT library, such that it is useful in mocking up software for it and other such devices.

Many existing Sense HAT LED demos and software will work using the following import statement:

from ledgrid import LEDGrid as SenseHat

However, the internal implementation is rather simplified and uses pygame instead of the hardware HAT.

It requires pygame to be installed (not currently available through pypi), an additional optional dependency is PIL (i.e. Pillow) which is required by some features (notably scrolling text with the show_message method).

It supports every Python version since 2.7. It is contained in only one Python file, so it can be easily copied into your project if you don’t want to use pypi. (The copyright and license notice must be retained.)

At the bottom of the file are some examples of usage. You can run these examples using:

python3 -m ledgrid

Or if you have the file locally:


Many thanks to Richard Hayler. The LED class, graphics, etc are based on his 8x8GridDraw.

Release History

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
ledgrid-0.4.tar.gz (10.3 kB) Copy SHA256 Checksum SHA256 Source Dec 25, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting