diff --git a/_static/custom.css b/_static/custom.css index 052882239..ce08207c8 100644 --- a/_static/custom.css +++ b/_static/custom.css @@ -1,8 +1,10 @@ .row-odd { background-color: #f3f6f6; } + .table-center tr.row-even > td { text-align: center; + vertical-align: top; } div.document { @@ -26,6 +28,7 @@ img.component-image { height: 85px; object-fit: contain; border-radius: 10px; + max-width: 190px; } table.docutils { @@ -36,6 +39,7 @@ table.docutils { -webkit-animation: 2s linear infinite blink_effect; animation: 2s linear infinite blink_effect; } + @-webkit-keyframes blink_effect { 0% { visibility: hidden; @@ -47,6 +51,7 @@ table.docutils { visibility: visible; } } + @keyframes blink_effect { 0% { visibility: hidden; @@ -74,10 +79,12 @@ table.docutils { z-index: 9999; display: none; } + .footer-button-container { margin: 0 60px 0 10px; float: right; } + .footer-button { background-color: #b3b3b3; color: #4e4e4e; @@ -88,6 +95,7 @@ table.docutils { cursor: pointer; text-decoration: none; } + .not-hidden { display: block !important; } @@ -133,7 +141,6 @@ div.index-shields { } .guide-card { - color: #004b6b; display: block; height: auto; width: 300px; @@ -149,17 +156,20 @@ div.index-shields { margin: 16px !important; } -.guide-code { - padding: 8px 16px; - margin: 8px; - color: black; - white-space: pre-line; +.guide-card .example { + margin: 10px; } -@media screen and (min-width: 870px) { +.guide-card pre { + white-space: pre-line; + padding: 15px; +} + +@media screen and (min-width: 875px) { .guide-card:first-child { z-index: 100; } + .guide-card:nth-child(2) { z-index: 50; } @@ -170,23 +180,159 @@ div.index-shields { } } -@media screen and (max-width: 870px) { +@media screen and (max-width: 875px) { + + div.sphinxsidebar { + width: 100%; + background: #fff; + color: #000; + border-bottom: 1px solid #444; + } + + div.sphinxsidebar p.logo { + display: initial; + } + + div.sphinxsidebar a, div.sphinxsidebar h3, div.sphinxsidebar h3 a { + color: #444; + } + .guide-container { flex-direction: column; } + .guide-card { width: 100%; margin: 8px 0; padding: 0px; } + .guide-card:not(:first-child) { margin-left: 0; } + .guide-card ul { margin-left: 32px; } + + img.component-image { + max-width: 80px; + } } .breadcrumbs li { display: inline; } + +a { + color: #004B6B; + text-decoration: none; + border-bottom: 1px dotted #004B6B; +} + +a:hover { + color: #999999; + text-decoration: none; + border-bottom: 1px dotted #999999; +} + +a:hover code { + background: none; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + hyphens: none; +} + +/* dark theme */ +@media (prefers-color-scheme: dark) { + + @media screen and (max-width: 875px) { + div.documentwrapper { + background-color: #212121; + } + + div.sphinxsidebar { + background: #212121; + color: #ececec; + } + + } + + body, div.body { + color: #ececec; + background-color: #212121; + } + + img.dark-invert, img.logo { + filter: invert(1); + } + + .row-odd { + background-color: #282828; + } + + table.docutils { + -webkit-box-shadow: 2px 2px 4px #3b3838; + box-shadow: 2px 2px 4px #3b3838; + } + + div.body { + color: #ececec; + background-color: #212121; + } + + a, a.reference, a:visited { + color: #00bfff; + border-bottom: 1px dotted #00bfff; + } + + a:hover { + color: #87ceeb; + border-bottom: 1px solid #87ceeb; + } + + .toctree-wrapper a code { + color: #00bfff; + } + + div.sphinxsidebar h3, div.sphinxsidebar h3 a { + color: #ececec; + } + + div.sphinxsidebar ul { + color: #ececec; + } + + div.sphinxsidebar a, .breadcrumbs a { + color: #ececec; + border-bottom: 1px dotted #ececec; + } + + div.sphinxsidebar a:hover, .breadcrumbs a:hover { + border-bottom: 1px solid #ececec; + } + + .guide-card { + background-color: #393939; + } + + pre { + background-color: #0d1117; + } + + code { + background-color: #424242; + color: #e2e2e2; + } + + div.note { + background-color: #2d2c2c; + border: 1px solid #808080; + } + + div.warning { + background-color: #5d1616; + } + +} \ No newline at end of file diff --git a/_themes/esphome/theme.conf b/_themes/esphome/theme.conf new file mode 100644 index 000000000..2c74b6397 --- /dev/null +++ b/_themes/esphome/theme.conf @@ -0,0 +1,4 @@ +[theme] +inherit = alabaster +pygments_style = xcode +pygments_dark_style = github-dark diff --git a/changelog/2021.10.0.rst b/changelog/2021.10.0.rst index 0b9ca54c9..28b1b2e0b 100644 --- a/changelog/2021.10.0.rst +++ b/changelog/2021.10.0.rst @@ -11,12 +11,12 @@ ESPHome 2021.10.0 - 20th October 2021 :columns: 3 AirThings Wave Mini, components/sensor/airthings_ble, airthings_logo.png - Current-Based Cover, components/cover/current_based, flash.svg + Current-Based Cover, components/cover/current_based, flash.svg, dark-invert Daly BMS, components/sensor/daly_bms, daly_bms.jpg EPEVER Tracer, cookbook/tracer-an, tracer-an.jpg LTR390, components/sensor/ltr390, ltr390.jpg Modbus Controller, components/modbus_controller, modbus.png - Safe Mode Switch, components/switch/safe_mode, restart-alert.svg + Safe Mode Switch, components/switch/safe_mode, restart-alert.svg, dark-invert SCD4X, components/sensor/scd4x, scd4x.jpg Tuya Cover, components/cover/tuya, tuya.png diff --git a/changelog/2021.11.0.rst b/changelog/2021.11.0.rst index acb6ccdb9..de6b1c262 100644 --- a/changelog/2021.11.0.rst +++ b/changelog/2021.11.0.rst @@ -12,8 +12,8 @@ ESPHome 2021.11.0 - 17th November 2021 CSE7761, components/sensor/cse7761, cse7761.svg CAP1188 Capacitive Touch Sensor, components/binary_sensor/cap1188, cap1188.jpg - ESP32 Camera Web Server, components/esp32_camera_web_server, camera.svg - Improv via Serial, components/improv_serial, improv.svg + ESP32 Camera Web Server, components/esp32_camera_web_server, camera.svg, dark-invert + Improv via Serial, components/improv_serial, improv.svg, dark-invert State of the Open Smart Home diff --git a/changelog/2021.12.0.rst b/changelog/2021.12.0.rst index 80b87e8be..5a3d61275 100644 --- a/changelog/2021.12.0.rst +++ b/changelog/2021.12.0.rst @@ -10,10 +10,10 @@ ESPHome 2021.12.0 - 11th December 2021 .. imgtable:: :columns: 3 - Button Core, components/button/index, folder-open.svg - Template Button, components/button/template, description.svg - Restart Button, components/button/restart, restart.svg - BLE Binary Output, components/output/ble_client, bluetooth.svg + Button Core, components/button/index, folder-open.svg, dark-invert + Template Button, components/button/template, description.svg, dark-invert + Restart Button, components/button/restart, restart.svg, dark-invert + BLE Binary Output, components/output/ble_client, bluetooth.svg, dark-invert Tuya Text Sensor, components/text_sensor/tuya, tuya.png SDP800 Series, components/sensor/sdp3x, sdp31.jpg, Pressure diff --git a/changelog/2021.8.0.rst b/changelog/2021.8.0.rst index ae3577549..9483cc315 100644 --- a/changelog/2021.8.0.rst +++ b/changelog/2021.8.0.rst @@ -12,8 +12,8 @@ ESPHome 2021.8.0 - 18th August 2021 AM43, components/sensor/am43, am43.jpg AM43 Cover, components/cover/am43, am43.jpg - Color Temperature Light, components/light/color_temperature, brightness-medium.svg - Demo, components/demo, description.svg + Color Temperature Light, components/light/color_temperature, brightness-medium.svg, dark-invert + Demo, components/demo, description.svg, dark-invert DSMR, components/sensor/dsmr, dsmr.svg HRXL MaxSonar WR, components/sensor/hrxl_maxsonar_wr, hrxl_maxsonar_wr.jpg PipSolar - compatible PV Inverter, components/pipsolar, pipsolar.jpg @@ -24,8 +24,8 @@ ESPHome 2021.8.0 - 18th August 2021 Selec Meter, components/sensor/selec_meter, selec_meter_em2m.jpg T6613/15, components/sensor/t6615, t6615.jpg TLC5947, components/output/tlc5947, tlc5947.jpg - Select Core, components/select/index, folder-open.svg - Template Select, components/select/template, description.svg + Select Core, components/select/index, folder-open.svg, dark-invert + Template Select, components/select/template, description.svg, dark-invert TSL2591, components/sensor/tsl2591, tsl2591.jpg diff --git a/changelog/2021.9.0.rst b/changelog/2021.9.0.rst index 24ec3656c..14af834dc 100644 --- a/changelog/2021.9.0.rst +++ b/changelog/2021.9.0.rst @@ -11,7 +11,7 @@ ESPHome 2021.9.0 - 15th September 2021 :columns: 3 AirThings BLE, components/sensor/airthings_ble, airthings_logo.png - H-bridge Fan, components/fan/hbridge, fan.svg + H-bridge Fan, components/fan/hbridge, fan.svg, dark-invert ST7920, components/display/st7920, st7920.jpg diff --git a/changelog/2022.1.0.rst b/changelog/2022.1.0.rst index ee74aa0a4..9d4295130 100644 --- a/changelog/2022.1.0.rst +++ b/changelog/2022.1.0.rst @@ -17,12 +17,12 @@ ESPHome 2022.1.0 - 19th January 2022 Growatt Solar, components/sensor/growatt_solar, growatt.jpg INA260, components/sensor/ina260, ina260.jpg Inkplate 10, components/display/inkplate6, inkplate6.jpg - Kalman Combinator, components/sensor/kalman_combinator, function.svg + Kalman Combinator, components/sensor/kalman_combinator, function.svg, dark-invert MCP3204, components/sensor/mcp3204, mcp3204.jpg MCP47A1, components/output/mcp47a1, mcp47a1.svg - Midea IR Climate, components/climate/ir_climate, air-conditioner-ir.svg - Safe Mode Button, components/button/safe_mode, restart-alert.svg - Shutdown Button, components/button/shutdown, power_settings.svg + Midea IR Climate, components/climate/ir_climate, air-conditioner-ir.svg, dark-invert + Safe Mode Button, components/button/safe_mode, restart-alert.svg, dark-invert + Shutdown Button, components/button/shutdown, power_settings.svg, dark-invert Tuya Number, components/number/tuya, tuya.png diff --git a/changelog/2022.10.0.rst b/changelog/2022.10.0.rst index f1332badf..2471c0928 100644 --- a/changelog/2022.10.0.rst +++ b/changelog/2022.10.0.rst @@ -10,8 +10,8 @@ ESPHome 2022.10.0 - 19th October 2022 .. imgtable:: :columns: 2 - BLE Client RSSI Sensor, components/sensor/ble_client, bluetooth.svg - ZHLT01 IR Climate, components/climate/climate_ir, air-conditioner-ir.svg + BLE Client RSSI Sensor, components/sensor/ble_client, bluetooth.svg, dark-invert + ZHLT01 IR Climate, components/climate/climate_ir, air-conditioner-ir.svg, dark-invert diff --git a/changelog/2022.11.0.rst b/changelog/2022.11.0.rst index ca168fb39..bb4331745 100644 --- a/changelog/2022.11.0.rst +++ b/changelog/2022.11.0.rst @@ -11,12 +11,12 @@ ESPHome 2022.11.0 - 16th November 2022 :columns: 4 RP2040, components/rp2040, rp2040.svg - WL-134 Pet Tag Sensor , components/text_sensor/wl_134, fingerprint.svg - Ethernet Info, components/text_sensor/ethernet_info, ethernet.svg + WL-134 Pet Tag Sensor , components/text_sensor/wl_134, fingerprint.svg, dark-invert + Ethernet Info, components/text_sensor/ethernet_info, ethernet.svg, dark-invert Atlas Scientific Peristaltic Pump, components/ezo_pmp, ezo-pmp.jpg ADC128S102, components/sensor/adc128s102, adc128s102.png - Daikin BRC, components/climate/climate_ir, air-conditioner-ir.svg - Display Menu Core, components/display_menu/index, folder-open.svg + Daikin BRC, components/climate/climate_ir, air-conditioner-ir.svg, dark-invert + Display Menu Core, components/display_menu/index, folder-open.svg, dark-invert LCD Menu, components/display_menu/lcd_menu, lcd_menu.png diff --git a/changelog/2022.12.0.rst b/changelog/2022.12.0.rst index ebe6fb940..7ed99d06c 100644 --- a/changelog/2022.12.0.rst +++ b/changelog/2022.12.0.rst @@ -11,7 +11,7 @@ ESPHome 2022.12.0 - 14th December 2022 :columns: 3 ESP32, components/esp32, esp32.svg - Bluetooth Proxy, components/bluetooth_proxy, bluetooth.svg + Bluetooth Proxy, components/bluetooth_proxy, bluetooth.svg, dark-invert SN74HC165 I/O Expander, components/sn74hc165, sn74hc595.jpg The festive holidays are coming early and bring you an ESPHome release 1 week earlier than normal. diff --git a/changelog/2022.2.0.rst b/changelog/2022.2.0.rst index 5a0667e27..5b11e1425 100644 --- a/changelog/2022.2.0.rst +++ b/changelog/2022.2.0.rst @@ -10,18 +10,18 @@ ESPHome 2022.2.0 - 16th February 2022 .. imgtable:: :columns: 4 - Lock Core, components/lock/index, folder-open.svg - Generic Output Lock, components/lock/output, upload.svg - Template Lock, components/lock/template, description.svg + Lock Core, components/lock/index, folder-open.svg, dark-invert + Generic Output Lock, components/lock/output, upload.svg, dark-invert + Template Lock, components/lock/template, description.svg, dark-invert QR Code, components/display/index, qr-code.svg - Touchscreen Core, components/touchscreen/index, folder-open.svg + Touchscreen Core, components/touchscreen/index, folder-open.svg, dark-invert EKTF2232, components/touchscreen/ektf2232, ektf2232.svg Lilygo T5 4.7", components/touchscreen/lilygo_t5_47, lilygo_t5_47_touch.jpg MLX90393, components/sensor/mlx90393, mlx90393.jpg - Wake-on-LAN Button, components/button/wake_on_lan, power_settings.svg - Generic Output Button, components/button/output, upload.svg + Wake-on-LAN Button, components/button/wake_on_lan, power_settings.svg, dark-invert + Generic Output Button, components/button/output, upload.svg, dark-invert Xiaomi MHOC303, components/sensor/xiaomi_ble, xiaomi_mijia_logo.jpg RadonEye BLE, components/sensor/radon_eye_ble, radon_eye_logo.png diff --git a/changelog/2022.3.0.rst b/changelog/2022.3.0.rst index bd4c001ab..e877da1fd 100644 --- a/changelog/2022.3.0.rst +++ b/changelog/2022.3.0.rst @@ -10,9 +10,9 @@ ESPHome 2022.3.0 - 16th March 2022 .. imgtable:: :columns: 4 - Analog Threshold, components/binary_sensor/analog_threshold, analog_threshold.svg + Analog Threshold, components/binary_sensor/analog_threshold, analog_threshold.svg, dark-invert MAX44009, components/sensor/max44009, max44009.svg - Copy, components/copy, content-copy.svg + Copy, components/copy, content-copy.svg, dark-invert MPU6886, components/sensor/mpu6886, mpu6886.jpg MCP4728, components/output/mcp4728, mcp4728.jpg Honeywell ABP, components/sensor/honeywellabp, honeywellabp.jpg diff --git a/changelog/2022.5.0.rst b/changelog/2022.5.0.rst index 418bf656d..61a20f625 100644 --- a/changelog/2022.5.0.rst +++ b/changelog/2022.5.0.rst @@ -15,7 +15,7 @@ ESPHome 2022.5.0 - 18th May 2022 ENS210, components/sensor/ens210, ens210.jpg SEN5x, components/sensor/sen5x, sen54.jpg SML, components/sml, sml.svg - Delonghi Penguino PAC W120HP, components/climate/climate_ir, air-conditioner-ir.svg + Delonghi Penguino PAC W120HP, components/climate/climate_ir, air-conditioner-ir.svg, dark-invert Rename ------ diff --git a/changelog/2022.6.0.rst b/changelog/2022.6.0.rst index 0b0e7a00a..d73246814 100644 --- a/changelog/2022.6.0.rst +++ b/changelog/2022.6.0.rst @@ -12,7 +12,7 @@ ESPHome 2022.6.0 - 15th June 2022 Tuya Select, components/select/tuya, tuya.png SGP41, components/sensor/sgp4x, sgp40.jpg - Media Player Core, components/media_player/index, folder-open.svg + Media Player Core, components/media_player/index, folder-open.svg, dark-invert I2S Audio, components/media_player/i2s_audio, i2s_audio.svg diff --git a/changelog/2022.8.0.rst b/changelog/2022.8.0.rst index 0ffbd59bc..336a92210 100644 --- a/changelog/2022.8.0.rst +++ b/changelog/2022.8.0.rst @@ -11,11 +11,11 @@ ESPHome 2022.8.0 - 17th August 2022 :columns: 3 DAC7678, components/output/dac7678, dac7678.svg - Sprinkler, components/sprinkler, sprinkler-variant.svg - Feedback Cover, components/cover/feedback, feedback_cover.svg + Sprinkler, components/sprinkler, sprinkler-variant.svg, dark-invert + Feedback Cover, components/cover/feedback, feedback_cover.svg, dark-invert SMT100, components/sensor/smt100, smt100.jpg, Moisture & Temperature - Whynter IR Climate, components/climate/climate_ir, air-conditioner-ir.svg - Bluetooth Proxy, components/bluetooth_proxy, bluetooth.svg + Whynter IR Climate, components/climate/climate_ir, air-conditioner-ir.svg, dark-invert + Bluetooth Proxy, components/bluetooth_proxy, bluetooth.svg, dark-invert Bluetooth Proxy diff --git a/changelog/2022.9.0.rst b/changelog/2022.9.0.rst index 79edc788f..0bf235670 100644 --- a/changelog/2022.9.0.rst +++ b/changelog/2022.9.0.rst @@ -16,8 +16,8 @@ ESPHome 2022.9.0 - 21st September 2022 MPL3115A2, components/sensor/mpl3115a2, mpl3115a2.jpg uFire EC sensor, components/sensor/ufire_ec, ufire_ec.png uFire ISE sensor, components/sensor/ufire_ise, ufire_ise.png - Factory Reset Switch, components/switch/factory_reset, restart-alert.svg - Factory Reset Button, components/button/factory_reset, restart-alert.svg + Factory Reset Switch, components/switch/factory_reset, restart-alert.svg, dark-invert + Factory Reset Button, components/button/factory_reset, restart-alert.svg, dark-invert TM1638, components/display/tm1638, tm1638.jpg BL0942, components/sensor/bl0942, bl0942.png diff --git a/changelog/2023.2.0.rst b/changelog/2023.2.0.rst index 1d8bbc6be..b2a96e959 100644 --- a/changelog/2023.2.0.rst +++ b/changelog/2023.2.0.rst @@ -15,13 +15,13 @@ ESPHome 2023.2.0 - 15th February 2023 BP5758D, components/output/bp5758d, bp5758d.svg SM2235, components/output/sm2235, sm2235.svg SM2335, components/output/sm2335, sm2335.svg - PCF85063 RTC, components/time/pcf85063, clock-outline.svg + PCF85063 RTC, components/time/pcf85063, clock-outline.svg, dark-invert Matrix Keypad, components/matrix_keypad, matrix_keypad.jpg X9C Potentiometer, components/output/x9c, x9c.jpg EE895, components/sensor/ee895, EE895.png HTE501, components/sensor/hte501, HTE501.png TEE501, components/sensor/tee501, TEE501.png - Sigma-Delta Output, components/output/sigma_delta, sigma-delta.svg + Sigma-Delta Output, components/output/sigma_delta, sigma-delta.svg, dark-invert Wiegand Reader, components/wiegand, wiegand.jpg MiCS-4514, components/sensor/mics_4514, mics_4514.jpg LD2410, components/sensor/ld2410, ld2410.jpg diff --git a/changelog/2023.3.0.rst b/changelog/2023.3.0.rst index 9924054b0..9b08367f6 100644 --- a/changelog/2023.3.0.rst +++ b/changelog/2023.3.0.rst @@ -10,12 +10,12 @@ ESPHome 2023.3.0 - 15th March 2023 .. imgtable:: :columns: 4 - Internal Temperature, components/sensor/internal_temperature, thermometer.svg + Internal Temperature, components/sensor/internal_temperature, thermometer.svg, dark-invert Mopeka Standard Check LP, components/sensor/mopeka_std_check, mopeka_std_check.jpg Person Sensor (SEN21231), components/sensor/sen21231, sen21231.png Haier Climate, components/climate/haier, haier.svg FS3000, components/sensor/fs3000, fs3000.jpg - Absolute Humidity, components/sensor/absolute_humidity, water-drop.svg + Absolute Humidity, components/sensor/absolute_humidity, water-drop.svg, dark-invert AS7341, components/sensor/as7341, as7341.jpg, Spectral Color Sensor diff --git a/changelog/2023.4.0.rst b/changelog/2023.4.0.rst index 375fd8540..9bcdefc88 100644 --- a/changelog/2023.4.0.rst +++ b/changelog/2023.4.0.rst @@ -10,11 +10,11 @@ ESPHome 2023.4.0 - 19th April 2023 .. imgtable:: :columns: 3 - Voice Assistant, components/voice_assistant, voice-assistant.svg - Microphone Core, components/microphone/index, microphone.svg + Voice Assistant, components/voice_assistant, voice-assistant.svg, dark-invert + Microphone Core, components/microphone/index, microphone.svg, dark-invert I2S Microphone, components/microphone/i2s_audio, i2s_audio.svg MMC5603, components/sensor/mmc5603, mmc5603.jpg - KSZ8081 Ethernet, components/ethernet, ethernet.svg + KSZ8081 Ethernet, components/ethernet, ethernet.svg, dark-invert Voice Assistant diff --git a/changelog/2023.5.0.rst b/changelog/2023.5.0.rst index f2e8583de..89acd71fd 100644 --- a/changelog/2023.5.0.rst +++ b/changelog/2023.5.0.rst @@ -10,7 +10,7 @@ ESPHome 2023.5.0 - 17th May 2023 .. imgtable:: :columns: 4 - Speaker Core, components/speaker/index, speaker.svg + Speaker Core, components/speaker/index, speaker.svg, dark-invert I2S Speaker, components/speaker/i2s_audio, i2s_audio.svg MLX90614, components/sensor/mlx90614, mlx90614.jpg MAX6956 I/O expander - I²C Bus, components/max6956, max6956.jpg diff --git a/changelog/2023.6.0.rst b/changelog/2023.6.0.rst index edd7189b4..1e08f18e2 100644 --- a/changelog/2023.6.0.rst +++ b/changelog/2023.6.0.rst @@ -10,9 +10,9 @@ ESPHome 2023.6.0 - 21st June 2023 .. imgtable:: :columns: 2 - Alarm Control Panel Core, components/alarm_control_panel/index, alarm-panel.svg - Template Alarm Control Panel, components/alarm_control_panel/template, description.svg - RP2040 PIO LED Strip, components/light/rp2040_pio_led_strip, color_lens.svg + Alarm Control Panel Core, components/alarm_control_panel/index, alarm-panel.svg, dark-invert + Template Alarm Control Panel, components/alarm_control_panel/template, description.svg, dark-invert + RP2040 PIO LED Strip, components/light/rp2040_pio_led_strip, color_lens.svg, dark-invert TMP1075, components/sensor/tmp1075, tmp1075.jpg Dark Mode 😎 diff --git a/changelog/v1.10.0.rst b/changelog/v1.10.0.rst index f82f675bb..66bdd6690 100644 --- a/changelog/v1.10.0.rst +++ b/changelog/v1.10.0.rst @@ -9,17 +9,17 @@ Changelog - Version 1.10.0 .. imgtable:: - Native API, components/api, server-network.svg - Dashboard+Hass.io Add-On Updates, guides/getting_started_hassio, home-assistant.svg - Better Custom Components, components/sensor/custom, language-cpp.svg + Native API, components/api, server-network.svg, dark-invert + Dashboard+Hass.io Add-On Updates, guides/getting_started_hassio, home-assistant.svg, dark-invert + Better Custom Components, components/sensor/custom, language-cpp.svg, dark-invert APDS9960, components/sensor/apds9960, apds9960.jpg MAX31855, components/sensor/max31855, max31855.jpg ULN2003, components/stepper/index, stepper.svg - NeoPixelBus Light, components/light/neopixelbus, color_lens.svg - ESP32 Ethernet, components/ethernet, ethernet.svg - Home Assistant Sensor, components/sensor/homeassistant, home-assistant.svg + NeoPixelBus Light, components/light/neopixelbus, color_lens.svg, dark-invert + ESP32 Ethernet, components/ethernet, ethernet.svg, dark-invert + Home Assistant Sensor, components/sensor/homeassistant, home-assistant.svg, dark-invert Native API diff --git a/changelog/v1.11.0.rst b/changelog/v1.11.0.rst index c2f55a4fe..f76a75061 100644 --- a/changelog/v1.11.0.rst +++ b/changelog/v1.11.0.rst @@ -9,9 +9,9 @@ Changelog - Version 1.11.0 .. imgtable:: - Completed Rename, index, logo.svg - Home Assistant Binary Sensor, components/binary_sensor/homeassistant, home-assistant.svg - Light Partition, components/light/partition, color_lens.svg + Completed Rename, index, logo.svg, dark-invert + Home Assistant Binary Sensor, components/binary_sensor/homeassistant, home-assistant.svg, dark-invert + Light Partition, components/light/partition, color_lens.svg, dark-invert Release 1.11.0 is here, and it has been a busy few weeks :) diff --git a/changelog/v1.12.0.rst b/changelog/v1.12.0.rst index 4640cf72f..67a2059de 100644 --- a/changelog/v1.12.0.rst +++ b/changelog/v1.12.0.rst @@ -9,15 +9,15 @@ Changelog - Version 1.12.0 .. imgtable:: - User-Defined Services, components/api.html#user-defined-services, home-assistant.svg - ESP32 Camera, components/esp32_camera, camera.svg + User-Defined Services, components/api.html#user-defined-services, home-assistant.svg, dark-invert + ESP32 Camera, components/esp32_camera, camera.svg, dark-invert MPR121, components/binary_sensor/mpr121, mpr121.jpg SDS011, components/sensor/sds011, sds011.jpg MCP23017, components/mcp23017, mcp23017.svg Servo, components/servo, servo.svg - WiFi Info, components/text_sensor/wifi_info, network-wifi.svg + WiFi Info, components/text_sensor/wifi_info, network-wifi.svg, dark-invert It's release day! 🎉 Today I'm happy to release ESPHome 1.12.0. What's new? A lot of awesome stuff got added! Let me walk you through it: diff --git a/changelog/v1.13.0.rst b/changelog/v1.13.0.rst index eb7a72cc9..e44094d35 100644 --- a/changelog/v1.13.0.rst +++ b/changelog/v1.13.0.rst @@ -10,30 +10,30 @@ Changelog - Version 1.13.0 - May 30th 2019 .. imgtable:: :columns: 4 - Climate Devices, components/climate/index, folder-open.svg - Endstop Cover, components/cover/endstop, electric-switch.svg - Time-Based Cover, components/cover/time_based, timer.svg - Bang Bang Controller, components/climate/bang_bang, air-conditioner.svg + Climate Devices, components/climate/index, folder-open.svg, dark-invert + Endstop Cover, components/cover/endstop, electric-switch.svg, dark-invert + Time-Based Cover, components/cover/time_based, timer.svg, dark-invert + Bang Bang Controller, components/climate/bang_bang, air-conditioner.svg, dark-invert AM2320, components/sensor/am2320, am2320.jpg CCS811, components/sensor/ccs811, ccs811.jpg - Integration, components/sensor/integration, sigma.svg - Pulse Width, components/sensor/pulse_width, pulse.svg + Integration, components/sensor/integration, sigma.svg, dark-invert + Pulse Width, components/sensor/pulse_width, pulse.svg, dark-invert - Resistance Sensor, components/sensor/resistance, omega.svg + Resistance Sensor, components/sensor/resistance, omega.svg, dark-invert NTC Thermistor, components/sensor/ntc, ntc.jpg CT Clamp, components/sensor/ct_clamp, ct_clamp.jpg Binary Sensor Map, components/sensor/binary_sensor_map, binary_sensor_map.jpg TTP229, components/binary_sensor/ttp229, ttp229.jpg - Coolix IR Remote, components/climate/coolix, air-conditioner.svg - Tcl112 IR Remote, components/climate/tcl112, air-conditioner.svg - Sun, components/sun, weather-sunny.svg + Coolix IR Remote, components/climate/coolix, air-conditioner.svg, dark-invert + Tcl112 IR Remote, components/climate/tcl112, air-conditioner.svg, dark-invert + Sun, components/sun, weather-sunny.svg, dark-invert - GPS Time Source, components/gps, crosshairs-gps.svg - Custom Light, components/light/custom, language-cpp.svg - Custom Cover, components/cover/custom, language-cpp.svg - Custom Climate, components/climate/custom, language-cpp.svg + GPS Time Source, components/gps, crosshairs-gps.svg, dark-invert + Custom Light, components/light/custom, language-cpp.svg, dark-invert + Custom Cover, components/cover/custom, language-cpp.svg, dark-invert + Custom Climate, components/climate/custom, language-cpp.svg, dark-invert Oh hi there! diff --git a/changelog/v1.14.0.rst b/changelog/v1.14.0.rst index 6fe862a40..8d10732ba 100644 --- a/changelog/v1.14.0.rst +++ b/changelog/v1.14.0.rst @@ -10,10 +10,10 @@ Changelog - Version 1.14.0 - November 1 .. imgtable:: :columns: 5 - Captive Portal, components/captive_portal, wifi-strength-alert-outline.svg - Visual Studio Code Plugin, https://marketplace.visualstudio.com/items?itemName=ESPHome.esphome-vscode, visual-studio-code.svg + Captive Portal, components/captive_portal, wifi-strength-alert-outline.svg, dark-invert + Visual Studio Code Plugin, https://marketplace.visualstudio.com/items?itemName=ESPHome.esphome-vscode, visual-studio-code.svg, dark-invert SIM800L, components/sim800l, sim800l.jpg - DFPlayer, components/dfplayer, dfplayer.svg + DFPlayer, components/dfplayer, dfplayer.svg, dark-invert AS3935, components/sensor/as3935, as3935.jpg ATM90E32, components/sensor/atm90e32, atm90e32.jpg @@ -36,9 +36,9 @@ Changelog - Version 1.14.0 - November 1 TLC59208F, components/output/tlc59208f, tlc59208f.jpg SM16716, components/output/sm16716, sm16716.svg - Tuya Dimmer, components/light/tuya, brightness-medium.svg + Tuya Dimmer, components/light/tuya, brightness-medium.svg, dark-invert SSD1325, components/display/ssd1325, ssd1325.jpg - Yashima IR Remote, components/climate/yashima, air-conditioner.svg + Yashima IR Remote, components/climate/yashima, air-conditioner.svg, dark-invert MCP23008 I/O Expander, components/mcp230xx, mcp230xx.svg SX1509 I/O Expander, components/sx1509, sx1509.jpg diff --git a/changelog/v1.15.0.rst b/changelog/v1.15.0.rst index e314bcc5e..4c95a4665 100644 --- a/changelog/v1.15.0.rst +++ b/changelog/v1.15.0.rst @@ -22,7 +22,7 @@ Changelog - Version 1.15.0 - September 13, 2020 Xiaomi BLE, components/sensor/xiaomi_ble, xiaomi_mijia_logo.jpg Slow PWM, components/output/slow_pwm, pwm.png ESP32 DAC, components/output/esp32_dac, dac.svg - AC Dimmer, components/output/ac_dimmer, ac_dimmer.svg + AC Dimmer, components/output/ac_dimmer, ac_dimmer.svg, dark-invert Tuya Fan, components/fan/tuya, tuya.png Tuya Binary Sensor, components/binary_sensor/tuya, tuya.png Tuya Dimmer, components/light/tuya, tuya.png @@ -35,12 +35,12 @@ Changelog - Version 1.15.0 - September 13, 2020 ST7789V, components/display/st7789v, st7789v.jpg ILI9341, components/display/ili9341, ili9341.jpg PCD8544 (Nokia 5110/ 3310), components/display/pcd8544, pcd8544.jpg - BLE Scanner, components/text_sensor/ble_scanner, bluetooth.svg - Custom UART Text Sensor, components/text_sensor/uart, language-cpp.svg - Thermostat Controller, components/climate/thermostat, air-conditioner.svg - PID Controller, components/climate/pid, function.svg - IR Remote Climate, components/climate/ir_climate, air-conditioner-ir.svg - HTTP Request, components/http_request, connection.svg + BLE Scanner, components/text_sensor/ble_scanner, bluetooth.svg, dark-invert + Custom UART Text Sensor, components/text_sensor/uart, language-cpp.svg, dark-invert + Thermostat Controller, components/climate/thermostat, air-conditioner.svg, dark-invert + PID Controller, components/climate/pid, function.svg, dark-invert + IR Remote Climate, components/climate/ir_climate, air-conditioner-ir.svg, dark-invert + HTTP Request, components/http_request, connection.svg, dark-invert MCP3008 8-Channel 10-Bit A/D Converter, components/mcp3008, mcp3008.jpg SN74HC595 I/O Expander, components/sn74hc595, sn74hc595.jpg TM1651 Battery Display, components/tm1651, tm1651_battery_display.jpg diff --git a/changelog/v1.16.0.rst b/changelog/v1.16.0.rst index 1d3daed69..6af304e11 100644 --- a/changelog/v1.16.0.rst +++ b/changelog/v1.16.0.rst @@ -13,7 +13,7 @@ Changelog - Version 1.16.0 - February 3, 2021 TMP102, components/sensor/tmp102, tmp102.jpg MCP9808, components/sensor/mcp9808, mcp9808.jpg RC522, components/binary_sensor/rc522, rc522.jpg - H-bridge Light, components/light/hbridge, brightness-medium.svg + H-bridge Light, components/light/hbridge, brightness-medium.svg, dark-invert ILI9341, components/display/ili9341, ili9341.jpg Teleinfo, components/sensor/teleinfo, teleinfo.jpg EZO sensor circuits, components/sensor/ezo, ezo-ph-circuit.png diff --git a/changelog/v1.17.0.rst b/changelog/v1.17.0.rst index 6b70bd96e..951ba084b 100644 --- a/changelog/v1.17.0.rst +++ b/changelog/v1.17.0.rst @@ -16,7 +16,7 @@ Changelog - Version 1.17.0 - 4th May 2021 Xiaomi Miscale2, components/sensor/xiaomi_miscale2, xiaomi_miscale2.jpg Midea Air Conditioner, components/climate/midea_ac, midea.svg Addressable Light Display, components/display/addressable_light, addressable_light.jpg - Pulse Meter, components/sensor/pulse_meter, pulse.svg + Pulse Meter, components/sensor/pulse_meter, pulse.svg, dark-invert So, ESPHome was acquired by Nabu Casa. That was big and unexpected, but awesome news for the project as now I have been hired diff --git a/changelog/v1.18.0.rst b/changelog/v1.18.0.rst index 92e0ce92a..baf2cb68f 100644 --- a/changelog/v1.18.0.rst +++ b/changelog/v1.18.0.rst @@ -16,13 +16,13 @@ Changelog - Version 1.18.0 - 19th May 2021 SHT4X, components/sensor/sht4x, sht4x.jpg TCA9548A I²C Multiplexer, components/tca9548a, tca9548a.jpg - Grow Fingerprint Reader, components/fingerprint_grow, fingerprint.svg + Grow Fingerprint Reader, components/fingerprint_grow, fingerprint.svg, dark-invert TOF10120, components/sensor/tof10120, tof10120.jpg SM2135, components/output/sm2135, sm2135.svg - ESP32 BLE Client, components/ble_client, bluetooth.svg - BLE Sensor, components/sensor/ble_sensor, bluetooth.svg - External Components, components/external_components, external_components.svg + ESP32 BLE Client, components/ble_client, bluetooth.svg, dark-invert + BLE Sensor, components/sensor/ble_sensor, bluetooth.svg, dark-invert + External Components, components/external_components, external_components.svg, dark-invert It feels like I was just writing the release notes for 1.17 not long ago, so here's to getting ESPHome going on a regular schedule. diff --git a/changelog/v1.19.0.rst b/changelog/v1.19.0.rst index 99cbec3ab..f7e407a3a 100644 --- a/changelog/v1.19.0.rst +++ b/changelog/v1.19.0.rst @@ -10,7 +10,7 @@ Changelog - Version 1.19.0 - 16th June 2021 .. imgtable:: :columns: 3 - Improv, components/esp32_improv, improv.svg + Improv, components/esp32_improv, improv.svg, dark-invert SM2135, components/output/sm2135, sm2135.svg XPT2046, components/binary_sensor/xpt2046, xpt2046.jpg SDM Meter, components/sensor/sdm_meter, sdm220m.jpg diff --git a/changelog/v1.20.0.rst b/changelog/v1.20.0.rst index d7448c0c8..bf3581c4f 100644 --- a/changelog/v1.20.0.rst +++ b/changelog/v1.20.0.rst @@ -10,8 +10,8 @@ Changelog - Version 1.20.0 - 21st July 2021 .. imgtable:: :columns: 2 - Number Core, components/number/index, folder-open.svg - Template Number, components/number/template, description.svg + Number Core, components/number/index, folder-open.svg, dark-invert + Template Number, components/number/template, description.svg, dark-invert Havells Inverter, components/sensor/havells_solar, havellsgti5000d_s.jpg Anova Cooker, components/climate/anova, anova.png diff --git a/changelog/v1.7.0.rst b/changelog/v1.7.0.rst index ba4587f12..9dcef87e4 100644 --- a/changelog/v1.7.0.rst +++ b/changelog/v1.7.0.rst @@ -19,15 +19,15 @@ be travelling a lot (and enjoying my vacation 😎), so don't expect too many aw .. imgtable:: - ESP32 BLE Beacon, components/esp32_ble_beacon, bluetooth.svg - Status LED, components/status_led, led-on.svg - WiFi Signal Strength, components/sensor/wifi_signal, network-wifi.svg + ESP32 BLE Beacon, components/esp32_ble_beacon, bluetooth.svg, dark-invert + Status LED, components/status_led, led-on.svg, dark-invert + WiFi Signal Strength, components/sensor/wifi_signal, network-wifi.svg, dark-invert - Duty Cycle Sensor, components/sensor/duty_cycle, percent.svg - Pulse Counter for ESP8266, components/sensor/pulse_counter, pulse.svg - Remote Transmitter, components/remote_transmitter, remote.svg + Duty Cycle Sensor, components/sensor/duty_cycle, percent.svg, dark-invert + Pulse Counter for ESP8266, components/sensor/pulse_counter, pulse.svg, dark-invert + Remote Transmitter, components/remote_transmitter, remote.svg, dark-invert - Remote Receiver, components/remote_receiver, remote.svg + Remote Receiver, components/remote_receiver, remote.svg, dark-invert New Components ************** diff --git a/changelog/v1.8.0.rst b/changelog/v1.8.0.rst index 19e396471..4aa1e1a4b 100644 --- a/changelog/v1.8.0.rst +++ b/changelog/v1.8.0.rst @@ -14,17 +14,17 @@ Version 1.8.0 MAX7219, components/display/max7219, max7219.jpg LCD Display, components/display/lcd_display, lcd.jpg - RCSwitch Integration, components/remote_transmitter.html#rcswitch-remote-codes, remote.svg + RCSwitch Integration, components/remote_transmitter.html#rcswitch-remote-codes, remote.svg, dark-invert SPI Bus, components/spi, spi.svg UART Bus, components/uart, uart.svg - Real Time Clock, components/time, clock-outline.svg + Real Time Clock, components/time, clock-outline.svg, dark-invert - Uptime Sensor, components/sensor/uptime, timer.svg + Uptime Sensor, components/sensor/uptime, timer.svg, dark-invert PN532, components/binary_sensor/pn532, pn532.jpg RDM6300, components/binary_sensor/rdm6300, rdm6300.jpg - BLE RSSI, components/sensor/ble_rssi, bluetooth.svg + BLE RSSI, components/sensor/ble_rssi, bluetooth.svg, dark-invert Xiaomi HHCCJCY01, components/sensor/xiaomi_hhccjcy01, xiaomi_hhccjcy01.jpg Xiaomi LYWSDCGQ, components/sensor/xiaomi_lywsdcgq, xiaomi_lywsdcgq.jpg @@ -41,8 +41,8 @@ Version 1.8.0 TCS34725, components/sensor/tcs34725, tcs34725.jpg RGBWW Light, components/light/rgbww, rgbw.png - Cold+Warm White Light, components/light/cwww, brightness-medium.svg - Light Effects, components/light/index#light-effects, creation.svg + Cold+Warm White Light, components/light/cwww, brightness-medium.svg, dark-invert + Light Effects, components/light/index#light-effects, creation.svg, dark-invert Hi everyone, @@ -228,3 +228,8 @@ Changes in 1.8.2 - esphomedocs: WiFi: Add power save mode option `#41 `__ - esphomedocs: Add SSD1306 64x48 Display `#27 `__ - esphomeyaml: WiFi: Add power save mode option `#150 `__ + +Past Changelogs +--------------- + +- :doc:`v1.7.0` diff --git a/changelog/v1.9.0.rst b/changelog/v1.9.0.rst index 8f56cd199..0ba225260 100644 --- a/changelog/v1.9.0.rst +++ b/changelog/v1.9.0.rst @@ -9,8 +9,8 @@ Changelog - Version 1.9.0 .. imgtable:: - Beta Releases, guides/faq.html#how-do-i-update-to-the-latest-beta-release, new-box.svg - Text Sensors, components/text_sensor/index, folder-open.svg + Beta Releases, guides/faq.html#how-do-i-update-to-the-latest-beta-release, new-box.svg, dark-invert + Text Sensors, components/text_sensor/index, folder-open.svg, dark-invert MQTT Subscribe, components/sensor/mqtt_subscribe, mqtt.png Stepper, components/stepper/index, stepper.svg @@ -18,7 +18,7 @@ Changelog - Version 1.9.0 PMSX003, components/sensor/pmsx003, pmsx003.svg esphomeflasher, guides/faq.html#i-can-t-get-flashing-over-usb-to-work, logo.svg - Total Daily Energy, components/sensor/total_daily_energy, sigma.svg + Total Daily Energy, components/sensor/total_daily_energy, sigma.svg, dark-invert MY9231/MY9291 LED driver, components/output/my9231, my9231.svg diff --git a/components/api.rst b/components/api.rst index 56cad2ccd..7df6f8d6c 100644 --- a/components/api.rst +++ b/components/api.rst @@ -16,7 +16,7 @@ the device manually by choosing "ESPHome" from the integration overview and ente ".local" or the IP address of the unit in the "Host" field. The ESPHome native API is based on a custom TCP protocol using protocol buffers. You can find -the protocol data structure definitions here: https://github.com/esphome/esphome/blob/dev/esphome/components/api/api.proto +the protocol data structure definitions here: `api.proto `__ A Python library that implements this protocol is `aioesphomeapi `__. .. code-block:: yaml @@ -35,7 +35,7 @@ Configuration variables: .. raw:: html - +