Download
- You are on the Releases page. Select Assets at the bottom of the page
- Then select icloud3.zip, icloud3_v3.zip or icloud3-beta-#.zip (it all depends on how I uploaded the file)..
- Download the zip file and unzip it into the /config/custom_components/icloud3 directory.
- Restart HA.
First Time Installation
- Go to the HA Devices & Settings > Integration screen/
- Select + Add, type iCloud3. Go to the iCloud3 User Manual and take a quick look at the introduction here in the search field at the top and select iCloud3. Click Continue a few times.
- Click Configure in the iCloud3 Integrations window. The Configuration Wizard Setting screen will open.
- Go to the iCloud3 User Manual and take a quick look at the introduction here.
- Scroll down a little and follow the instructions in the Installation Guide here. You have already done Steps #1 & #3. Step #4 is a good place to continue but be sure to review information about the iOS App (HA Companion App) in Step #2.
iCloud3 v3 Documentation - It is still in process, does not include the latest updates to iCloud3 and can be found here
Change Logs - They can be found here
beta 14b (3/12/2023)
- Update to fix a HACS valication error. No change to iCloud3 v3 beta 14 code
- Fixed an error caused by a missing distance variable (AttributeError: 'iCloud3_DeviceFmZone' object has no attribute 'zone_dist_m'). This was caused when an old location error message was being displayed and the results of the last location were going to be reused
beta 14 (3/9/2023)
- iCloud Account Authentication:
- When the iCloud Account is verified using a password, a session access token is created and stored
as a cookie. The password login also generates an email saying someone has logged into your iCloud
account. This beta changes the method of authenticating the account to using the token first and
then using the password if it has expired. This should eliminate or greatly reduce the login emails
generated by Apple. - Did a lot of code cleanup in the account authentication routines to insure the 2fa-code is requested
when needed, to be able to reauthenticate and log into the current account with a new password and to
be able to log into a different account in the Configuration Wizard.
- When the iCloud Account is verified using a password, a session access token is created and stored
- Configuration Wizard > iCloud Account Credentials screen - Updated it to improve readability and make
it easier to set up the account information. Several rare problems were also fixed where (1) logging
into an iCloud Account with an incorrect password would still allow access when there was a valid token
and (2) logging into an iCloud Account with a changed password would not work if the token has expired.
Now, logging in with a new password causes a new 2fa request to be made. - Zone enter/leave event for an iCloud3 device_tracker entity - This can now be used as an automation
trigger. - Latitude/longitude values - They are now stored as numeric fields in the device_tracker attributes instead
of a string field. They are now displayed with 2-decimal places on a Lovelace device_tracker/attributes
window (an HA limitation). A new gps attribute has been added to display the latitude/longitude with it's
full precision. - Passive Zones - Fixed a problem where passive zones could be selected. Also found out that the iOS App
will generate enter/exit triggers for passive zones. These will now be ignored by iCloud3. - Configuration Wizard > Sensors screen - Changed it for readability and to list the important sensors
first. - Event Log - Made some minor formatting changes. Also added a new icon to the top-right of the Event Log
so you can become an iCloud3 Stargazer. Click it to go to the iCloud3_v2 GitHub repository. Then click
the star in the top-right corner. - Distance Sensors:
(1) Changed the distance precision so the distance value is within 6-inches/1-millimeter of the
measurement between the device and the zone center - (4-decimal places for miles, 5 for meters)
(2) Changed themoved_distance
sensor to display in feet/meters when less than 1mi/1km
(3) Changed the_moved_distance
to display the distance from one poll to the next when in a zone
(4) Added attribute to_moved_distance
sensors:
_moved_from
shows the from location time
_moved_to
shows current location time
(5) Added attribute to allzone_distance
sensors:
_meters_distance
shows the distance in meters to the zone with 5-decimal place accuracy,
_meters_distance_to_zone_edge
shows the distance in meters to the edge of the zone
(6) Added attribute to allzone_distance
sensors:
_miles_distance
shows the distance in miles to the zone with 4-decimal place accuracy if the
unit_of_measure is miles.