Release 3.3.3 - Custom data sources & theme author
Custom data sources
Following this feature request #306, it is now possible to easily add custom data sources to this project (unsupported hardware sensors, sound from music players, web API data...) and display them on themes like other sensors.
For this, a Python CustomDataSource
class must be implemented in library/sensors/sensors_custom.py
. This class can have numeric and/or text data to display.
There is no limitation on how much custom data source classes can be added!
Two examples have already been implemented in the file with comments to help you get started.
To display these custom data sources to a theme, they must be added to a new CUSTOM:
field in the theme.yaml
file of your theme.
The name of the class in theme.yaml
must be an exact match to the class name in sensors_custom.py
A theme has been developed to match example classes from sensors_custom.py
: res/themes/CustomDataExample/theme.yaml
Theme authors
I'm very thankful to the community for sharing their themes either using the Themes discussion space or as PR to this repository.
The author name has now been added as a new field to theme files, and is displayed on the Configuration Wizard below theme preview.
If the author name starts with @
it will be displayed as a hyperlink to the author's GitHub profile.
Existing themes on this repository have already been updated with their original author name!
What's Changed
- Implement custom data sources, with theme example and comments by @mathoudebine in #338
- Add authors for existing themes, and display it on Configuration Wizard by @mathoudebine in #339
Full Changelog: 3.3.2...3.3.3