Skip to content

pypixelcolor - Python Library & CLI for iPixel Color LED Matrix Devices

pypixelcolor logo

Important: Select the right documentation version

Please ensure you are viewing the documentation version corresponding to the version of pypixelcolor installed on your system. You can switch versions using the version selector dropdown in the navigation bar (e.g., v0.4.0, v0.5.0, main).

pypixelcolor (also known as iPixel-CLI) is a Python library and CLI tool for controlling iPixel Color LED matrix devices via Bluetooth Low Energy (BLE). It allows you to send commands to the device to manipulate the LED display, retrieve device information, and more.

Getting Started Commands

Features

  • 📝 Send text: Display custom messages with fonts, colors, and animations.
  • 🖼️ Send images: Display images and GIFs on the matrix.
  • ⚙️ Control settings: Adjust brightness, orientation, and power.
  • ⏰ Clock, Timer & Scoreboard: Display clock faces, control timers, and scoreboard.
  • 🐍 Scriptable: Full Python library support with synchronous and asynchronous APIs.
  • 🖥️ CLI: Feature-rich command-line interface with interactive status and multi-command chaining.

Disclaimer

This is not the official software from iPixel Color. It is a third-party project developed independently. I'm not responsible for any damage caused to your device while using this software. Use it at your own risk.