pypixelcolor

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

Features

• 📝 Send text: Display custom messages with various fonts and animations.
• 🖼️ Send images: Display images and GIFs on the matrix.
• ⚙️ Control settings: Adjust brightness, orientation, and power.
• ⏰ Clock mode: Display time with various clock faces.
• 🐍 Scriptable: Full Python library support for automation.
• 🖥️ CLI: Easy to use command-line interface.

Installation

pip install pypixelcolor

Check the Wiki for more detailed usage instructions.

Development

This project uses Hatch for packaging and managing the development environment.

Setup development environment

Create and activate the environment

hatch env create

Activate the environment

hatch shell

Install the package in editable mode

hatch run pip install -e '.[dev]'

Run tests

hatch run pytest

Build package

hatch build

💡 If your terminal doesn't support emojis, you can disable them with the --noemojis flag.

License

This project is licensed under the MIT License. See the LICENSE file for details.

This project is not affiliated with or endorsed by the original manufacturer of the iPixel devices or the official "iPixel Color" app.

Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue or submit a pull request. To get started on how to dump BLE logs from an Android device, refer to the How to get BLE logs guide.