Welcome to the NetDaemon project. This is the application daemon that allows you to write your home automations in C# for Home Assistant. This repo contains the third generation of NetDaemon, V3. It is currently in beta. If you need the V2 version, please see NetDaemon V2 repo
Please see https://netdaemon.xyz for detailed instructions how to get started using NetDaemon.
The NetDaemon v3 is pretty stable but is still in development so expect things to change.
NetDaemon runtime version 3 is built from scratch. The reason is to make the product better for both users and contributors by redesigning it using C# modern design.
- We now no longer support apps using the old base class
NetDaemonRxApp
. HassModel is the only supported model moving forward. - We changed the way configuration works. Configuration from yaml is now injected using
IAppConfig<MyConfigClass<
. See the template v3 branch for examples how to use it. - Some public interfaces like
INetDaemon
is no longer used. - Different namespaces are used, like
NetDaemon.AppModel
andNetDaemon.Runtime
. Please see the template v3 branch. - We now use
input_booleans
instead ofswitch
for handling app state. If you are not using the service callbacks you will now no longer have to use the integration to handle app states persistent. They also have different names now when in Development. - The text to speech queued feature is now an extension.
- Using a
.csproj
as target for the runtime is no longer supported. You need to deploy the compiled binaries and point to those.
- Overall design is now easier for contributors to contribute to the product. This is very important for long-term lifetime of NetDaemon.
- Built to extend, the interfaces are minimal and default extensions are provided.
- Docker images has been improved to use a base image. Better separation between different type hosts (docker, add-on) etc.
The V3 uses CalVer versioning and is always the current version. Looking for V2 versions and updates, please use version 22.1.x
.
If you have issues or suggestions of improvements, please add an issue
Please join the Discord server to get support or if you want to contribute and help others.
https://netdaemon.xyz/docs/v3/started/installation
Please check out the apps being developed for netdaemon3. Since documentation is still lacking behind it will be best looking at real code ๐. To check out the new HassModel examples, please checkout the descriptions what user has adopted it below.
User | Description |
---|---|
@helto4real | Tomas netdaemon3 apps running in production |