horotw / pixoo-awesome

Uses the pixoo-client to display interactive data (custom clock, cpu load, ram, git status, ....) on a Pixoo-Max.

Pixoo-Awesome is a tool to get more out of your Pixoo Devices.

It uses the Pixoo-Client to connect to your Pixoo devices and send data to them.

I target the Pixoo-Max because it's the device I have 😀 but it should also work with other Pixoo devices but you might need to adjust some sizes ^^.

To use this project you should clone the repository and copy the example.env file as local.env file. You need to find the mac address of your Pixoo device and put it in the local.env file.

I would suggest creating a .venv so the project dependencies can't conflict with other projects.

Requirements

• Python 3.6+
• The packages in the requirements.txt file
• The local.env file with the mac address of your Pixoo device

Quick start

# copy the example.env file to local.env
cp example.env local.env
# insert the mac address of your Pixoo device and other credentials as needed
nano local.env
# Create a virtual environment
python3 -m venv .venv
# Activate the virtual environment
source .venv/bin/activate
# Install the project dependencies
pip install -r requirements.txt
# Run the project
python pixoo.py

You might wan't to change what is shown on your Pixoo device by editing the pixoo.py file.

Development

For development you should also install the requirements-dev.txt file. This project uses black as a formatter and prospector as a linter.

Pull requests are welcome! 🙌 🙌 🙌

Feature Ideas:

• more Indicators (Single Pixels to represent some value like existing github "did made a commit today?")
• different graphs to show values like cpu usage, memory usage, etc.
• a scheduler to display different modes time based (like e.g. the weather forecast)
• display GIFs
• display pictures with panning and zooming
• display an folder with pictures as a slideshow
• a night mode to turn the screen off at night
• a dynamic Text display (would be cool if it could choose a text size so that it fits on the screen even on multiline text)
• the integration to home assistant

pixoo-awesome's Issues

Help newbies for find the MAC adress

Hello i have th Pixoo Max too, i wanna use some custom image to it the app is lame.

How i use yours ? I don' know how to have MAC adress of the PIxoo Max

Change channels

Hello, sorry for writing here instead of pixoo_client (they don't answer), but please answer if you can. I want to automate screen change and already found out that pixoo.set_box_mode(4, 4) makes "matrix" voice screen, and now I need to change clock screen. So in set_box_mode(self, boxmode, visual=0, mode=0) boxmode should be 1, but how can I do turning on the clock I need and its channels (weather, temperature and calendar)?