WLED/usermods/readme.md

22 lines
1.3 KiB
Markdown
Raw Normal View History

2019-11-26 21:21:54 +01:00
### Usermods
2020-04-09 15:06:44 +02:00
This folder serves as a repository for usermods (custom `usermod.cpp` files)!
2019-11-26 21:21:54 +01:00
If you have created an usermod that you believe is useful (for example to support a particular sensor, display, feature...), feel free to contribute by opening a pull request!
In order for other people to be able to have fun with your usermod, please keep these points in mind:
2019-11-28 20:13:52 +01:00
- Create a folder in this folder with a descriptive name (for example `usermod_ds18b20_temp_sensor_mqtt`)
2020-05-28 02:20:02 +02:00
- Include your custom files
2020-02-19 19:24:56 +01:00
- If your usermod requires changes to other WLED files, please write a `readme.md` outlining the steps one has to take to use the usermod
2019-11-28 20:13:52 +01:00
- Create a pull request!
- If your feature is useful for the majority of WLED users, I will consider adding it to the base code!
2019-11-26 21:21:54 +01:00
While I do my best to not break too much, keep in mind that as WLED is being updated, usermods might break.
I am not actively maintaining any usermod in this directory, that is your responsibility as the creator of the usermod.
2020-05-28 02:20:02 +02:00
For new usermods, I would recommend trying out the new v2 usermod API, which allows installing multiple usermods at once and new functions!
You can take a look at `EXAMPLE_v2` for some documentation and at `Temperature` for a completed v2 usermod!
2020-02-19 19:24:56 +01:00
Thank you for your help :)