
Fresh Intellivent Sky/Ice for Home Assistant
A standalone Home Assistant integration for Fresh Intellivent SKY and Intellivent ICE bathroom fans using Bluetooth Low Energy.
This integration combines the Home Assistant integration from freshintelliventHacs with the BLE communication code from pyfreshintellivent. The combined codebase no longer depends on the external Python library and has been extensively expanded with additional controls, diagnostics, firmware handling, connection management, and multi-device settings duplication.
[!NOTE]
This is an unofficial community integration and is not affiliated with or supported by Fresh AB.
Features
- Native Home Assistant Bluetooth discovery
- Support for Fresh Intellivent SKY and Intellivent ICE
- Authentication key setup through the Home Assistant UI
- Read-only installation without an authentication key
- Configurable polling interval
- Optional persistent BLE connection for faster updates
- Automatic reconnect and retry when a persistent connection fails
- Support for different firmware generations
- Batched setting writes with readback
- Boost and Pause controls with local countdown sensors
- Home Assistant-managed Night Mode and Silent Hours
- Scheduled maximum RPM limits with automatic restoration of normal settings
- Copy settings between two supported devices
- Estimated airflow in m³/h based on fan speed and installation configuration
- Per-device diagnostic debug logging
- Danish, Swedish and English translations
Requirements
- Home Assistant 2026.1.0 or newer
- Bluetooth access from Home Assistant or a compatible Bluetooth proxy
- A Fresh Intellivent SKY or Intellivent ICE fan
Available entities
The entities available depend on the firmware version and whether the integration was configured with an authentication key.
Sensors
| Entity |
Description |
| Temperature |
Current temperature reported by the fan |
| Current speed |
Current fan speed in RPM |
| Estimated airflow |
Estimated airflow in m³/h based on the current fan speed and the configured duct size and front type |
| Mode |
Current operating mode, derived from the active trigger rather than the full raw mode byte |
| Active Trigger |
Trigger currently responsible for the fan operation, such as humidity, light or VOC |
| Motor Speed Type |
Motor speed mode decoded from the upper nibble of the raw mode byte |
| Boost remaining time |
Local countdown for an active Boost |
| Pause remaining time |
Local countdown for an active Pause |
| Error |
Error value reported by the fan as text |
Estimated airflow
The Estimated airflow sensor shows the approximate current airflow in m³/h.
The value is calculated from the fan's current RPM using Fresh's airflow/performance data for the selected installation:
- Duct size: Ø100 mm or Ø125 mm
- Front type: Standard or Design
For example, a value of 75 m³/h means that the fan is estimated to move approximately 75 cubic metres of air per hour at its current speed and installation configuration.
The airflow value is an estimate based on the fan's performance data and is not a direct airflow measurement from the fan.
Diagnostic entities
Additional diagnostic entities provide information about the fan, raw sensor data, and its current Bluetooth connection:
| Entity |
Description |
| Bluetooth Source |
Bluetooth adapter or proxy currently used to communicate with the fan |
| RSSI |
Current Bluetooth signal strength in dBm |
| Debug logs |
Enable detailed diagnostic logging for the device |
| Error |
Raw error value reported by the fan |
| Firmware Version |
Firmware version reported by the fan |
| Connection Status |
Current BLE connection state: Disconnected, Connecting or Connected |
| Humidity Sensor Raw |
Raw humidity sensor value |
| Hardware Version |
Hardware version reported by the fan |
| Light Sensor Raw |
Raw light sensor value |
| Minimum Active |
Raw minimum-active value reported by the fan |
| Reference Raw |
Raw reference value reported by the fan |
| Raw State |
Raw operating state value reported by the fan |
| Last Update |
Date and time of the last successful update |
| VOC Sensor Raw |
Raw VOC sensor value |
Settings and controls
| Function |
Available controls |
| Constant speed |
Enable/disable and RPM |
| Humidity control |
Enable/disable, sensitivity and RPM |
| Air quality/VOC control |
Enable/disable, sensitivity and RPM where supported |
| Light control |
Enable/disable, sensitivity, RPM and after-run time |
| Airing |
Enable/disable, duration and RPM |
| External input |
Delay time |
| Boost |
Start, cancel, duration and RPM |
| Pause |
Start, cancel and duration |
| Night Mode |
Enable/disable, start time, end time and maximum RPM |
| Silent Hours |
Enable/disable, start time, end time and maximum RPM |
| Airflow configuration |
Duct size (Ø100/Ø125) and front type (Standard/Design) |
| Integration |
Poll interval, Keep Connection |
| Device settings |
Copy settings between configured devices |
Firmware support
The integration reads the hardware and firmware versions directly from the fan and adjusts the available entities automatically.
- Newer firmware exposes a separate VOC RPM setting.
- Older firmware uses a combined humidity and air-quality RPM setting.
- Settings duplication translates the VOC RPM appropriately when copying between different supported firmware generations.
Authentication modes
During setup, Home Assistant offers three authentication options:
- Fetch key from fan — place the fan in pairing mode and let the integration read the key.
- Enter key manually — enter an existing eight-character authentication key.
- No authentication (read-only) — expose sensor values without settings or action controls.
To place the fan in pairing mode, press and hold the power and Wi-Fi buttons for approximately eight seconds until the fan starts flashing. Then select the option to fetch the key.
Migrating from freshintelliventHacs
[!WARNING]
If you already have freshintelliventHacs installed, remove it before installing this integration.
Both integrations use the same Home Assistant domain and the same folder: custom_components/fresh_intellivent_sky. Installing them at the same time can result in mixed or outdated files.
To migrate safely:
- Remove the old Fresh Intellivent Sky integration from Settings → Devices & services.
- Remove
freshintelliventHacs from HACS.
- Confirm that
custom_components/fresh_intellivent_sky has been removed. If the folder remains, remove it manually.
- Restart Home Assistant.
- Install this integration using the instructions below.
- Restart Home Assistant again.
- Add Fresh Intellivent Sky from Settings → Devices & services.
Installation

Manual install via HACS
- Open HACS in your Home Assistant instance.
- Click the three dots (⋮) in the top-right corner.
- Select Custom repositories.
- Add the repository:
- URL:
https://github.com/Spit68/Fresh-Intellivent-Sky
- Category: Integration
- Click Add.
- Find Fresh Intellivent Sky in HACS and install it.
- Restart Home Assistant.
Adding the integration
Step 1: Go to Settings → Devices & services

Step 2: Click + ADD INTEGRATION

Step 3: Search for "Fresh Intellivent Sky"

Step 4: Complete the configuration
Select the detected fan and choose how the authentication key should be configured.

Polling and Keep Connection
The normal polling interval can be configured from the device settings.
When Keep Connection is disabled, the integration connects to the fan when required and disconnects after polling, writing, and reading settings.
When Keep Connection is enabled, the BLE connection is kept open and live values are refreshed every second. Persistent mode can provide faster updates, but it may use more Bluetooth resources.
Night Mode and Silent Hours
Night Mode and Silent Hours provide scheduled RPM limits managed entirely by Home Assistant. Each mode can be enabled and configured separately for every device with a start time, end time, and maximum RPM.
When a scheduled mode starts, the integration saves the fan's normal RPM settings and temporarily limits settings that are higher than the configured maximum. Settings already below the limit remain unchanged and are never increased.
For example, with a maximum of 1200 RPM:
- A normal setting of
850 RPM remains at 850 RPM.
- A normal setting of
1100 RPM remains at 1100 RPM.
- A normal setting of
1800 RPM is temporarily limited to 1200 RPM.
When the scheduled mode ends, the original RPM settings are restored automatically.
The two schedules may overlap. While both are active, the lowest configured maximum RPM is used. The original settings are restored only after the last active schedule has ended.
Schedules, enabled states, RPM limits, and saved normal RPM values are stored by Home Assistant and survive integration reloads and Home Assistant restarts. Time ranges that pass midnight, such as 22:00–07:00, are supported.
[!IMPORTANT]
Night Mode and Silent Hours are integration features and are not stored in the fan itself. Home Assistant must be running and able to reach the fan through Bluetooth when settings need to be changed. If Home Assistant was unavailable at a scheduled transition, the integration evaluates the current schedule and applies or restores the appropriate settings when it starts again.
Manually changing an RPM setting while a scheduled mode is active overrides that setting. When the final active schedule ends, the RPM values saved before the scheduled period are restored.
Copy settings between devices
When two or more supported devices are configured, the integration provides:
- Copy From Device
- Copy To Device
- Duplicate Settings
Select two different devices and press Duplicate Settings on the destination device. Supported fan settings are written to the destination and read back for verification. Home Assistant-only values such as the polling interval and the configured Boost and Pause values are copied as well.
Diagnostic logging
Each device has a disabled-by-default Debug logs switch in the Diagnostic section.
When enabled, the integration logs detailed information for that device, including:
- Hardware and firmware versions
- BLE address
- RSSI and Bluetooth source when available
- Raw BLE status payload
- Flags, active trigger and motor speed
- Raw humidity, VOC and light values
- Fan speed, reference and minimum-active values
- Temperature and error value
Debug logging can generate a large number of log entries, especially when Keep Connection is enabled. Disable it again after troubleshooting.
Troubleshooting
The fan is not discovered
- Confirm that Bluetooth is available to Home Assistant.
- Move the fan or a Bluetooth proxy closer to Home Assistant.
- Confirm that the fan is powered on and not already connected to another Bluetooth client.
- Reload the integration or restart Home Assistant and try again.
Settings cannot be changed
Settings and action controls require a valid authentication key. An installation configured with No authentication is intentionally read-only.
A value briefly returns to its previous state
Rapidly changing a setting and then enabling its function can result in two separate BLE writes. Home Assistant may briefly display the intermediate state before the second write is completed.
Diagnostic entities are still visible
Disabled-by-default diagnostic entities remain visible in the entity registry so users can enable them when needed. Home Assistant also preserves previous entity enable/disable choices by unique ID.
Credits
This integration combines and builds upon two original open-source projects:
The two projects have been merged into a standalone Home Assistant integration and extensively expanded by @Spit68.
Issues and contributions
Bug reports and contributions are welcome through the repository's issue tracker.
When reporting a BLE or parsing problem, include the Home Assistant version, the fan hardware/software versions, and relevant logs. Enable Debug logs only for the affected device and remove any information you do not want to share before posting.