From 42c77550f33aa8d87be7ddcd9cb455caa1836eab Mon Sep 17 00:00:00 2001
From: Igor <igor.pecovnik@gmail.com>
Date: Thu, 29 Aug 2024 08:30:44 +0200
Subject: [PATCH] Improve HA description (#6)

---
 README.md | 43 +++++++++++++++++++++++++++++++++++++------
 1 file changed, 37 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 294b200..aa7a5bb 100644
--- a/README.md
+++ b/README.md
@@ -2,15 +2,46 @@
   <a href="#">
   <img src="https://raw.githubusercontent.com/armbian/build/master/.github/armbian-logo.png" alt="Armbian logo" width="144">
   </a><br>
-  <strong>Armbian Linux Applications Images</strong>
+  <strong> Applications distributed as Armbian appliance</strong>
 <h2 align=center><a href=https://github.com/armbian/distribution/releases/latest><img src="https://img.shields.io/badge/Download%20latest%20images%3F-white?style=for-the-badge&color=green"></a>  </h2>
 </p>
 
-# Applications distributed as Armbian appliance
+## [Armbian Home Assistant](https://www.home-assistant.io/)  (home automation)
 
-- [Armbian Home Assistant](https://www.home-assistant.io/) - home automation
-- [Armbian OpenHab](https://www.openhab.org/) - home automation
-- [Armbian Security](https://www.kali.org/) (Armbian Trixie with pre-enabled Kali repository)
-- [Armbian OMV](https://www.openmediavault.org/) - network attached storage (NAS)
+Home Assistant is an open source smart home platform that allows you to connect your smart home devices like your TV, fan, cameras, thermostats, lights, and sensors. As a user, you can build intricate automation using Home Assistant's user-friendly, unified web-based user interface.
+
+Home Assistant Operating System is tailored for mainstream hardware such as Raspberry Pi and X86, while **Armbian Home Assistance**:
+- extends installation to [large selection of devices](https://www.armbian.com/download/),
+- provides option to use instance to host other applications,
+- allows extended customisation of your OS.
+
+|Functionality|HAOS|Armbian with HA|
+|:--|:--:|:--:|
+|Automations|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
+|Dashboards|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
+|Integrations|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
+|Add-ons|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
+|One-click updates|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
+|Backups|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
+|General purpose server|:x:|:white_check_mark:|
+|Running on exotic hardware|:x:|:white_check_mark:|
+
+FAQ:
+
+1. Where do I find images for my hardware?
+   
+https://www.armbian.com/download -> select your device -> Dedicated applications
+
+2. How do you generate my own image?
+
+[Follow instructions](https://forum.armbian.com/topic/33245-armbian-with-preinstalled-home-assistant-supervised/).
+
+3. There are no HA images for my device?
+
+If hardware is supported by Armbian ([.conf](https://github.com/armbian/build/tree/main/config/boards)), sent a pull request to the [configuration file](https://github.com/armbian/os/blob/main/userpatches/targets-release-apps.template).
+
+## [Armbian OpenHab](https://www.openhab.org/) (home automation)
+## [Armbian Security](https://www.kali.org/) (Security applications - Kali)
+## [Armbian OMV](https://www.openmediavault.org/) - (NAS: network attached storage)
 
 Sources: [extensions for Armbian build framework](https://github.com/armbian/os/tree/main/userpatches/extensions)