jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-15 21:36:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'current' into rc

Browse Source
This commit is contained in:
Franck Nijhof 2024-07-03 16:23:10 +02:00
commit e3effc0249
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3
34 changed files with 444 additions and 357 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
Gemfile.lock
View File

@ -88,7 +88,7 @@ GEM
prism (0.30.0)
public_suffix (6.0.0)
racc (1.8.0)
rack (3.1.4)
rack (3.1.6)
rack-protection (4.0.0)
base64 (>= 0.1.0)
rack (>= 3.0.0, < 4)
@ -130,9 +130,8 @@ GEM
ruby2_keywords (0.0.5)
safe_yaml (1.0.5)
sass (3.4.25)
sass-embedded (1.77.5)
sass-embedded (1.77.5-x86_64-linux-gnu)
google-protobuf (>= 3.25, < 5.0)
rake (>= 13)
sass-globbing (1.1.5)
sass (>= 3.1)
sassc (2.1.0-x86_64-linux)
@ -143,7 +142,7 @@ GEM
rack-protection (= 4.0.0)
rack-session (>= 2.0.0, < 3)
tilt (~> 2.0)
sorbet-runtime (0.5.11460)
sorbet-runtime (0.5.11466)
stringex (2.8.6)
strscan (3.1.0)
terminal-table (3.0.2)

81
sass/homeassistant/_overrides.scss
View File

@ -286,11 +286,12 @@ header .breadcrumbs {
.links {
margin-top: 12px;
margin-right: -8px;
margin-bottom: -8px;
font-size: .9rem;
text-align: right;
a {
background: #e8edf0;
background: #e8edf0;
font-family: $heading-font;
text-decoration: none;
font-weight: 650;
@ -363,7 +364,7 @@ a.material-card:hover {
border-radius: 24px;
margin: 8px 0;
transition: box-shadow .33s;
&::before {
content: " ";
position: absolute;
@ -401,7 +402,13 @@ a.material-card:hover {
}
}
/* not contained inside frontpage class */
.hero {
display: flex;
}
.frontpage {
.material-card {
margin-bottom: 24px;
}
@ -483,11 +490,11 @@ a.material-card:hover {
border: none;
.caption {
padding: 16px 12px 12px;
padding: 8px 12px 12px;
background-color: rgba(0, 0, 0, 0.54);
color: white;
border-bottom-left-radius: 8px;
border-bottom-right-radius: 8px;
border-bottom-left-radius: 16px;
border-bottom-right-radius: 16px;
display: flex;
justify-content: space-between;
align-items: center;
@ -495,9 +502,12 @@ a.material-card:hover {
.title {
font-size: 20px;
font-weight: 400;
line-height: 1.2em;
}
.subtitle {
margin-top: 4px;
line-height: 1.4em;
font-size: 12px;
font-weight: initial;
}
@ -532,26 +542,37 @@ a.material-card:hover {
margin-top: 24px;
}
.sponsored-by {
img {
border: 0;
border-radius: 0;
box-shadow: none;
margin: 15px;
max-width: 40%;
max-height: 80px;
.seen-press {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
column-gap: 24px;
row-gap: 24px;
margin: 48px 0;
h2 {
grid-column: 1/-1;
margin: 0;
text-align: center;
}
}
.seen-press {
a {
aspect-ratio: 1;
}
img {
border: 0;
box-shadow: none;
margin: 15px;
max-width: 40%;
max-height: 70px;
margin: 24px;
width: calc(100% - 48px);
max-height: 128px;
border-radius: 0;
}
.material-card {
height: 100%;
align-content: center;
text-align: center;
margin: 0;
}
.square {
@ -562,6 +583,18 @@ a.material-card:hover {
border-radius: 50%;
}
}
.sponsored-by {
text-align: center;
img {
border: 0;
border-radius: 0;
box-shadow: none;
margin: 24px;
max-height: 160px;
}
}
}
@media screen and (max-width: 700px) {
@ -620,7 +653,6 @@ article.page,
article.listing {
font-size: 1.125em;
line-height: 1.6;
overflow: hidden;
img,
table {
@ -681,6 +713,7 @@ article.listing {
overflow-wrap: break-word;
&.btn {
font-size: 1.1em;
text-decoration: none;
transition: box-shadow .33;
@ -728,8 +761,8 @@ article.listing {
&>li.toc-entry:first-child{
padding-top: 0;
}
}
&>li.toc-entry {
list-style-type: none;
}
@ -895,7 +928,7 @@ div.config-vars {
.config-vars-label {
padding-bottom: 4px;
position: relative;
a.title-link {
text-decoration: none;
}
@ -1052,4 +1085,4 @@ a.my {
position: fixed;
width: 100%;
z-index: 999;
}
}

2
sass/homeassistant/base/_sidebar.scss
View File

@ -44,6 +44,8 @@
@media only screen and (max-width: $lap-end) {
#sidebar {
max-height: fit-content;
.grid {
position: initial;
width: 100%;

4
sass/homeassistant/homepage/_features.scss
View File

@ -26,11 +26,11 @@
}
.card-content {
padding-left: 24px;
padding-bottom: 24px;
p:last-of-type,
ul {
margin-bottom: 12px;
margin-bottom: 32px;
}
}
}

20
sass/homeassistant/homepage/_hero_unit.scss
View File

@ -8,7 +8,7 @@
padding-bottom: 0;
margin-top: -88px;
margin-bottom: 24px;
padding-top: 88px;
padding-top: 88px;
overflow: hidden;
border-bottom: 1px solid rgba(0, 0, 0, 0.1);
max-height: 1080px;
@ -62,7 +62,7 @@
background-color: $link-color;
font-size: 2rem;
font-weight: 700;
padding: 8px 24px;
padding: 8px 20px 8px 28px;
margin-bottom: 16px;
}
}
@ -84,7 +84,7 @@
// animation-duration: 3s;
// animation-iteration-count: infinite;
// animation-direction: alternate;
@media only screen and (max-height: 720px) {
border-bottom: 0;
margin-bottom: -8px;
@ -114,7 +114,7 @@
.lead {
font-size: 1.15rem;
}
.hero-buttons a {
&.primary {
font-size: 1.25rem;
@ -123,15 +123,19 @@
}
}
@media only screen and (max-width: $palm-end) {
@media only screen and (max-width: 760px) {
.hero {
.flex {
flex-direction: column;
}
#HAdemo {
display: none;
}
#HAdemoScreenshot {
display: block;
}
}
}
}

19
sass/homeassistant/pages/_getting_started.scss
View File

@ -126,19 +126,32 @@
.button {
display: flex;
align-items: center;
padding-right: 20px;
border-radius: 32px;
&:not(:first-child) {
margin-top: 12px;
}
&.accent {
background-color: #34b155;
iconify-icon.external-link {
padding-top: 4px;
}
svg {
fill: white;
fill: $link-color;
height: 24px;
min-width: 24px;
}
&.accent {
background-color: #34b155;
color: white;
svg {
fill: white;
}
}
}
}
}

7
sass/homeassistant/pages/_landingpage.scss
View File

@ -11,6 +11,13 @@ $ha__primary_color: #03a9f4;
}
}
footer {
.grid-wrapper {
max-width: 1100px !important;
padding: 0 25px !important;
}
}
.grid-wrapper {
max-width: 1500px;
padding: 0;

2
source/_docs/backend/database.markdown
View File

@ -5,7 +5,7 @@ description: "Details about the database used by Home Assistant."
Home Assistant uses databases to store {% term events %} and parameters for history and tracking. The default database used is [SQLite](https://www.sqlite.org/).
The database file is stored in your [configuration directory](/getting-started/configuration/) (e.g., `<path to config dir>/home-assistant_v2.db`); however, other databases can be used. If you prefer to run a database server (e.g., PostgreSQL), use the [`recorder`](/integrations/recorder/) integration.
The database file is stored in your [configuration directory](/docs/configuration/#to-find-the-configuration-directory) (e.g., `<path to config dir>/home-assistant_v2.db`); however, other databases can be used. If you prefer to run a database server (e.g., PostgreSQL), use the [`recorder`](/integrations/recorder/) integration.
To work with SQLite database manually from the command-line, you will need an [installation](https://www.sqlitetutorial.net/download-install-sqlite/) of `sqlite3`. Alternatively [DB Browser for SQLite](https://sqlitebrowser.org/) provides a viewer for exploring the database data and an editor for executing SQL commands.
First load your database with `sqlite3`:

6
source/_docs/configuration.markdown
View File

@ -70,6 +70,12 @@ To set up file access, follow the steps for your [installation method](/installa
- {% term "Home Assistant Core" %}: the `configuration.yaml` is in the config folder passed to the `hass` command (default is `~/.homeassistant`).
3. Once you located the config folder, you can edit your `configuration.yaml` file.
{% note %}
If you have watched any videos about setting up Home Assistant using `configuration.yaml` (particularly ones that are old), you might notice your default configuration file is much smaller than what the videos show. Don't be concerned, you haven't done anything wrong. Many items in the default configuration files shown in those old videos are now included in the `default_config:` line that you see in your configuration file. Refer to the [default config integration](/integrations/default_config/) for more information on what's included in that line.
{% endnote %}
## Validating the configuration
After changing configuration or automation files, you can check if the configuration is valid. A configuration check is also applied automatically when you reload the configuration or when you restart Home Assistant.

8
source/_faq/python.markdown
View File

@ -1,8 +0,0 @@
---
title: "Python 2"
description: "Support for Python 2"
ha_category: Common
---
There will be no support for Python 2.x. Python 2 will be EOL in [2020](https://www.python.org/dev/peps/pep-0373/#id2) and it doesn't make any sense to support a release which was planned to be retired in 2015.

2
source/_includes/asides/about.html
View File

@ -1,5 +1,5 @@
<section class="aside-module grid__item one-whole lap-one-half">
<h1 class="title epsilon">About Home Assistant</h1>
<h1 class="title epsilon"><iconify-icon inline icon="mdi:about-circle-outline"></iconify-icon> About Home Assistant</h1>
<ul class="divided">
<li>
{{ site.description }}

2
source/_includes/asides/categories.html
View File

@ -1,5 +1,5 @@
<section class="aside-module grid__item one-whole lap-one-half">
<h1 class="title epsilon">Categories</h1>
<h1 class="title epsilon"><iconify-icon inline icon="mdi:category"></iconify-icon> Categories</h1>
<ul class="divided">
{% assign categories = site.categories | sort %}
{% for category in categories %}

8
source/_includes/asides/dashboards_navigation.html
View File

@ -2,7 +2,7 @@
{% assign elements = site.dashboards | sort_natural: 'title' %}
<div class="section">
<h1 class="title epsilon">Dashboards</h1>
<h1 class="title epsilon"><iconify-icon icon="mdi:view-dashboard"></iconify-icon> Dashboards</h1>
<ul class="divided sidebar-menu">
<li>{% active_link /dashboards/ Introduction %}</li>
<li>
@ -21,7 +21,7 @@
</div>
<div class="section">
<h1 class="title epsilon">View types</h1>
<h1 class="title epsilon"><iconify-icon icon="mdi:about-circle-outline"></iconify-icon> View types</h1>
<ul class="divided sidebar-menu">
{% for element in elements %}
{% if element.type == "view" %}
@ -32,7 +32,7 @@
</div>
<div class="section">
<h1 class="title epsilon">Card types</h1>
<h1 class="title epsilon"><iconify-icon inline icon="mdi:card-multiple-outline"></iconify-icon> Card types</h1>
<ul class="divided sidebar-menu">
{% for element in elements %}
{% if element.type == "card" %}
@ -43,7 +43,7 @@
</div>
<div class="section">
<h1 class="title epsilon">Advanced</h1>
<h1 class="title epsilon"><iconify-icon inline icon="mdi:cog"></iconify-icon> Advanced</h1>
<ul class="divided sidebar-menu">
<li>{% active_link /dashboards/features/ Features %}</li>
<li>{% active_link /dashboards/header-footer/ Headers & footers %}</li>

2
source/_includes/asides/getting_started_navigation.html
View File

@ -17,7 +17,7 @@
%}
</li>
<li>
{% active_link /getting-started/configuration/ Advanced configuration %}
{% active_link /getting-started/configuration/ Next steps %}
</li>
</ul>
</div>

2
source/_includes/asides/recent_posts.html
View File

@ -1,5 +1,5 @@
<section id="recent-posts" class="aside-module grid__item one-whole lap-one-half">
<h1 class="title epsilon">Recent Posts</h1>
<h1 class="title epsilon"><iconify-icon inline icon="mdi:newspaper-variant-multiple"></iconify-icon> Recent Posts</h1>
<ul class="divided">
{% for post in site.posts limit: site.recent_posts %}
{% if post.url != page.url %}

8
source/_includes/asides/voice_navigation.html
View File

@ -2,7 +2,7 @@
{% assign elements = site.dashboards | sort_natural: 'title' %}
<div class="section">
<h1 class="title epsilon">Devices</h1>
<h1 class="title epsilon"><iconify-icon icon="mdi:devices"></iconify-icon> Devices</h1>
<ul class="divided sidebar-menu">
<li>{% active_link /voice_control/android/ Assist for Android %}</li>
<li>{% active_link /voice_control/apple/ Assist for Apple %}</li>
@ -11,7 +11,7 @@
</div>
<div class="section">
<h1 class="title epsilon">{% active_link /voice_control/ Voice assistants %}</h1>
<h1 class="title epsilon"><iconify-icon inline icon="mdi:comment-processing-outline"></iconify-icon> {% active_link /voice_control/ Voice assistants %}</h1>
<ul class="divided sidebar-menu">
<li>{% active_link /voice_control/voice_remote_local_assistant/ Configuring a local assistant %}</li>
<li>{% active_link /voice_control/voice_remote_cloud_assistant/ Configuring a cloud assistant %}</li>
@ -27,7 +27,7 @@
</div>
<div class="section">
<h1 class="title epsilon">Projects</h1>
<h1 class="title epsilon"><iconify-icon inline icon="mdi:checkbox-marked"></iconify-icon> Projects</h1>
<ul class="divided sidebar-menu">
<li>{% active_link /voice_control/s3_box_voice_assistant/ Tutorial: ESP32-S3-BOX voice assistant %}</li>
<li>{% active_link /voice_control/s3-box-customize/ Tutorial: Customize the S3-BOX %}</li>
@ -38,7 +38,7 @@
</ul>
</div>
<div class="section">
<h1 class="title epsilon">Troubleshooting</h1>
<h1 class="title epsilon"><iconify-icon inline icon="mdi:account-help"></iconify-icon> Troubleshooting</h1>
<ul class="divided sidebar-menu">
<li>{% active_link /voice_control/troubleshooting/ Troubleshooting Assist %}</li>
<li>{% active_link /voice_control/troubleshooting_the_s3_box/ Troubleshooting the ESP32-S3-BOX %}</li>

231
source/_includes/custom/features.html
View File

@ -1,119 +1,128 @@
<div class="feature-cards">
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:lightbulb-variant-outline"></iconify-icon>
Works with over 1000 brands
</div>
<div class="card-content">
<p>
Home Assistant integrates with over a thousand different devices
and services.
</p>
<section class="grid features">
<div class="grid__item one-whole">
<h2 class="sub-title">Features</h2>
<p>
Once started, Home Assistant will automatically scan your network for
known devices and allow you to easily set them up.
</p>
<a class="button" href="/integrations">EXPLORE INTEGRATIONS</a>
</div>
</div>
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:robot-happy-outline"></iconify-icon>
Powerful automations
</div>
<div class="card-content">
<p>
Once you have integrated all your devices at home, you can unleash Home
Assistant’s advanced automation engine to make your home work for you.
</p>
<div class="feature-cards">
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:lightbulb-variant-outline"></iconify-icon>
Works with over 1000 brands
</div>
<div class="card-content">
<p>
Home Assistant integrates with over a thousand different devices
and services.
</p>
<ul>
<li>Turn on the light when the sun sets or when coming home</li>
<li>Alert you when you leave your garage door open.</li>
</ul>
<a class="button" href="/docs/automation">EXPLORE AUTOMATIONS</a>
</div>
</div>
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:puzzle"></iconify-icon>
Extend your system with add-ons
</div>
<div class="card-content">
<p>
Home Assistant is not just limited to Home Assistant. Easily install
other applications that will help you manage your home.
</p>
<p>
Once started, Home Assistant will automatically scan your network for
known devices and allow you to easily set them up.
</p>
<a class="button" href="/integrations">EXPLORE INTEGRATIONS</a>
</div>
</div>
<ul>
<li>Run AdGuard, a DNS-based ad blocker</li>
<li>Run third party automation engines like NodeRed</li>
<li>Turn Home Assistant into a Spotify Connect target</li>
</ul>
<a class="button" href="/addons">EXPLORE ADD-ONS</a>
</div>
</div>
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:shield-home-outline"></iconify-icon>
All your smart home data stays local
</div>
<div class="card-content">
<p>Home Assistant keeps your data local, no need for a cloud.</p>
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:robot-happy-outline"></iconify-icon>
Powerful automations
</div>
<div class="card-content">
<p>
Once you have integrated all your devices at home, you can unleash Home
Assistant’s advanced automation engine to make your home work for you.
</p>
<p>
Home Assistant communicates with your devices locally, and will fallback
to pulling in data from the cloud if there is no other option. No data
is stored in the cloud, and everything is processed locally.
</p>
</div>
</div>
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:cellphone"></iconify-icon>
Companion Mobile Apps
</div>
<div class="card-content">
<p>
Use the official Home Assistant apps, a convenient companion to quickly
control your devices and be notified when things happen in your home,
even on your wrist using the Apple Watch.
</p>
<ul>
<li>Turn on the light when the sun sets or when coming home</li>
<li>Alert you when you leave your garage door open.</li>
</ul>
<a class="button" href="/docs/automation">EXPLORE AUTOMATIONS</a>
</div>
</div>
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:puzzle"></iconify-icon>
Extend your system with add-ons
</div>
<div class="card-content">
<p>
Home Assistant is not just limited to Home Assistant. Easily install
other applications that will help you manage your home.
</p>
<p>
The apps can also be used to send your location home to use presence
detection as part of your automations. Data is sent directly to your
home, no access by third-parties.
</p>
<a
class="button"
href="https://companion.home-assistant.io/"
target="_blank"
>
DOWNLOAD APPS
</a>
</div>
</div>
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:solar-power-variant"></iconify-icon>
Home Energy Management
</div>
<div class="card-content">
<p>
Home Assistant allows you to get on top of your energy use with its
home energy management feature. Gain new insights,
optimize your solar panel production, plan energy usage and save money.
</p>
<ul>
<li>Run AdGuard, a DNS-based ad blocker</li>
<li>Run third party automation engines like NodeRed</li>
<li>Turn Home Assistant into a Spotify Connect target</li>
</ul>
<a class="button" href="/addons">EXPLORE ADD-ONS</a>
</div>
</div>
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:shield-home-outline"></iconify-icon>
All your smart home data stays local
</div>
<div class="card-content">
<p>Home Assistant keeps your data local, no need for a cloud.</p>
<a
class="button"
href="/home-energy-management/"
aria-label="Learn more about Home Energy Management"
>
LEARN MORE
</a>
<p>
Home Assistant communicates with your devices locally, and will fallback
to pulling in data from the cloud if there is no other option. No data
is stored in the cloud, and everything is processed locally.
</p>
</div>
</div>
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:cellphone"></iconify-icon>
Companion Mobile Apps
</div>
<div class="card-content">
<p>
Use the official Home Assistant apps, a convenient companion to quickly
control your devices and be notified when things happen in your home,
even on your wrist using the Apple Watch.
</p>
<p>
The apps can also be used to send your location home to use presence
detection as part of your automations. Data is sent directly to your
home, no access by third-parties.
</p>
<a
class="button"
href="https://companion.home-assistant.io/"
target="_blank"
>
DOWNLOAD APPS
</a>
</div>
</div>
<div class="card">
<div class="card-header">
<iconify-icon inline icon="mdi:solar-power-variant"></iconify-icon>
Home Energy Management
</div>
<div class="card-content">
<p>
Home Assistant allows you to get on top of your energy use with its
home energy management feature. Gain new insights,
optimize your solar panel production, plan energy usage and save money.
</p>
<a
class="button"
href="/home-energy-management/"
aria-label="Learn more about Home Energy Management"
>
LEARN MORE
</a>
</div>
</div>
</div>
</div>
</div>
</section>

2
source/_includes/javascripts/scripts.html
View File

@ -23,7 +23,7 @@ document.querySelector('.site-title').addEventListener('contextmenu', function(e
const changeNavColor = () => {
const scrollPosition = document.documentElement.scrollTop;
const nav = document.querySelector("header");
if (scrollPosition <= 10) {
if (scrollPosition <= 1) {
nav.classList.add("dark");
} else {
nav.classList.remove("dark");

2
source/_includes/post/sharing.html
View File

@ -1,5 +1,5 @@
<section class="sharing aside-module grid__item one-whole lap-one-half">
<h1 class="title epsilon">Share this post</h1>
<h1 class="title epsilon"><iconify-icon inline icon="mdi:ios-share"></iconify-icon> Share this post</h1>
<ul class="divided">
{% if site.twitter_tweet_button %}
<li>

7
source/_includes/site/footer.html
View File

@ -33,6 +33,7 @@
<a class="external-link" href="https://community.home-assistant.io">Community Forum <iconify-icon inline icon="tabler:external-link"></iconify-icon></a>
</li>
<li><a href="/help/reporting_issues/">Reporting issues</a></li>
<li><a href="https://home-assistant-store.creator-spring.com/">Community Merch Store</a></li>
</ul>
<h4>System status</h4>
<ul>
@ -47,6 +48,12 @@
</div>
<div class="grid__item one-quarter lap-one-half palm-one-whole">
<h4>Companion apps</h4>
<ul>
<li><a class="external-link" href="https://apps.apple.com/us/app/home-assistant/id1099568401">iOS and Apple devices</a></li>
<li><a class="external-link" href="https://play.google.com/store/apps/details?id=io.homeassistant.companion.android">Android and Wear OS</a></li>
<li><a class="external-link" href="https://companion.home-assistant.io/">...and more!</a></li>
</ul>
<h4>Governance</h4>
<ul>
<li><a href="/privacy/">Privacy Notices</a></li>

6
source/_includes/site/hero_unit.html
View File

@ -1,12 +1,12 @@
<div class="hero">
<div class="grid-wrapper">
<div class="grid flex">
<div class="grid__item flex__item three-fifths lap-one-half palm-one-whole">
<div class="grid__item flex__item three-fifths lap-one-whole palm-one-whole">
{% include custom/welcome.html %}
</div>
<div class="grid__item flex__item two-fifths lap-one-half palm-one-whole">
<div class="grid__item flex__item two-fifths lap-one-whole palm-one-whole">
<iframe id="HAdemo" title="Home Assistant Demo"
src="https://demo.home-assistant.io/">
src="https://demo.home-assistant.io/?frontpage">
</iframe>
<a id="HAdemoScreenshot" href='https://demo.home-assistant.io/' target='_blank'>

10
source/_integrations/aprilaire.markdown
View File

@ -1,6 +1,6 @@
---
title: Aprilaire
description: Instructions on how to integrate Aprilaire devices into Home Assistant.
title: AprilAire
description: Instructions on how to integrate AprilAire devices into Home Assistant.
ha_category:
- Climate
ha_iot_class: Local Push
@ -16,11 +16,11 @@ ha_platforms:
ha_integration_type: device
---
The Aprilaire integration allows you to control an Aprilaire thermostat.
The AprilAire integration allows you to control an AprilAire thermostat.
## Supported Models
This integration supports Aprilaire [8800-series Home Automation Wi-Fi Thermostats](https://www.aprilaire.com/whole-house-products/thermostats/home-automation) and [6000-series Wi-Fi Zone Control devices](https://www.aprilaire.com/whole-house-products/zone-control) which support setting the thermostat to automation mode. It is known that there are some models which are marketed as home automation capable that do not support automation mode, and are therefore not supported.
This integration supports AprilAire [8800-series Home Automation Wi-Fi Thermostats](https://www.aprilaire.com/whole-house-products/thermostats/home-automation) and [6000-series Wi-Fi Zone Control devices](https://www.aprilaire.com/whole-house-products/zone-control) which support setting the thermostat to automation mode. It is known that there are some models which are marketed as home automation capable that do not support automation mode, and are therefore not supported.
## Prerequisites
@ -30,4 +30,4 @@ In order to connect to the thermostat, you will need to enable automation mode.
## Caution regarding device limitations
Due to limitations of the thermostats, only one automation connection to a device is permitted at one time (the Aprilaire app is not included in this limitation as it uses a separate protocol). Attempting to connect multiple times to the same thermostat simultaneously can cause various issues, including the thermostat becoming unresponsive and shutting down. If this does occur, power cycling the thermostat should restore functionality.
Due to limitations of the thermostats, only one automation connection to a device is permitted at one time (the AprilAire app is not included in this limitation as it uses a separate protocol). Attempting to connect multiple times to the same thermostat simultaneously can cause various issues, including the thermostat becoming unresponsive and shutting down. If this does occur, power cycling the thermostat should restore functionality.

6
source/_integrations/broadlink.markdown
View File

@ -29,7 +29,11 @@ related:
title: Configuration file
---
The **Broadlink** {% term integration %} allows you to control and monitor Broadlink universal remotes, smart plugs, power strips, switches and sensors. The following devices are supported:
The **Broadlink** {% term integration %} allows you to control and monitor Broadlink universal remotes, smart plugs, power strips, switches and sensors.
The manufacturer's app is required in order to connect new devices to the network.
The following devices are supported:
- Thermostats: `Hysen HY02B05H` and `Floureon HY03WE`
- Power Strips: `MP1-1K3S2U` and `MP1-1K4S`

1
source/_integrations/ecovacs.markdown
View File

@ -8,7 +8,6 @@ ha_category:
ha_iot_class: Cloud Push
ha_release: 0.77
ha_codeowners:
- '@OverloadUT'
- '@mib1185'
- '@edenhaus'
- '@Augar'

2
source/_integrations/glances.markdown
View File

@ -22,7 +22,7 @@ The `glances` integration allows you to monitor the system information provided
Support for Glances api version 2 is deprecated. It is recommended to upgrade your Glances server to version 3. Once upgraded, reload the integration to connect again.
{% endimportant %}
These sensors needs a running instance of `glances` on the host. The minimal supported version of `glances` is 2.3.
These sensors needs a running instance of `glances` in [Web Server Mode](https://glances.readthedocs.io/en/latest/quickstart.html#web-server-mode) on the host. The minimal supported version of `glances` is 2.3.
For details about auto-starting `glances`, please refer to [Start Glances through Systemd](https://github.com/nicolargo/glances/wiki/Start-Glances-through-Systemd).

4
source/_integrations/marytts.markdown
View File

@ -14,7 +14,7 @@ related:
title: Configuration file
---
The `marytts` text-to-speech {% term integration %} uses [MaryTTS](http://mary.dfki.de/) text-to-speech engine to read a text with natural sounding voices.
The `marytts` text-to-speech {% term integration %} uses [MaryTTS](https://marytts.github.io/) text-to-speech engine to read a text with natural sounding voices.
## Configuration
@ -59,7 +59,7 @@ effect:
type: map
{% endconfiguration %}
See [documentation](http://mary.dfki.de/documentation/index.html) for details.
See [documentation](https://marytts.github.io/documentation/index.html) for details.
## Speech effects

1
source/_integrations/reolink.markdown
View File

@ -301,6 +301,7 @@ Battery-powered Reolink cameras can be used with Home Assistant with the help of
The following battery-powered models have been tested and confirmed to work through the Reolink Home Hub:
- [Argus 4 Pro](https://reolink.com/product/argus-4-pro/)
- [Argus Eco Ultra](https://reolink.com/product/argus-eco-ultra/)
- [Argus Track](https://reolink.com/product/argus-track/)
- [Reolink Doorbell Battery](https://reolink.com/roadmap/)

4
source/_integrations/technove.markdown
View File

@ -50,4 +50,6 @@ The {% term integration %} adds the following sensors:
The {% term integration %} adds the following switch:
- Auto-charge mode
| Name | Description |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Auto-charge mode | When enabled, vehicles will start charging automatically when plugged in. When turned off, charging will need to be manually started each time a vehicle is plugged in. Note: Disabling auto-charge mode does not interrupt an ongoing charging session. |

73
source/getting-started/configuration.markdown
View File

@ -1,59 +1,48 @@
---
title: "Advanced Configuration"
description: "Instructions to get Home Assistant configured."
title: "Next steps"
description: "Next steps in configuring your Home Assistant"
related:
- docs: configuration/basic/
title: Changing basic settings
- docs: /docs/configuration/
title: configuration.yaml file
- docs: /common-tasks/os/#network-storage
title: Network storage
- docs: /common-tasks/os/#backups
title: Backups
- docs: /voice_control/
title: Voice control
- url: https://companion.home-assistant.io/
title: Home Assistant on Android and iOS
---
The onboarding process takes care of the initial setup for Home Assistant, such as naming your home and selecting your location. After initial onboarding, these options can be changed in the user interface by clicking on Configuration in the sidebar and clicking on General, or by manually editing them in the Home Assistant configuration file called `configuration.yaml`. This section will explain how to do the latter.
The onboarding process takes you through the initial setup for Home Assistant, such as getting the system up and running, naming your home and selecting your location. This section points you to further documentation helping you with the next steps.
{% note %}
The steps below do not apply to Home Assistant Core & Container installations, for those types of installations, [see here](/docs/configuration/).
{% endnote %}
## Changing the basic settings
We are going to help you make your first changes to `configuration.yaml`. To do this, we are going to install an add-on from the Home Assistant add-on store: the File editor. To get to the add-on store, go to {% my supervisor title="Settings > Add-ons" %}. On the new page, open the add-on store tab.
To change basic settings such as location, unit system and language, refer to [Changing basic settings](/docs/configuration/basic/).
![Add-on store.](/images/hassio/screenshots/dashboard.png)
## Creating a backup
Under the **Official add-ons** section, you will find the **File editor** add-on.
You can back up your Home Assistant, add-on data, and configuration. Backups are used to restore a system or parts of it if a rollback is needed, or to migrate your Home Assistant to new hardware. It is good practice to create a backup before updating.
- Click on **File editor** and click on **Install**. When the installation is complete, the UI will go to the add-on details page for the file editor.
- Now start the add-on by clicking on **Start**.
- Open the user interface by clicking on **Open Web UI**.
To learn how to create a backup of your Home Assistant installation, refer to the following topics:
Now let's make a change using the file editor: we are going to change the name, location, unit system, and time zone of your Home Assistant installation.
- {% term "Home Assistant Operating System" %}: [Creating a backup from OS](/common-tasks/os/#backups)
- {% term "Home Assistant Supervised" %}: [Creating a backup from Supervised](/common-tasks/supervised/#backups)
- Click the folder icon in the top left of the file editor window to open the file browser sidebar.
- Click the `configuration.yaml` file (in the `/config/` folder) to load it into the main file editor window.
- Add the following to this file (preferably at the very top, but it ultimately doesn't matter):
```yaml
homeassistant:
name: Home
latitude: xx.xxxx
longitude: xx.xxxx
unit_system: us_customary
time_zone: America/Chicago
```
{% note %}
Valid options for `unit_system` are `us_customary` or `metric`. See [here](https://timezonedb.com/time-zones) for a list of valid time zones. Enter the appropriate option found under the Time Zone column at that page.
## Editing the configuration.yaml and configuring file access
{% endnote %}
While you can configure most of Home Assistant from the user interface, for some integrations, you will need to [edit the `configuration.yaml` file](/docs/configuration/). This file contains integrations to be loaded along with their configurations. Throughout the documentation, you will find snippets that you can add to your configuration file to enable specific functionality. For starters, there is no need to edit the `configuration.yaml` file. You will be pointed to the documentation when this is needed.
- Click the save icon in the top right to commit changes.
- Most changes in `configuration.yaml` require Home Assistant to be restarted to see the changes. You can verify that your changes are acceptable by running a configuration check. Do this by navigating to {% my server_controls title="Developer Tools > YAML" %} and then clicking on the **Check configuration** button. When it's valid, it will show the text "Configuration valid!". In order for the **Check Configuration**" button to be visible, you must enable **Advanced Mode** on your user profile.
- Now restart Home Assistant. You can do so by either using the **Restart** option in the ⚙ menu of the File Editor UI or by navigating to {% my system_dashboard title="Settings > System" %} and then clicking on the **Restart** button on the top right of the page.
## Setting up network storage
![Screenshot of the "General" page in the configuration panel.](/images/screenshots/configuration-validation.png)
If you need more space to store data, you can configure a [network storage](/common-tasks/os/#network-storage), for example to store backups or to access media.
{% note %}
## Getting started with voice assistant
If you have watched any videos about setting up Home Assistant using `configuration.yaml` (particularly ones that are old), you might notice your default configuration file is much smaller than what the videos show. Don't be concerned, you haven't done anything wrong. Many items in the default configuration files shown in those old videos are now included in the `default_config:` line that you see in your configuration file. [See here](/integrations/default_config/) for more information on what's included in that line.
If you want to get started with a voice assistant, refer to the documentation on [Assist](/voice_control/).
{% endnote %}
## Apps for Android and iOS
### Editing configuration via Samba/Windows Networking
Maybe you are not a big fan of our web editor and want to use a text editor on your computer instead. This is possible by sharing the configuration over the network using the Samba add-on, which can also be installed from the Home Assistant add-on store. This will make your configuration accessible via the network tab on your computer.
Go to the add-on store and look for Samba in the core section. After you have installed the add-on, click on **Start**. Home Assistant should now be available in the networking tab on your computer.
We suggest that to edit `configuration.yaml`, you use the free text editor [Visual Studio Code](https://code.visualstudio.com/) in combination with the [Home Assistant Configuration Helper extension](https://marketplace.visualstudio.com/items?itemName=keesschollaart.vscode-home-assistant).
If you are looking for information on Home Assistant for Android or iOS, refer to the [documentation for the Companion Apps](https://companion.home-assistant.io/).

2
source/getting-started/index.markdown
View File

@ -15,4 +15,4 @@ show_title: true
{% include getting-started/next_step.html step="Automation" link="/getting-started/automation/" icon="mdi:robot-happy" %}
{% include getting-started/next_step.html step="Presence detection" link="/getting-started/presence-detection/" icon="mdi:motion-detector" %}
{% include getting-started/next_step.html step="Join the community" link="/getting-started/join-the-community/" icon="mdi:people-group-outline" %}
{% include getting-started/next_step.html step="Advanced Configuration" link="/getting-started/configuration/" icon="mdi:cog" %}
{% include getting-started/next_step.html step="Next steps" link="/getting-started/configuration/" icon="mdi:cog" %}

2
source/getting-started/join-the-community.markdown
View File

@ -7,7 +7,7 @@ You made it here? Good job! You've been able to install Home Assistant and get a
Now that you've got that going, let's see what is next:
- Learn about [advanced configuration](/getting-started/configuration/) using `configuration.yaml` in our bonus step of the getting started guide.
- Learn about [next steps](/getting-started/configuration/) of the getting started guide, such as creating a backup or configuring network storage.
- Join the community in [our forums] or [our chat].
- Check out [video tutorials] on a wide range of Home Assistant related topics

6
source/green/styles.css
View File

@ -75,10 +75,8 @@ article.page h3 {
text-transform: unset;
}
@media only screen and (max-width: 480px) {
#landingpage .page-content {
padding-top: 68px;
}
#landingpage .page-content {
padding-top: 68px;
}
.exploded-view-animation {

252
source/index.html
View File

@ -7,10 +7,10 @@ regenerate: true
feedback: false
---
{% assign recent_release_post = site.categories['Core'].first %}
<div class="frontpage">
<div class="grid">
<!-- Left sidebar begins -->
<div class="grid__item one-third lap-one-third palm-one-whole">
<div class="recent-posts material-card text">
@ -75,8 +75,10 @@ feedback: false
style="background-image: url(/images/frontpage/cast-frontpage.png)"
>
<div class="caption">
<div class="title">
Take over all the screens
<div>
<div class="title">
Take over all the screens
</div>
<div class="subtitle">
Home Assistant Cast makes every TV a display.
</div>
@ -89,6 +91,9 @@ feedback: false
</div>
</a>
</div>
<!-- Left sidebar ends -->
<!-- Right content begins -->
<div class="grid__item two-thirds lap-two-thirds palm-one-whole">
<!-- State of the Open Home -->
<a
@ -111,8 +116,10 @@ feedback: false
"
>
<div class="caption">
<div class="title">
Control your home with Assist
<div>
<div class="title">
Control your home with Assist
</div>
<div class="subtitle">
Our private, insanely fast, voice assistant running on affordable
hardware. Now supporting wake words.
@ -139,8 +146,10 @@ feedback: false
"
>
<div class="caption">
<div class="title">
{{page.title}}
<div>
<div class="title">
{{page.title}}
</div>
<div class="subtitle">{{page.description}}</div>
</div>
<svg viewBox="0 0 24 24">
@ -170,8 +179,10 @@ feedback: false
"
>
<div class="caption">
<div class="title">
Home Assistant Tags
<div>
<div class="title">
Home Assistant Tags
</div>
<div class="subtitle">
Use NFC to bring music to your life or automate the mundane.
</div>
@ -190,8 +201,10 @@ feedback: false
style="background-image: url(/images/merchandise/shirt-frontpage.png)"
>
<div class="caption">
<div class="title">
Join the Home Assistant t-shirt revolution!
<div>
<div class="title">
Join the Home Assistant t-shirt revolution!
</div>
<div class="subtitle">
Look sharp in blue, black or gray. Wearing a HA t-shirt is okay.
</div>
@ -204,117 +217,126 @@ feedback: false
</div>
</a>
</div>
<!-- Right content ends -->
<div class="sub-title">Features</div>
<!-- Features section -->
{% include custom/features.html %}
<div class="grid sponsors-and-press">
<div class="sponsored-by grid__item one-half lap-one-half palm-one-whole">
<div class="material-card text">
<h1>Home Assistant is sponsored by</h1>
<!-- Press section -->
<section class="grid sponsors-and-press">
<div class="seen-press grid__item one-whole">
<h2>Home Assistant in the press</h2>
<a
href="https://www.theverge.com/2021/9/16/22678088/home-assistant-amber-smart-home-hub-specs-release-date-price"
target="_blank"
rel="noopener"
><div class="material-card"><img alt="The Verge logo" src="/images/press/theverge.svg"
/></div></a>
<a
href="https://arstechnica.com/information-technology/2021/03/how-to-achieve-smart-home-nirvana-or-home-automation-without-subscription/"
target="_blank"
rel="noopener"
><div class="material-card"><img
alt="ArsTechnica.com logo"
src="/images/press/arstechnica.svg"
/></div></a>
<a
href="https://tweakers.net/reviews/8704/paulus-schoutsen-home-assistant-concurreert-met-alles-wat-via-de-cloud-gaat.html"
target="_blank"
rel="noopener"
><div class="material-card"><img alt="Tweakers.net logo" src="/images/press/tweakers.png"
/></div></a>
<a
href="https://www.youtube.com/watch?v=x7pSkVarixU"
target="_blank"
rel="noopener"
><div class="material-card"><img
alt="Linus Tech Tips logo"
class="square"
src="/images/press/ltt.svg"
/></div></a>
<a
href="https://www.troyhunt.com/iot-unravelled-part-1-its-a-mess-but-then-theres-home-assistant/"
target="_blank"
rel="noopener"
><div class="material-card"><img
class="square round"
alt="Troy Hunt logo"
src="/images/press/troyhunt.jpg"
/></div></a>
<a
href="https://www.tomshardware.com/news/raspberry-pi-home-assistant-amber"
target="_blank"
rel="noopener"
><div class="material-card"><img
alt="Tom's Hardware logo"
src="/images/press/tomshardware.svg"
/></div></a>
<a
href="https://www.producthunt.com/posts/home-assistant"
target="_blank"
rel="noopener"
><div class="material-card"><img
alt="ProductHunt.com logo"
src="/images/press/producthunt.com.png"
/></div></a>
<a
href="https://www.linux.com/news/home-assistant-python-approach-home-automation-video"
target="_blank"
rel="noopener"
><div class="material-card"><img alt="Linux.com logo" src="/images/press/linux.com.png"
/></div></a>
<a
href="https://opensource.com/article/17/7/home-automation-primer"
target="_blank"
rel="noopener"
><div class="material-card"><img
alt="OpenSource.com logo"
src="/images/press/opensource.com.svg"
/></div></a>
<a
href="http://www.linux-magazine.com/Issues/2017/203/Home-Assistant"
target="_blank"
rel="noopener"
><div class="material-card"><img
alt="Linux Magazine logo"
src="/images/press/LinuxMagazine.png"
/></div></a>
<a
href="https://www.heise.de/select/ct/2017/26/1513910625909214"
target="_blank"
rel="noopener"
><div class="material-card"><img alt="Ct logo" src="/images/press/ct.png"
/></div></a>
</div>
</section>
<!-- Sponsor section -->
<section class="sponsor">
<div class="sponsored-by grid__item one-whole">
<h2>The Home Assistant project is sponsored by</h2>
<div class="material-card text">
<a href="https://www.nabucasa.com"
><img alt="Nabu Casa logo" src="/images/sponsors/nabu_casa.svg"
/></a>
</div>
</div>
<div class="seen-press grid__item one-half lap-one-half palm-one-whole">
<div class="material-card text">
<h1>Home Assistant in the press</h1>
</section>
<a
href="https://www.theverge.com/2021/9/16/22678088/home-assistant-amber-smart-home-hub-specs-release-date-price"
target="_blank"
rel="noopener"
><img alt="The Verge logo" src="/images/press/theverge.svg"
/></a>
<a
href="https://arstechnica.com/information-technology/2021/03/how-to-achieve-smart-home-nirvana-or-home-automation-without-subscription/"
target="_blank"
rel="noopener"
><img
alt="ArsTechnica.com logo"
src="/images/press/arstechnica.svg"
/></a>
<a
href="https://tweakers.net/reviews/8704/paulus-schoutsen-home-assistant-concurreert-met-alles-wat-via-de-cloud-gaat.html"
target="_blank"
rel="noopener"
><img alt="Tweakers.net logo" src="/images/press/tweakers.png"
/></a>
<a
href="https://www.youtube.com/watch?v=x7pSkVarixU"
target="_blank"
rel="noopener"
><img
alt="Linus Tech Tips logo"
class="square"
src="/images/press/ltt.svg"
/></a>
<a
href="https://www.troyhunt.com/iot-unravelled-part-1-its-a-mess-but-then-theres-home-assistant/"
target="_blank"
rel="noopener"
><img
class="square round"
alt="Troy Hunt logo"
src="/images/press/troyhunt.jpg"
/></a>
<a
href="https://www.tomshardware.com/news/raspberry-pi-home-assistant-amber"
target="_blank"
rel="noopener"
><img
alt="Tom's Hardware logo"
src="/images/press/tomshardware.svg"
/></a>
<a
href="https://www.producthunt.com/posts/home-assistant"
target="_blank"
rel="noopener"
><img
alt="ProductHunt.com logo"
src="/images/press/producthunt.com.png"
/></a>
<a
href="https://www.linux.com/news/home-assistant-python-approach-home-automation-video"
target="_blank"
rel="noopener"
><img alt="Linux.com logo" src="/images/press/linux.com.png"
/></a>
<a
href="https://opensource.com/article/17/7/home-automation-primer"
target="_blank"
rel="noopener"
><img
alt="OpenSource.com logo"
src="/images/press/opensource.com.svg"
/></a>
<a
href="http://www.linux-magazine.com/Issues/2017/203/Home-Assistant"
target="_blank"
rel="noopener"
><img
alt="Linux Magazine logo"
src="/images/press/LinuxMagazine.png"
/></a>
<a
href="https://www.heise.de/select/ct/2017/26/1513910625909214"
target="_blank"
rel="noopener"
><img alt="Ct logo" src="/images/press/ct.png"
/></a>
</div>
</div>
</div>
</div>
</div>

10
source/voice_control/s3_box_voice_assistant.markdown
View File

@ -30,8 +30,8 @@ This tutorial will guide you to turn an ESP32-S3-BOX, ESP32-S3-BOX-3, or an ESP3
- The password to your 2.4&nbsp;GHz Wi-Fi network
- Chrome or Edge browser on a desktop (not Android/iOS)
- One of the three Espressif ESP32-S3-BOX variants:
- [ESP32-S3-BOX-3](https://www.aliexpress.us/item/1005005920207976.html?gatewayAdapt=4itemAdapt)
- ESP32-S3-BOX or ESP32-S3-BOX-Lite (not currently on the market)
- ESP32-S3-BOX-3B
- ESP32-S3-BOX-3, ESP32-S3-BOX, or ESP32-S3-BOX-Lite (not currently on the market)
- USB-C cable to connect the ESP32-S3-BOX
## Installing the software onto the ESP32-S3-BOX
@ -77,12 +77,12 @@ Before you can use this device with Home Assistant, you need to install a bit of
- Your ESP32-S3-BOX is connected to Home Assistant over Wi-Fi. You can now move it to any place in your home with a USB power supply.
- title: Using the ESP32-S3-BOX-3
- title: Using the ESP32-S3-BOX-3(B)
content: |
1. Make sure this page is opened in a Chromium-based browser on a **desktop**. The software installation does not work with a tablet or phone.
1. These steps apply both to the ESP32-S3-BOX-3 and the ESP32-S3-BOX-3B. Make sure this page is opened in a Chromium-based browser on a **desktop**. The software installation does not work with a tablet or phone.
- Select the **Connect** button below to display a list of available USB devices. Do not connect the ESP32-S3-BOX-3 yet. We want to see the list of available USB devices first, so that it is easier to recognize the ESP device afterwards.
- Select the **Connect** button below to display a list of available USB devices. Do not connect the ESP32-S3-BOX-3 yet. We want to see the list of available USB devices first, so that it is easier to recognize the ESP device afterward.
- If your browser does not support web serial, you will see a warning message indicating this instead of a button.
<script type="module" src="https://unpkg.com/esp-web-tools@10/dist/web/install-button.js?module"></script>