Release 3.3.3 - Custom data sources & theme author #340
mathoudebine
announced in
Announcements
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
-
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 inlibrary/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 thetheme.yaml
file of your theme.The name of the class in
theme.yaml
must be an exact match to the class name insensors_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
Full Changelog: 3.3.2...3.3.3
This discussion was created from the release Release 3.3.3 - Custom data sources & theme author.
Beta Was this translation helpful? Give feedback.
All reactions