# v4.3 - Welcome to Framework ESP-IDF, an Utilities Dashboard and Enhanced Localization ## General This milestone release is not just about adopting a new technical foundation; it's about enhancing the capabilities and experiences of our users through significant performance improvements, more comprehensive API documentation, customizable user interfaces and improved localization. And with a nice Utilities Dashboard as a bonus!! Our dedication to refining the user experience and expanding customization options continues, with this release featuring: - **Utilities Dashboard**: A new addition, offering a customizable overview for essential utility metrics such as solar production, wind energy, EV charging status, battery levels, and water or gas consumption. - **Comprehensive API Documentation**: Simplifying customization and integration for developers and users, enabling tailored experiences with detailed service documentation. - **Localization and Personalization**: Advances in user-defined settings, like decimal separators and value translations, contribute to a more intuitive interface. We’ve also streamlined the display to exclude empty pages, making navigation more efficient. - **Performance and Functionality**: The shift to the ESP-IDF framework not only boosts performance but also paves the way for future enhancements, keeping NSPanel at the forefront of smart control technology. As we embrace the ESP-IDF framework, we're excited to explore the new horizons it brings to the NSPanel firmware. Dive into v4.3 and discover the advancements that await. ## ESP-IDF Framework Transition With this release, we've officially transitioned to the **ESP-IDF** framework. This move is part of our ongoing efforts to enhance the memory capacity and expand the features available on the ESP, facilitating broader customization and new functionalities. For users updating to this version: - **Flashing Required**: To adopt the ESP-IDF framework, flashing your device using a serial cable is necessary. This step mirrors the initial custom firmware setup process. - **Arduino Framework Still Available**: For those who prefer the `arduino` framework or require Over-The-Air (OTA) updates, it remains an option. Detailed guidance on how to choose your framework is provided in our [customization documentation](https://github.com/Blackymas/NSPanel_HA_Blueprint/blob/main/docs/customization.md#frameworks). This transition is a significant milestone for us, promising a robust platform for our community. We're here to help with any questions or assistance needed during this change. For more details and support, visit our [community discussion](https://github.com/Blackymas/NSPanel_HA_Blueprint/discussions/1756). ## Updating Please review your settings post-update to ensure compatibility. Refer to the update procedures [here](https://github.com/Blackymas/NSPanel_HA_Blueprint/blob/main/docs/howto.md#update-blueprint). ## Breaking Changes and Guidance With this release, we're implementing several important changes. While we strive to improve the panel, we understand that changes can affect your setups. Here's a detailed overview and guidance for a smooth transition: 1. **Home Assistant v2024.3.0 is required**. You can see the full version compatibility list [here](docs/version_compatibility.md). 2. **Transition to ESP-IDF Framework**: This release marks the official switch to the ESP-IDF framework, enhancing performance and allowing for more complex features. - **What to Do**: You'll need to flash your device with the new firmware using a serial connection. Detailed instructions are available in our [installation guide](docs/install.md#flashing-the-device-for-the-first-time). - **Support for Arduino Framework**: If you're not ready to make the switch or prefer the Arduino framework, it's still supported for OTA updates. See our [framework customization documentation](https://github.com/Blackymas/NSPanel_HA_Blueprint/blob/main/docs/customization.md#frameworks) for details on how to select your preferred framework. 3. **Several Services Changed**: In our pursuit to enhance integration capabilities and future-proof our services, we've undertaken a comprehensive restructuring of our API. This change is aimed at improving functionality and compatibility but may require adjustments to your current automations. - **What to Do**: We strongly encourage you to review our updated [API documentation](docs/api.md). This resource has been meticulously updated to assist you in updating your automation scripts accordingly. Pay special attention to the examples section, which offers valuable insights and practical guidance for adapting your existing setups seamlessly. 4. **15s Hardware Button Press No Longer Restarts the Device**: This feature was removed to repurpose the hardware button for more versatile uses. - **What to Do**: If you relied on this feature, see our [customization guide](https://github.com/Blackymas/NSPanel_HA_Blueprint/blob/main/docs/customization.md#restart-with-15s-button-press) for alternatives. Additionally, the reset pin remains an option for manual resets. 5. **Relay Fallback Switches Removed**: These switches were deprecated and have now been removed to streamline the firmware and reduce memory usage. - **What to Do**: For users who utilized customizations to expose these switches, refer to our updated customization guide. Alternatively, use the `esphome.xxxxx_init_hardware` service for a similar functionality without the memory overhead. 6. **Home Page Redesign**: We've redesigned the Home page layout to incorporate an additional value (sensor) and a utilities button, resulting in a minor repositioning of some components. This change enhances the page's functionality, offering you a broader overview of your smart home at a glance. While adjusting to the new layout, you might find some of your usual indicators or controls have shifted places, but they're all still readily accessible, designed with intuitive interaction in mind. We appreciate your understanding and patience during this transition. Our goal is to ensure NSPanel continues to evolve in a way that enhances your experience and meets future needs. Our community and support channels are open for any questions or assistance you may require. ## Overview of noteworthy changes - [Transition to ESP-IDF as Default Framework](#transition-to-esp-idf-as-default-framework) - [New API documentation](#new-api-documentation) - [Selectable font size for screensaver time display](#selectable-font-size-for-screensaver-time-display) - [Enhanced Visibility of Hardware Button Bars Across Pages](#enhanced-visibility-of-hardware-button-bars-across-pages) - [User-Defined Decimal Separator](#user-defined-decimal-separator) - [Page Light with Power Button](#page-light-with-power-button) - [Page Fan with Oscillate Button](#page-fan-with-oscillate-button) - [Streamlined Interface: No More Empty Pages](#streamlined-interface-no-more-empty-pages) - [Enhanced Localization: Translated Values](#enhanced-localization-translated-values) - [Expanded Entity Selection for Home and Climate Pages](#expanded-entity-selection-for-home-and-climate-pages) - [Introducing the Utilities Dashboard](#introducing-the-utilities-dashboard) - [Expanded Support for "Lock" Entities on Buttons and Chips](#expanded-support-for-lock-entities-on-buttons-and-chips) - [Additional Value on Home Page](#additional-value-on-home-page) - [Automatic Font Size Adjustment for Entity Page Values](#automatic-font-size-adjustment-for-entity-page-values) ## Details of noteworthy changes ### Transition to ESP-IDF as Default Framework We've transitioned to ESP-IDF, enhancing our platform's performance and capabilities. This change promises new possibilities for your projects. Those continuing with the Arduino framework can find instructions for setting framework preferences. For more information, visit our [discussion](https://github.com/Blackymas/NSPanel_HA_Blueprint/discussions/1756). ### New API documentation Now all the services available are listed in a comprehensive documentation, making easier for people who want to customize their systems, integrate to other automations and to encourage new collaborators to our repository. For more details, please visit our [API documentation](docs/api.md). ### Selectable font size for screensaver time display Now you can chose the font size for your clock display in the screen saver. There are 3 sizes available: ![Image](docs/pics/ha_blueprint_sreensaver.png) #### 72px ![image](https://github.com/Blackymas/NSPanel_HA_Blueprint/assets/94725493/030ba092-69d4-467d-b5ab-52979c94e742) ![image](https://github.com/Blackymas/NSPanel_HA_Blueprint/assets/94725493/ae56276f-10be-420c-a156-87f33d1fc322) ![image](https://github.com/Blackymas/NSPanel_HA_Blueprint/assets/94725493/0aecb76b-c7b1-4257-b2eb-caed513a1f06) ### 112px ![image](https://github.com/Blackymas/NSPanel_HA_Blueprint/assets/94725493/689f7fa3-afe5-43e0-839c-a16ca32d0657) ![image](https://github.com/Blackymas/NSPanel_HA_Blueprint/assets/94725493/5093d1e7-be6b-4042-8e2d-84bf10d0bd2f) ### 192px ![image](https://github.com/Blackymas/NSPanel_HA_Blueprint/assets/94725493/3060bea9-4804-45d3-940e-64767e1f3577) > [!IMPORTANT] > For this time to be displayed you must select a brightness higher than 0 on the device's page (under **Settings** > **Devices & Services** > **ESPHome**). > [!WARNING] > Some fonts may not support all the languages. > [!WARNING] > Bigger fonts may not fit well on your display and the selected time format. > Please select a different font in that case. ### Enhanced Visibility of Hardware Button Bars Across Pages The hardware button bars, which display the status of entities linked to physical buttons, are now configurable to appear across all pages, including the screensaver, providing a constant visual reference to your system's status. This update introduces a new setting within the blueprint, allowing you to customize the visibility of these bars according to your preferences. Whether you need continuous monitoring on certain pages or want to maintain a cleaner look on others, this flexibility enhances your control. Additionally, we've introduced the option to personalize the color of these bars, offering further customization to match your panel's aesthetic or to signify different statuses at a glance. ![Hardware Button Bars Color Customization](docs/pics/ha_blueprint_hw_buttons_colors.png) This feature enhances the NSPanel's functionality by ensuring important status indicators are always within view, tailored precisely to how you use your smart home. ### User-Defined Decimal Separator You can now select the decimal separator for displaying numbers on your NSPanel. This feature allows for consistency with your regional number format preferences, improving the clarity of numerical information. Simply go to the settings to choose between the dot (.) and comma (,) as your decimal separator for a display that matches your preference. ![User-Defined Decimal Separator Setting](docs/pics/ha_blueprint_decimal_separator.png) This update aims to enhance the flexibility and usability of the NSPanel interface for users worldwide. ### Page Light with Power Button The page Light has been updated to include a power button, simplifying the process of toggling your light on or off. This intuitive addition allows for quick adjustments directly from the page Light, enhancing the user experience by providing a straightforward control mechanism. ![Page Light Power Button](docs/pics/eu_light.png) This enhancement streamlines light management, making it more accessible and convenient for everyday use. ### Page Fan with Oscillate Button The Fan page now features an oscillate button, making it easier to control your fan's oscillation settings. This convenient update enables users to activate or deactivate the oscillation function with a single tap, directly from the Fan page itself. It's designed to improve the user experience by offering a simple and effective control option. ![Page Fan Oscillate Button](docs/pics/us_fan.png) This update simplifies fan operation, enhancing accessibility and usability for all users. ### Streamlined Interface: No More Empty Pages We've improved the NSPanel interface by ensuring that only populated pages are displayed, both for button and entities pages. This update creates a more intuitive and clutter-free experience, automatically hiding any pages without assigned entities. There's no need for additional setup; if a page has no entities linked to it, it simply won't appear on your panel, making navigation smoother and more efficient. ### Enhanced Localization: Translated Values In a significant step towards a more localized user experience, the values displayed on the NSPanel are now translated using Home Assistant's `state_translated` function, introduced in HA v2024.3.0. This means that not only are the project's strings translated, but also values provided by Home Assistant, such as those from text sensors or binary sensors. This enhancement simplifies readability and usability for users interacting with the panel in different languages. > [!NOTE] > The translations are managed by Home Assistant and will correspond to the language settings > specified under [**Settings** > **System** > **General**](https://my.home-assistant.io/redirect/general/). ### Expanded Entity Selection for Home and Climate Pages With the latest update, we've significantly broadened the range of entities that can be incorporated into the Home and Climate pages, aligning these sections with the extensive capabilities of the Entities pages. This enhancement enables a more versatile and detailed representation of your smart home's metrics directly on your NSPanel, from environmental sensors to energy monitors, offering a tailored view of your home's status at a glance. When combined with the [Translated Values](#enhanced-localization-translated-values), this expanded entity selection not only allows for a more personalized dashboard but also ensures that the information displayed is accessible and understandable, regardless of your preferred language. Together, these features elevate the NSPanel's functionality, providing you with a richer, more contextually relevant interface that adapts to your specific monitoring needs and preferences. ### Introducing the Utilities Dashboard The "Utilities Dashboard" is a versatile feature tailored to offer a straightforward overview of your chosen utility metrics. It's designed for flexibility, allowing you to customize up to six data points, such as solar production, wind energy, EV charging status, battery levels, water, and gas consumption, according to what's relevant to your home. This customization ensures that the dashboard only displays the utilities you're monitoring, maintaining a clean and uncluttered interface. ![US model - Utilities Dashboard](docs/pics/us_page_utilities.png) ![EU model - Utilities Dashboard](docs/pics/eu_page_utilities.png) ![Blueprint - Utilities](docs/pics/ha_blueprint_utilities.png) ### Expanded Support for "Lock" Entities on Buttons and Chips We're enhancing the NSPanel's integration capabilities by extending support for "lock" entities to both buttons and chips. This development significantly broadens your ability to interact with and control lock mechanisms directly from the NSPanel. Whether securing your home or managing access to different areas, these updates streamline the control process, integrating seamlessly with your smart home's security setup. ### Additional Value on Home Page In our continuous effort to enhance the NSPanel's utility and efficiency, we're pleased to announce that the Home page now accommodates a fourth value, complete with its icon. This addition allows for a more comprehensive at-a-glance view of your essential metrics directly from the home screen, ensuring that crucial information is always just a glance away. ### Automatic Font Size Adjustment for Entity Page Values We've enhanced the entities pages with an automatic font size adjustment feature to improve the display of values, especially for longer strings or values with lengthy units. This smart adjustment reduces the occurrence of truncated values by dynamically resizing the font based on the string length. While the selection of fonts for the panel remains limited, this automatic resizing significantly enhances readability, ensuring that all displayed information is clear and fully visible at a glance. ## v4.3.1 - Ensuring Compatibility with ESPHome v2024.3.0 and Enhancing Stability Patch v4.3.1 focuses primarily on ensuring full compatibility with the latest ESPHome v2024.3.0 IP address format changes, crucial for the smooth compilation and operation of the NSPanel project. This timely update addresses critical compatibility issues, alongside implementing key bug fixes and optimizations. It underscores our ongoing commitment to enhancing stability and ensuring a reliable experience for all NSPanel users, keeping pace with the evolving ESPHome ecosystem. ### Support for ESPHome v2024.3.0 IP Address Format - **Criticality:** Critical (required for compiling with ESPHome 2024.3.0) - **Affected Components:** ESPHome - **Description:** This update introduces necessary adjustments to accommodate the new IP address format introduced by ESPHome v2024.3.0, ensuring uninterrupted project compilation and enhancing compatibility. This critical update is the cornerstone of patch v4.3.1, deployed simultaneously with ESPHome to ensure NSPanel users experience no disruption in service. This adaptation ensures that NSPanel firmware remains fully functional and up-to-date with ESPHome's latest advancements, reaffirming our commitment to providing a seamless and stable user experience. ### Button Bars Visibility Enhancement and Configuration Change - **Criticality:** Breaking Change (with Enhancement) - **Affected Components:** Blueprint - **Description:** The visibility of button bars, indicating the status of entities linked to hardware buttons, has been updated to be visible across all pages by default, including the screensaver. This enhancement improves the accessibility of crucial status information. Users who previously customized the visibility settings for button bars will need to review and adjust their configurations to align with the new default behavior. This change enables users to selectively exclude button bars from specific pages if desired, providing greater flexibility and control over the interface's appearance. ### Service `hw_button_state` Update - **Criticality:** Breaking Change (with Enhancement) - **Affected Components:** Blueprint and ESPHome - **Description:** The method for controlling the state of hardware buttons has been refined with the introduction of a `button_mask` parameter. This update simplifies the process of simultaneously updating the visual state of multiple hardware buttons, enhancing user interaction by providing a more intuitive interface for managing button states. Users can now specify the buttons they wish to control using a single `button_mask` parameter, offering a streamlined approach for activating or deactivating the on-screen indication bars of the hardware buttons. This change fosters a more flexible and efficient user experience in configuring the visual feedback for button states. ### Celsius Display Issue for Embedded Temperature Sensor Resolved (#1834) - **Criticality:** Medium - **Affected Components:** ESPHome - **Description:** Addressed an issue where the NSPanel's built-in temperature sensor incorrectly displayed temperature readings in Celsius, even when Fahrenheit was expected. This fix ensures temperature readings are accurately represented according to the user's settings, improving usability and consistency across the system. ### Resolution for Panel Naming When `device_name` Is Not Provided (#1907) - **Criticality:** Medium - **Affected Components:** ESPHome - **Description:** Corrected a bug that caused the new "Device Name" sensor to report "nspanel" and therefore fail on defining services names when a `device_name` substitution was not specified by the user. ### External Temperature Sensor Selection Now Correctly Overrides Embedded Sensor Value (#1911) - **Criticality:** Medium - **Affected Components:** Blueprint and ESPHome - **Description:** Fixed a display issue where the built-in sensor's temperature reading persisted despite configuration for an external sensor. ### Utilities Dashboard Now Correctly Omits Default Labels When Customized (#1899) - **Criticality:** Minor - **Affected Components:** Blueprint - **Description:** Enhanced the utilities dashboard by ensuring custom labels properly replace or remove default ones for a personalized display. ### Clarification and Improvements to `rtttl_play` Service Documentation (#1901 and #1912) - **Criticality:** Minor - **Affected Components:** Documentation - **Description:** Updated documentation for clearer guidance on using the `rtttl_play` service for custom sounds and alerts. ### Correction of Missing Icon Display Issue on Entities Page 3 (#1902) - **Criticality:** Minor - **Affected Components:** TFT - **Description:** Addressed a bug preventing certain icons from displaying on the third Entities page, ensuring a consistent user interface. ### Icons No Longer Appear "Disabled" for Sensor Values of 0.0 (#1902) - **Criticality:** Minor - **Affected Components:** Blueprint - **Description:** Resolved an incorrect icon color display issue where they appeared disabled at a sensor value of exactly 0.0. ### Vertical Alignment Improvements on Entities Pages for Enhanced Readability (#1903) - **Criticality:** Minor - **Affected Components:** TFT - **Description:** Adjusted the vertical alignment of text and icons on Entities pages for a more visually appealing presentation. ### Enhanced Guidance on Handling Duplicated Entities on the Device's Page (#1905) - **Criticality:** Minor - **Affected Components:** Documentation - **Description:** Updated documentation to better address and resolve issues related to entity duplication on the device's page on Home Assistant. ### Compilation Guidance Updated for Customizations with the Latest Version (#1914) - **Criticality:** Minor - **Affected Components:** Documentation - **Description:** Resolved documentation issues leading to compilation errors during customization, facilitating smoother custom feature implementation. ### Elimination of Transient Icon Flashes on the Home Page During Page Transitions (#1915) - **Criticality:** Minor - **Affected Components:** Blueprint, ESPHome and TFT - **Description:** Fixed a visual glitch where icons briefly flashed during transitions, streamlining the visual experience. ### Real-Time Brightness Adjustment Now Effective Even During Sleep Mode (#1919) - **Criticality:** Minor - **Affected Components:** ESPHome - **Description:** Ensured brightness settings changes are immediately applied, even when the panel is in sleep mode. ### Smooth Cursor Movement on Utilities Page Near Zero Sensor Readings (#1926) - **Criticality:** Minor - **Affected Components:** Blueprint - **Description:** Ensured cursor movement on the Utilities page is smooth and accurate, even with sensor readings defining the cursor direction is between 0 and 1. ### Notification Screen Clearing Now Functional with `notification_clear` Service Call (#1931) - **Criticality:** Minor - **Affected Components:** ESPHome - **Description:** Enabled clear display of notifications from the screen upon invoking the `notification_clear` service, enhancing display control. ### Page Indicator Removed for Single-Page Views (#1883) - **Criticality:** Enhancement - **Affected Components:** TFT - **Description:** Improved UI by removing unnecessary page indicators when only one page is present, simplifying navigation. ### Entities Page Font Adjustment for CJK Fonts Improved (#1884) - **Criticality:** Enhancement - **Affected Components:** ESPHome - **Description:** Optimized font sizing and display on Entities pages for CJK fonts, addressing readability issues. ### User Option Added to Disable Entities Page Icons for a Text-Focused View (#1885) - **Criticality:** Enhancement - **Affected Components:** Blueprint - **Description:** Introduced an option to disable icons on Entities pages, allowing for a simplified, text-only display. ### Utilities Page Line Cursor Size Customization Option Added (#1910) - **Criticality:** Enhancement - **Affected Components:** Blueprint - **Description:** Provided customization options for cursor size on the Utilities dashboard, enhancing data visualization. ### Temperature Measurement Sampling Enhancement (#1918) - **Criticality:** Enhancement - **Affected Components:** ESPHome - **Description:** Enhanced the temperature reporting mechanism of the NSPanel's built-in temperature sensor by implementing a sampling method. Now, the sensor collects 12 intermediate measurements and calculates their average before reporting the temperature. This enhancement, which does not alter the 1-minute measurement interval, aims to provide smoother and more stable temperature readings, improving accuracy and reliability for users monitoring their environment. ### Boot Page Visual Feedback Enhancements for Clearer System Status Display (#1923) - **Criticality:** Enhancement - **Affected Components:** ESPHome and TFT - **Description:** Updated the Boot page to offer clearer visual feedback on version information and system status, with a new progress bar. ## v4.3.2 - Patch To add some text here ### Utilities Dashboard Performance Bug Resolved (#1964) - **Criticality:** Medium - **Affected Components:** Blueprint and ESPHome - **Issue Number:** #1964 - **Description:** Fixed a significant performance bug in the "Utilities Dashboard" related to sensors with high update frequencies. Previously, sensors updating frequently could overload the Home Assistant host, causing the blueprint execution to delay. As updates persisted, this led to multiple instances of the blueprint being triggered, eventually hitting the limit of 50 concurrent instances. This update minimizes the issue, ensuring smooth operation and reducing the chances of a overload state, thereby maintaining efficient and reliable dashboard performance. ### Device Reboot Issue on Wake Up Resolved (#1976) - **Criticality:** Medium - **Affected Components:** Blueprint - **Issue Number:** #1976 - **Description:** Resolved a critical issue causing the NSPanel to boot to the "boot" page rather than the "home" page under certain conditions, such as upon waking. This correction ensures the panel directly accesses the "home" page, streamlining user interaction by promptly presenting the main interface. Effective implementation of this fix necessitates clearing the build files before updating. The procedure below guides you through cleaning build files in the ESPHome Dashboard, an essential step to actualize this update. #### How to Clean-up Build Files 1. Navigate to your ESPHome Dashboard. 2. Select the 3-dot menu adjacent to your device's listing. 3. Choose "**Clean Build Files**". ![Clean Build Files Instruction](https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/dev/docs/pics/esphome_dashboard_clean_build_files.png) > [!IMPORTANT] > Cleaning build files is a mandatory step for this update to apply successfully. > It ensures your NSPanel operates smoothly with the new improvements post-update. ### Alarm Control with Hardware Button Enhancement (#1995) - **Criticality:** Enhancement - **Affected Components:** Blueprint - **Issue Number:** #1995 - **Description:** Enhanced the functionality of hardware buttons for a more intuitive interaction with alarm control panels. Now, a short click on a hardware button assigned to an entity from the `alarm_control_panel` domain will open its detailed page, aligning with the behavior for `climate` and `media_player` entities. This update facilitates quicker access to alarm controls directly from the NSPanel, streamlining user interactions. Long clicks continue to open the detailed page for these and other domains, maintaining a consistent and user-friendly experience across various controls. ### Documentation Updates for Arduino References (#1997) - **Criticality:** Enhancement - **Affected Components:** Documentation - **Issue Number:** #1997 - **Description:** Comprehensive updates and refinements were made to the project documentation, with a particular focus on correcting and clarifying references related to the Arduino framework. This effort led to a thorough review and subsequent enhancement of various sections of the documentation, improving clarity, accuracy, and usefulness across the board. Special thanks to the author of this PR, @andythomas, whose dedicated work went beyond just addressing Arduino framework references to include minor fixes and overall improvements to the documentation. These contributions have significantly elevated the quality of information available to users, ensuring that the documentation remains a reliable and up-to-date resource for the community. ### Expanded Wake-Up Sensor Support (#1998) - **Criticality:** Enhancement - **Affected Components:** Blueprint - **Issue Number:** #1998 - **Description:** The range of supported device classes for wake-up sensors on the NSPanel has been significantly expanded. Now, in addition to the previously supported door, motion, and occupancy sensors, the NSPanel firmware accommodates a wider variety of sensor types. These enhancements enable the panel to wake up from sleep mode upon detecting various environmental changes, improving responsiveness and user interaction. The newly supported device classes include: - door - garage_door - lock - motion - occupancy - opening - smoke - sound - vibration - window This update broadens the NSPanel's integration capabilities with home automation systems, allowing for a more dynamic and reactive smart home environment. ### Hebrew Translation Text Reversal Fix (#1999) - **Criticality:** Enhancement - **Affected Components:** Blueprint - **Issue Number:** #1999 - **Description:** Addressed a specific issue with the Hebrew translation where text was displayed in reverse order, hindering readability and user experience. This fix ensures that Hebrew text is correctly aligned and presented, enhancing the interface for Hebrew-speaking users. The commitment to support diverse languages and correct such localization issues underscores our dedication to providing a user-friendly experience for all NSPanel users, regardless of their language. ## Support For support or more information about this update, visit our [GitHub repository](https://github.com/Blackymas/NSPanel_HA_Blueprint) or our [online documentation](https://github.com/Blackymas/NSPanel_HA_Blueprint/blob/main/docs/README.md). ## What's Next? Discover our upcoming projects in our [Milestones](https://github.com/Blackymas/NSPanel_HA_Blueprint/milestones?direction=asc&sort=title&state=open). ## Special Thanks We extend our heartfelt thanks to the contributors who have played a pivotal role in enhancing the NSPanel's capabilities and documentation in this release: - **@shing6326**: For diligently addressing and fixing issues related to the new Fan oscillating feature. Your efforts have significantly improved its functionality and reliability (#1839). - **@andythomas**: For the comprehensive enhancements made to our documentation. Your contributions have made our guides more informative and accessible, enriching the user experience for everyone (#1865). ## Previous releases - [v4.3 - Welcome to Framework ESP-IDF, an Utilities Dashboard and Enhanced Localization](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.3.0) - [v4.2.6 - Enhancing Stability and User Experience](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.2.6) - [v4.2.5 - Celebrating 1000 Stars with Enhanced Functionality and UI Improvements](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.2.5) - [v4.2.4 - Critical bug fixes](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.2.4) - [v4.2.3 - Bug fixes and minor enhancements](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.2.3) - [v4.2.2 - Bug fixes and minor enhancements](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.2.2) - [v4.2.1 - Bug fixes](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.2.1) - [v4.2 - Multi-Alarm Control, Dual Thermostat Functionality, and More](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.2) - [v4.1.4 - Support to Home Assistant 2023.12.0](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.1.4) - [v4.1.3 - Bug fixes](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.1.3) - [v4.1.2 - Bug fixes and minor enhancements](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.1.2) - [v4.1.1 - UI Enhancements and Reintroduction of `play_rtttl` Service](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.1.1) - [v4.1 - Easier TFT transfer](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.1) - [v4.0.2 - Bug fixes](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.0.2) - [v4.0.1 - Bug fixes](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.0.1) - [v4.0 - Alarm and Media player pages, Climate add-ons and a more robust panel](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v4.0) - [v3.4.1 - Patch for issues when compiling with ESPHome 2023.7.0](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v3.4.1) - [v3.4 - New climate page and some bug fixes](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v3.4) - [v3.3 - New improvements and some issues fixed](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v.3.3) - [v3.2.2 - fixed some bugs performance improvement](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v3.2.2) - [v3.2.1 - New features and some fixes](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v3.2.1) - [v3.2 - New features and custom configurations](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v.3.2) - [v3.1.0 - New features and US Version](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v.3.1.0) - [v3.0.0 - major update with many features and improvements](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v.3.0.0) - [v2.2.0 - 25 new languages added](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v.2.2.0) - [v2.1.0 - New Domains, Buttons and Button Page Label](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v2.1.0) - [v2.0.2](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v2.0.2) - [v2.0.1 - Bug Fixes](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v2.0.1) - [v2.0.0](https://github.com/Blackymas/NSPanel_HA_Blueprint/releases/tag/v2.0.0)