383 lines
20 KiB
HTML
383 lines
20 KiB
HTML
<!doctype html>
|
|
<!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
|
|
<!--[if IE 7]> <html class="no-js lt-ie9 lt-ie8"> <![endif]-->
|
|
<!--[if IE 8]> <html class="no-js lt-ie9"> <![endif]-->
|
|
<!--[if gt IE 8]><!--> <html> <!--<![endif]-->
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
|
|
<title>Customizing devices and services - Home Assistant</title>
|
|
<meta name="author" content="Home Assistant">
|
|
<meta name="description" content="Simple customization for devices and services in the frontend.">
|
|
<meta name="viewport" content="width=device-width">
|
|
<link rel="canonical" href="https://home-assistant.io/docs/configuration/customizing-devices/">
|
|
<meta property="fb:app_id" content="338291289691179">
|
|
<meta property="og:title" content="Customizing devices and services">
|
|
<meta property="og:site_name" content="Home Assistant">
|
|
<meta property="og:url" content="https://home-assistant.io/docs/configuration/customizing-devices/">
|
|
<meta property="og:type" content="article">
|
|
<meta property="og:description" content="Simple customization for devices and services in the frontend.">
|
|
<meta property="og:image" content="https://home-assistant.io/images/default-social.png">
|
|
<meta name="twitter:card" content="summary_large_image">
|
|
<meta name="twitter:site" content="@home_assistant">
|
|
<meta name="twitter:title" content="Customizing devices and services">
|
|
<meta name="twitter:description" content="Simple customization for devices and services in the frontend.">
|
|
<meta name="twitter:image" content="https://home-assistant.io/images/default-social.png">
|
|
<link href="/stylesheets/screen.css" media="screen, projection" rel="stylesheet">
|
|
<link href="/atom.xml" rel="alternate" title="Home Assistant" type="application/atom+xml">
|
|
<link rel='shortcut icon' href='/images/favicon.ico' />
|
|
<link rel='icon' type='image/png' href='/images/favicon-192x192.png' sizes='192x192' />
|
|
</head>
|
|
<body >
|
|
<header>
|
|
<div class="grid-wrapper">
|
|
<div class="grid">
|
|
<div class="grid__item three-tenths lap-two-sixths palm-one-whole ha-title">
|
|
<a href="/" class="site-title">
|
|
<img width='40' src='/demo/favicon-192x192.png'>
|
|
<span>Home Assistant</span>
|
|
</a>
|
|
</div>
|
|
<div class="grid__item seven-tenths lap-four-sixths palm-one-whole">
|
|
<nav>
|
|
<input type="checkbox" id="toggle">
|
|
<label for="toggle" class="toggle" data-open="Main Menu" data-close="Close Menu"></label>
|
|
<ul class="menu pull-right">
|
|
<li><a href="/getting-started/">Getting started</a></li>
|
|
<li><a href="/components/">Components</a></li>
|
|
<li><a href="/docs/">Docs</a></li>
|
|
<li><a href="/cookbook/">Examples</a></li>
|
|
<li><a href="/developers/">Developers</a></li>
|
|
<li><a href="/blog/">Blog</a></li>
|
|
<li><a href="/help/">Need help?</a></li>
|
|
</ul>
|
|
</nav>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</header>
|
|
<div class="grid-wrapper">
|
|
<div class="grid grid-center">
|
|
<div class="grid__item two-thirds lap-one-whole palm-one-whole">
|
|
<article class="page">
|
|
<div class='edit-github'><a href='https://github.com/home-assistant/home-assistant.github.io/tree/current/source/_docs/configuration/customizing-devices.markdown'>Edit this page on GitHub</a></div>
|
|
<header>
|
|
<h1 class="title indent">
|
|
Customizing Devices and Services
|
|
</h1>
|
|
</header>
|
|
<hr class="divider">
|
|
<p>By default, all of your devices will be visible and have a default icon determined by their domain. You can customize the look and feel of your front page by altering some of these parameters. This can be done by overriding attributes of specific entities.</p>
|
|
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="s">homeassistant</span><span class="pi">:</span>
|
|
<span class="s">name</span><span class="pi">:</span> <span class="s">Home</span>
|
|
<span class="s">unit_system</span><span class="pi">:</span> <span class="s">metric</span>
|
|
<span class="c1"># etc</span>
|
|
|
|
<span class="s">customize</span><span class="pi">:</span>
|
|
<span class="c1"># Add an entry for each entity that you want to overwrite.</span>
|
|
<span class="s">sensor.living_room_motion</span><span class="pi">:</span>
|
|
<span class="s">hidden</span><span class="pi">:</span> <span class="s">true</span>
|
|
<span class="s">thermostat.family_room</span><span class="pi">:</span>
|
|
<span class="s">entity_picture</span><span class="pi">:</span> <span class="s">https://example.com/images/nest.jpg</span>
|
|
<span class="s">friendly_name</span><span class="pi">:</span> <span class="s">Nest</span>
|
|
<span class="s">switch.wemo_switch_1</span><span class="pi">:</span>
|
|
<span class="s">friendly_name</span><span class="pi">:</span> <span class="s">Toaster</span>
|
|
<span class="s">entity_picture</span><span class="pi">:</span> <span class="s">/local/toaster.jpg</span>
|
|
<span class="s">switch.wemo_switch_2</span><span class="pi">:</span>
|
|
<span class="s">friendly_name</span><span class="pi">:</span> <span class="s">Kitchen kettle</span>
|
|
<span class="s">icon</span><span class="pi">:</span> <span class="s">mdi:kettle</span>
|
|
<span class="s">switch.rfxtrx_switch</span><span class="pi">:</span>
|
|
<span class="s">assumed_state</span><span class="pi">:</span> <span class="s">false</span>
|
|
<span class="s">customize_domain</span><span class="pi">:</span>
|
|
<span class="s">light</span><span class="pi">:</span>
|
|
<span class="s">icon</span><span class="pi">:</span> <span class="s">mdi:home</span>
|
|
<span class="s">customize_glob</span><span class="pi">:</span>
|
|
<span class="s2">"</span><span class="s">light.kitchen_*"</span><span class="pi">:</span>
|
|
<span class="s">icon</span><span class="pi">:</span> <span class="s">mdi:description</span>
|
|
|
|
</code></pre>
|
|
</div>
|
|
<h3><a class="title-link" name="possible-values" href="#possible-values"></a> Possible values</h3>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Attribute</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code class="highlighter-rouge">friendly_name</code></td>
|
|
<td>Name of the entity</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code class="highlighter-rouge">hidden</code></td>
|
|
<td>Set to <code class="highlighter-rouge">true</code> to hide the entity.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code class="highlighter-rouge">entity_picture</code></td>
|
|
<td>Url to use as picture for entity</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code class="highlighter-rouge">icon</code></td>
|
|
<td>Any icon from <a href="http://MaterialDesignIcons.com">MaterialDesignIcons.com</a>. Prefix name with <code class="highlighter-rouge">mdi:</code>, ie <code class="highlighter-rouge">mdi:home</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code class="highlighter-rouge">assumed_state</code></td>
|
|
<td>For switches with an assumed state two buttons are shown (turn off, turn on) instead of a switch. By setting <code class="highlighter-rouge">assumed_state</code> to <code class="highlighter-rouge">false</code> you will get the default switch icon.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code class="highlighter-rouge">device_class</code></td>
|
|
<td>Sets the class of the device, changing the device state and icon that is displayed on the UI (see below).</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h3><a class="title-link" name="device-class" href="#device-class"></a> Device Class</h3>
|
|
<p>Device class is currently supported by the following platforms:</p>
|
|
<ul>
|
|
<li><a href="/components/binary_sensor/">Binary Sensor</a></li>
|
|
<li><a href="/components/cover/">Cover</a></li>
|
|
</ul>
|
|
<h3><a class="title-link" name="reloading-customize" href="#reloading-customize"></a> Reloading customize</h3>
|
|
<p>Home Assistant offers a service to reload the core configuration while Home Assistant is running called <code class="highlighter-rouge">homeassistant/reload_core_config</code>. This allows you to change your customize section and see it being applied without having to restart Home Assistant. To call this service, go to the <img src="/images/screenshots/developer-tool-services-icon.png" alt="service developer tool icon" class="no-shadow" height="38" /> service developer tools, select the service <code class="highlighter-rouge">homeassistant/reload_core_config</code> and click “Call Service”.</p>
|
|
<p class="note warning">
|
|
New customize information will be applied the next time the state of the entity gets updated.
|
|
</p>
|
|
</article>
|
|
</div>
|
|
<aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">
|
|
<div class="grid">
|
|
<section class="aside-module grid__item one-whole lap-one-half">
|
|
<div class='section'>
|
|
<h1 class="title delta">Topics</h1>
|
|
<ul class='divided sidebar-menu'>
|
|
<li>
|
|
<a href='/docs/installation/'>Installation </a>
|
|
<ul>
|
|
<li><a href='/docs/installation/virtualenv/'>Python Virtual Env </a></li>
|
|
<li><a href='/docs/installation/raspberry-pi-all-in-one/'>Raspberrry Pi All-in-One </a></li>
|
|
<li><a href='/docs/installation/updating/'>Updating </a></li>
|
|
<li><a href='/docs/installation/troubleshooting/'>Troubleshooting </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/hassbian/'>Hassbian </a>
|
|
<ul>
|
|
<li><a href='/docs/hassbian/installation/'>Installation </a></li>
|
|
<li><a href='/docs/hassbian/customization/'>Customization </a></li>
|
|
<li><a href='/docs/hassbian/common-tasks/'>Common tasks </a></li>
|
|
<li><a href='/docs/hassbian/integrations/'>Integrations </a></li>
|
|
<li><a href='/docs/hassbian/upgrading/'>Upgrading </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/configuration/'>Configuration </a>
|
|
<ul>
|
|
<li><a href='/docs/configuration/yaml/'>YAML </a></li>
|
|
<li><a href='/docs/configuration/basic/'>Basic information </a></li>
|
|
<li><a href='/docs/configuration/devices/'>Setting up devices </a></li>
|
|
<li><a class='active' href='/docs/configuration/customizing-devices/'>Customizing devices and services </a></li>
|
|
<li><a href='/docs/configuration/troubleshooting/'>Troubleshooting </a></li>
|
|
<li><a href='/docs/configuration/securing/'>Security Check Points </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
Advanced Configuration
|
|
<ul>
|
|
<li><a href='/docs/configuration/remote/'>Remote access </a></li>
|
|
<li><a href='/docs/configuration/packages/'>Packages </a></li>
|
|
<li><a href='/docs/configuration/splitting_configuration/'>Splitting up the configuration </a></li>
|
|
<li><a href='/docs/configuration/secrets/'>Storing Secrets </a></li>
|
|
<li><a href='/docs/configuration/templating/'>Templating </a></li>
|
|
<li><a href='/docs/configuration/group_visibility/'>Group Visibility </a></li>
|
|
<li><a href='/docs/configuration/events/'>Events </a></li>
|
|
<li><a href='/docs/configuration/state_object/'>State Objects </a></li>
|
|
<li><a href='/docs/configuration/platform_options/'>Entity component platform options </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/automation/'>Automation </a>
|
|
<ul>
|
|
<li><a href='/docs/automation/examples/'>Examples </a></li>
|
|
<li><a href='/docs/automation/trigger/'>Triggers </a></li>
|
|
<li><a href='/docs/automation/condition/'>Conditions </a></li>
|
|
<li><a href='/docs/automation/action/'>Actions </a></li>
|
|
<li><a href='/docs/automation/templating/'>Templates </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/frontend/'>Frontend </a>
|
|
<ul>
|
|
<li><a href='/docs/frontend/mobile/'>Android/iOS Homescreen </a></li>
|
|
<li><a href='/docs/frontend/webserver/'>Web server fingerprint </a></li>
|
|
<li><a href='/docs/frontend/browsers/'>Browser Compatibility List </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/backend/'>Backend </a>
|
|
<ul>
|
|
<li><a href='/docs/backend/database/'>Database </a></li>
|
|
<li><a href='/docs/backend/updater/'>Updater </a></li>
|
|
<li><a href='/developers/api/'>API </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/scripts/'>Scripts </a>
|
|
<ul>
|
|
<li><a href='/docs/scripts/service-calls/'>Service Calls </a></li>
|
|
<li><a href='/docs/scripts/conditions/'>Conditions </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/tools/'>Tools and Helpers </a>
|
|
<ul>
|
|
<li><a href='/docs/tools/dev-tools/'>Developer Tools </a></li>
|
|
<li><a href='/docs/tools/hass/'>hass </a></li>
|
|
<li><a href='/docs/tools/scripts/'>Scripts </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/z-wave/'>Z-Wave </a>
|
|
<ul>
|
|
<li><a href='/docs/z-wave/controllers/'>Controllers </a></li>
|
|
<li><a href='/docs/z-wave/settings/'>Modifying Settings </a></li>
|
|
<li><a href='/docs/z-wave/device-specific/'>Device Specific </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/mqtt/'>MQTT </a>
|
|
<ul>
|
|
<li><a href='/docs/mqtt/broker/'>Broker </a></li>
|
|
<li><a href='/docs/mqtt/certificate/'>Certificate </a></li>
|
|
<li><a href='/docs/mqtt/discovery/'>Discovery </a></li>
|
|
<li><a href='/docs/mqtt/service/'>Publish service </a></li>
|
|
<li><a href='/docs/mqtt/birth_will/'>Birth and last will messages </a></li>
|
|
<li><a href='/docs/mqtt/testing/'>Testing your setup </a></li>
|
|
<li><a href='/docs/mqtt/logging/'>Logging </a></li>
|
|
<li><a href='/docs/mqtt/processing_json/'>Processing JSON </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/ecosystem/'>Ecosystem </a>
|
|
<ul>
|
|
<li>
|
|
<a href='/docs/autostart/'>Autostart </a>
|
|
<ul>
|
|
<li><a href='/docs/autostart/systemd/'>systemd (Linux) </a></li>
|
|
<li><a href='/docs/autostart/upstart/'>Upstart (Linux) </a></li>
|
|
<li><a href='/docs/autostart/init.d/'>init.d (Linux) </a></li>
|
|
<li><a href='/docs/autostart/macos/'>macOS </a></li>
|
|
<li><a href='/docs/autostart/synology/'>Synology NAS </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/ecosystem/appdaemon/'>AppDaemon </a>
|
|
<ul>
|
|
<li><a href='/docs/ecosystem/appdaemon/installation/'>Installation </a></li>
|
|
<li><a href='/docs/ecosystem/appdaemon/configuration/'>Configuration </a></li>
|
|
<li><a href='/docs/ecosystem/appdaemon/example_apps/'>Example Apps </a></li>
|
|
<li><a href='/docs/ecosystem/appdaemon/running/'>Running AppDaemon </a></li>
|
|
<li><a href='/docs/ecosystem/appdaemon/reboot/'>Starting AppDaemon at Reboot </a></li>
|
|
<li><a href='/docs/ecosystem/appdaemon/operation/'>Operation </a></li>
|
|
<li><a href='/docs/ecosystem/appdaemon/windows/'>AppDaemon on Windows </a></li>
|
|
<li><a href='/docs/ecosystem/appdaemon/updating/'>Updating AppDaemon </a></li>
|
|
<li><a href='/docs/ecosystem/appdaemon/tutorial/'>AppDaemon Tutorial </a></li>
|
|
<li><a href='/docs/ecosystem/appdaemon/api/'>AppDaemon API Reference </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/ecosystem/hadashboard/'>HADashboard </a>
|
|
<ul>
|
|
<li><a href='/docs/ecosystem/hadashboard/installation/'>Installation </a></li>
|
|
<li><a href='/docs/ecosystem/hadashboard/dash_config/'>Dashboard Configuration </a></li>
|
|
<li><a href='/docs/ecosystem/hadashboard/hapush/'>HAPush </a></li>
|
|
<li><a href='/docs/ecosystem/hadashboard/reboot/'>Reboot </a></li>
|
|
<li><a href='/docs/ecosystem/hadashboard/updating/'>Updating HADashboard </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/ecosystem/notebooks/'>Notebooks </a>
|
|
<ul>
|
|
<li><a href='/docs/ecosystem/notebooks/'>Introduction </a></li>
|
|
<li><a href='/docs/ecosystem/notebooks/installation/'>Installation </a></li>
|
|
<li><a href='/docs/ecosystem/notebooks/graph/'>Graph </a></li>
|
|
<li><a href='/docs/ecosystem/notebooks/api/'>Home Assistant API </a></li>
|
|
<li><a href='/docs/ecosystem/notebooks/database/'>Databsase </a></li>
|
|
<li><a href='/docs/ecosystem/notebooks/stats/'>Statistics </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/docs/ecosystem/ios/notifications/'>iOS </a>
|
|
<ul>
|
|
<li><a href='/docs/ecosystem/ios/notifications/basic/'>Basic notifications </a></li>
|
|
<ul>
|
|
<li><a href='/docs/ecosystem/ios/notifications/sounds/'>Sounds </a></li>
|
|
<li><a href='/docs/ecosystem/ios/notifications/architecture/'>Architecture </a></li>
|
|
<li><a href='/docs/ecosystem/ios/notifications/privacy_security_rate_limits/'>Privacy, rate limiting and security </a></li>
|
|
</ul>
|
|
<li>Advanced notifications</li>
|
|
<ul>
|
|
<li><a href='/docs/ecosystem/ios/notifications/attachments/'>Attachments </a></li>
|
|
<li><a href='/docs/ecosystem/ios/notifications/content_extensions/'>Dynamic content </a></li>
|
|
<li><a href='/docs/ecosystem/ios/notifications/actions/'>Actionable notifications </a></li>
|
|
<li><a href='/docs/ecosystem/ios/notifications/requesting_location_updates/'>Requesting location updates </a></li>
|
|
</ul>
|
|
<li><a href='/docs/ecosystem/ios/location/'>Location Tracking </a></li>
|
|
<li><a href='/docs/ecosystem/ios/integration/'>Integration with other apps </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
Remote access
|
|
<ul>
|
|
<li><a href='/docs/ecosystem/apache/'>Apache </a></li>
|
|
<li><a href='/docs/ecosystem/nginx/'>NGINX </a></li>
|
|
<li><a href='/docs/ecosystem/tor/'>Tor Onion Service </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
Certificates
|
|
<ul>
|
|
<li><a href='/docs/ecosystem/certificates/tls_self_signed_certificate/'>Self-signed certificate </a></li>
|
|
<li><a href='/docs/ecosystem/certificates/tls_domain_certificate/'>Certificate domain owners </a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href='/docs/ecosystem/scenegen/'>scenegen </a></li>
|
|
<li><a href='/docs/ecosystem/synology/'>Synology </a></li>
|
|
<li><a href='/docs/ecosystem/backup/backup_github/'>Backup to GitHub </a></li>
|
|
<li><a href='/docs/ecosystem/hass-configurator/'>HASS Configurator </a></li>
|
|
</ul>
|
|
</ul>
|
|
</div>
|
|
</section>
|
|
</div>
|
|
</aside>
|
|
</div>
|
|
</div>
|
|
<footer>
|
|
<div class="grid-wrapper">
|
|
<div class="grid">
|
|
<div class="grid__item">
|
|
<div class="copyright">
|
|
<a rel="me" href='https://twitter.com/home_assistant'><i class="icon-twitter"></i></a>
|
|
<a rel="me" href='https://facebook.com/homeassistantio'><i class="icon-facebook"></i></a>
|
|
<a rel="me" href='https://plus.google.com/110560654828510104551'><i class="icon-google-plus"></i></a>
|
|
<a rel="me" href='https://github.com/home-assistant/home-assistant'><i class="icon-github"></i></a>
|
|
<div class="credit">
|
|
Contact us at <a href='mailto:hello@home-assistant.io'>hello@home-assistant.io</a>.<br>
|
|
Website powered by <a href='http://jekyllrb.com/'>Jekyll</a> and the <a href='https://github.com/coogie/oscailte'>Oscalite theme</a>.<br />
|
|
Hosted by <a href='https://pages.github.com/'>GitHub</a> and served by <a href='https://cloudflare.com'>CloudFlare</a>.
|
|
</div>
|
|
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /></a><br /><span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">home-assistant.io</span> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License</a>.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</footer>
|
|
<script>
|
|
var _gaq=[['_setAccount','UA-57927901-1'],['_trackPageview']];
|
|
(function(d,t){var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
|
|
g.src=('https:'==location.protocol?'//ssl':'//www')+'.google-analytics.com/ga.js';
|
|
s.parentNode.insertBefore(g,s)}(document,'script'));
|
|
</script>
|
|
</body>
|
|
</html>
|