This project runs on a Raspberry Pi and listens for Shopify order webhooks to display order details on an SH1106 OLED screen. It also flashes an LED when a new order arrives and plays an optional sound.
- 📦 Displays new Shopify orders on an OLED screen.
- 🌩️ Lightning animation before showing order details.
- 🚀 Smooth scrolling for long product names.
- 🔄 Cycles through order details before returning to idle.
- 🔔 Flashing LED on order arrival.
- Raspberry Pi (Zero 2W, 3, 4, etc.)
- SH1106 or SSD1306 OLED display (I2C)
- Python 3.x
- Shopify webhook integration
- (Optional) Speaker for audio alerts
git clone https://github.com/your-repo/shopifyPi.git
cd shopify-oled-displaypip3 install -r requirements.txtsudo raspi-config- Navigate to Interfacing Options > I2C > Enable
- Save and exit
- Check if OLED is detected
sudo i2cdetect -y 1- It should show
0x3Cor similar
- Create a .env in the root and save these:
SHOPIFY_API_KEY=xxxSHOPIFY_API_SECRET=xxxSHOPIFY_STORE_NAME=example.myshopify.com
- Go to your Shopify admin panel
- Navigate to Settings > API > Webhooks
- Create a new webhook with the following settings:
- Topic:
orders - Address:
http://your-raspberry-pi-ip:5000/webhook - Format:
json - Save and test the webhook
python3 mainApp.py- The console will show an Ngrok public URL (eg.
https://xyz.ngrok.io/webhook/order) <- This is what you will use in the step above
You can modify:
- DISPLAY_WIDTH & DISPLAY_HEIGHT for different screen sizes.
- SCROLL_SPEED to adjust text scrolling speed.
- LED Pin (default is GPIO 17).
| Component | Raspberry Pi Pin |
|---|---|
| OLED VCC | 3.3V (Pin 1) |
| OLED GND | GND (Pin 9) |
| OLED SDA | GPIO 2 (Pin 3) |
| OLED SCL | GPIO 3 (Pin 5) |
| LED + | GPIO 17 (Pin 11) |
| LED - | GND (Pin 9) |
Built with ❤️ on Raspberry Pi!