Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Scroll pHAT HD Driver

Project description

Scroll pHAT HD

17x7 pixels of single-colour, brightness-controlled, message scrolling goodness!


Manual install:

Library install for Python 3:

on Raspbian:

sudo apt-get install python3-scrollphathd

other environments:

sudo pip3 install scrollphathd

Library install for Python 2:

on Raspbian:

sudo apt-get install python-scrollphathd

other environments:

sudo pip2 install scrollphathd


If you want to contribute, or like living on the edge of your seat by having the latest code, you should clone this repository, cd to the library directory, and run:

sudo python3 install

(or sudo python install whichever your primary Python environment may be)

In all cases you will have to enable the i2c bus.

Unofficial / Third-party libraries


  • New: Exposed set_gamma method for user gamma correction
  • Improvement: Removed web API import to prevent hard dependency on Flask
  • Improvement: Many improvements to the HTTP API including autoscroll
  • Optimisation: write_string will calculate string size and grow buffer once to fit
  • Optimisation: set_graph will grow buffer to fit the graph
  • Bugfix: Fixed ASCII font to place accented characters at correct codepoints


  • New: Added set_font to set current font for all write_string calls
  • New: Added before_display argument to show to modify the display buffer


  • Bugfix: Removed Flask HTTP API entry_point to prevent bin file conflict between Python 2 and 3


  • New: Added Flask HTTP API
  • New: Init is deferred until the library is used


  • New: Added gamma correction


  • New: Added set_brightness to globally set maximum display brightness
  • New: Added get_buffer_shape to return internal buffer shape
  • New: Added get_shape to return display shape
  • New: Added set_clear_on_exit, pass True/False to set/clear
  • Improvement: draw_char no longer fills black pixels, which was incongruent with letter spacing
  • Improvement: ‘1’ in font3x5 is now 3 pixels wide
  • Improvement: Monospacing option for fonts
  • Improvement: Fonts can now be indexed by char in addition to ordinal
  • Improvement: Clear now resets scroll position
  • Improvement: Fill now grows buffer and fills in single operations
  • Improvement: scroll(0,0) no longer enforces a default scroll
  • Improvement: width/height now private, reimplemented as read-only properties
  • Improvement: initialization now detects disabled i2c or missing pHAT and emits a friendly error
  • Improvement: cleared display sooner to mitigate flash of lit pixels on startup
  • Bugfix: Corrected default scroll direction
  • Bugfix: 90 and 270 degree rotations are no longer cropped to 7 pixels wide
  • Bugfix: Fixed missing version_info
  • Bugfix: Graph catches IndexError and gracefully ignores missing values


  • Initial release

Project details

Download files

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

Files for scrollphathd, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size scrollphathd-1.2.1-py2-none-any.whl (25.2 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size scrollphathd-1.2.1-py3-none-any.whl (25.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size scrollphathd-1.2.1.tar.gz (20.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page