Open main menu

How to enable OLED display on Raspbian: [1]

1. Update your Pi and Install the required dependencies

sudo apt-get update
sudo apt-get -y upgrade
sudo apt-get -y install i2c-tools python3-smbus
sudo apt-get -y install python3-pip python3-pil
sudo pip3 install --upgrade setuptools
sudo pip3 install --upgrade adafruit-python-shell
sudo pip3 install adafruit-circuitpython-ssd1306
sudo pip3 install pi-ina219
sudo pip3 show pi-ina219

2. Run the following command to check the oled i2c port

sudo i2cdetect -y 1

for X729, the I2C address is 0x3c, (In generally, the i2c address is 0x3c)

Please sure teh I2C is enable before this step, please refer to How to enable I2C

3. Installation

3.1 Download the required scripts

cd ~
# git clone
git clone
cd oled

3.2 Install the Adafruit CircuitPython library

sudo python3

This process may take tens of minutes, please be patient

3.3 Answering Y and hitting Enter when reboot prompted. Then renavigate to the oled directly by entering:

cd oled

3.4 Run the script to test the display

sudo python3 


sudo python3 

Due to different hardware, you need to choose a different project file such as or

3.5 Run the script at Raspberry Pi boot

sudo crontab -e

3.6 Add a line at the end of the file that reads like this:

PS: we must toogle to the /home/pi/oled directory because .ttf files is required to locate in current directory,you can refer to source file, or you can also remove the 'cd /home/pi/oled &&' if you use the absolute path of the ttf file in the source code.

@reboot cd /home/pi/oled && python3 /home/pi/oled/ &

Save and exit. In nano editor, you do that by hitting CTRL + X, answering Y and hitting Enter when prompted.


  1. Adafruit Python SSD1306 library:

Add your comment
Geekworm Wiki welcomes all comments. If you do not want to be anonymous, register or log in. It is free.


Anonymous user #2

28 days ago
Score 0  

you say: Hi, you can ignore python-smbus package I ask: How

Instructions do not work at all. Many failures.


28 days ago
Score 0  
Hi,could you please tell us more details? Please try to test the LED screen alone.Does the screen light up?

Anonymous user #1

18 months ago
Score 0  

Could you please update this page according to actual Raspberry OS release?

No python-smbus package there and couple errors coming on install adafruit-circuitpython-ssd1306


15 months ago
Score 0  
Hi, you can ignore python-smbus package.