The content of the display can be configured by installing an individual set of plugins. Each plugin is identified by its unique UID.
- Generic plugins
- Dedicated plugins
- BatteryPlugin
- BTCQuotePlugin
- CountdownPlugin
- DateTimePlugin
- DDPPlugin
- FirePlugin
- GameOfLifePlugin
- GruenbeckPlugin
- MatrixPlugin
- OpenWeatherPlugin
- RainbowPlugin
- SensorPlugin
- SignalDetectorPlugin
- SoundReactivePlugin
- SunrisePlugin
- SysMsgPlugin
- TempHumidPlugin
- TestPlugin
- VolumioPlugin
- WifiStatusPlugin
- WormPlugin
- Issues, Ideas And Bugs
- License
- Contribution
The generic plugins allow the user to control the different UI elements described in the plugin name via the REST API.
The plugin can grab information in JSON format via MQTT and shows it on the display. Configuration examples may help to configure.
The plugin can grab information in JSON format via REST API and shows it on the display. Each part can be set separately via the REST API. Configuration examples may help to configure.
The IconTextPlugin shows an icon on left side, text on right side. If no text is set, the plugin will be skipped in the slot.
Each part can be set separately via the REST API.
If MQTT is built in and enabled, it will support Home Assistant MQTT discovery.
The IconTextLampPlugin shows an icon on left side, text on right side and lamps at the bottom.
Each part can be set separately via the REST API.
If MQTT is built in and enabled, it will support Home Assistant MQTT discovery.
The JustTextPlugin shows only text on the whole display. If no text is set, the plugin will be skipped in the slot.
The text to be displayed can be set via the REST API.
If MQTT is built in and enabled, it will support Home Assistant MQTT discovery.
The ThreeIconPlugin shows three icons on the display.
Each icon can be set separately via the REST API.
Dedicated plugins are plugins which only serves one single purpose thy are only internally configurable.
This plugin displays the battery symbol with state of charge bar.
The BTCQuotePlugin shows the current exchange rate from Bitcoin to USD.
Powered by CoinDesk.
The CountdownPlugin shows the remaining days until a configured target date.
Target date and the description of the target day (plural/singular form) can be set via the REST API.
The plugin shows the current time and/or date.
If date and time are configured, first the time will be shown for half of the slot duration and after it the date. It can be configured to show only the date or only the time as well.
Below the day of the week is shown, starting from the left with Monday.
Configure the date and time format in the plugin configuration JSON file. The format itself is according to strftime(). For colorization text properties can be added.
By default the local time (see timezone in the settings) is used. It can be overwritten by the plugin configuration.
It can be set what shall be shown via the REST API.
The plugin setup a server supporting the Distributed Display Protocol (DDP), which is used e.g. by xlights or LedFx.
Supported formats:
- RGB with 24-bit per pixel
- Add Ethernet controller
- Name: Pixelix
- IP Address: <IP-ADDRESS>
- Protocol: DDP
- Add layout
- Create new matrix
- Name: Matrix8x32
- Matrix
- Strings: 8
- Nodes/String: 32
- Strands/String: 1
- Starting Location: Top Left
- Controller: Pixelix
- Controller Connection
- Port: 1
- Protocol: LED Panel Matrix
- String Properties
- String Type: RGB Nodes
- Appearance
- Pixel Size: 10
- Pixel Style: Square
- Create new matrix
The FirePlugin shows a animated fire on the display.
The GameOfLifePlugin shows the game of life game on the display.
The GruenbeckPlugin shows the remaining system capacity (parameter = D_Y_10_1 ) of the Gruenbeck softliQ SC18 via the system's RESTful webservice.
The IP address of the Gruenbeck webserver can be set via the REST API.
The plugin shows the effect from the film "Matrix" over the whole display.
The OpenWeatherPlugin shows the current weather condition (icon and temperature) and one additional information (uvIndex, humidity or windspeed) .
Information provided by OpenWeather.
In order to use the plugin an API key is necessary, see https://openweathermap.org/appid for further information.
The coordinates (latitude & longitude) of your location, your API key and the desired additional information to be displayed can be set via the REST API.
The RainbowPlugin shows an animated rainbow on the display.
The plugin shows sensor values of the selected sensor channel.
The plugin is able to detect a signal, which can be combined with up to 2 frequencies.
Each frequency must be detected for a specific configureable time.
As long as nothing is detected, the plugin will disable itself.
If a signal is detected, it will be shown on the display for the configured slot duration. After slot duration timeout or user changed the slot, the plugin will be disabled until next signal detection.
Additional a push notification can be configured. By default a GET is triggered. Using "GET" or "POST" as prefix its configureable. Example: "POST http://..."
Each part can be set separately via the REST API.
The plugin shows octave frequency bands, depended on the environment sound. Required: A digital microphone (INMP441) is required, connected to the I2S port. The number of shown frequency bands can be set via the REST API.
The SunrisePlugin shows the current sunrise / sunset times for a configured location.
The coordinates (latitude & longitude) of your location can be set via the REST API.
Powered by sunrise-sunset.org
Configure the time format in the plugin configuration JSON file. The format itself is according to strftime(). For colorization text properties can be added.
The SysMsgPlugin is a system plugin, which is used to splash important information's to the user. Note, it can not be uninstalled.
Th TempHumidPlugin displays the temperature (in °C) and Humidity (in %) based on the readings of sensor connected to Pixelix.
The TestPlugin can be used to check whether the LED matrix topology (layout) is correct or not.
The VolumioPlugin shows the current VOLUMIO state as icon and the played artist/title.
If the VOLUMIO server is offline, the plugin gets automatically disabled, otherwise enabled.
The host address of the Volumio webserver can be set via the REST API.
The WifiStatusPlugin shows the current wireless signal strength.
The plugin shows animated worms on the display. If they find some meal, they will grow up. If they eat too much, they will explode.
If you have further ideas or you found some bugs, great! Create a issue or if you are able and willing to fix it by yourself, clone the repository and create a pull request.
The whole source code is published under the MIT license. Consider the different licenses of the used third party libraries too!
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, shall be licensed as above, without any additional terms or conditions.