This Home Assistant integration allows you to track the last update time of your Canadian citizenship application directly from your Home Assistant instance.

To manually install this integration from GitHub, follow these instructions:

• Add cit_canada folder with the contents of this repository into the custom_components directory of your Home Assistant installation. If the custom_components directory does not exist, create it at the same level as your configuration.yaml file.
• Restart Home Assistant to apply the changes.
• After restarting, configure the integration through the Home Assistant UI.

To configure this custom integration, follow these steps:

1. Navigate to your Home Assistant's Settings -> Devices and Services.
2. Click on the Add Integration button.
3. Search for the Canadian Citizenship Application Tracker and select it.
4. Enter your credentials as required from the citizenship tracker website to authenticate.

With this integration, you can monitor multiple citizenship applications simultaneously. To include additional UCIs, navigate to the "Canadian Citizenship Application Tracker" device within the Home Assistant UI, and select "Add entry".

Upon successful authentication, two new entities will be added to your Home Assistant:

• sensor.uci_1234_profile_updated_at: Tracks the last update time of your citizenship application, including "ghost updates." The 1234 in the entity ID represents the last 4 digits of your UCI.
• sensor.uci_1234_data_synced_at: Tracks the time when the data was last synced with the citizenship tracker website. The 1234 in the entity ID also represents the last 4 digits of your UCI.

You can set up automations in Home Assistant to act upon updates. For example, to receive a notification on your phone when your citizenship application receives any updates, you can configure an automation like this:

alias: Notify on Citizenship Application Update
description: Sends a notification to my phone when the citizenship application status updates.
trigger:
  - platform: state
    entity_id: sensor.uci_1234_profile_updated_at
condition:
  - condition: template
    value_template: >
      {{ trigger.from_state.state not in ['unknown', 'none', 'unavailable'] and
         trigger.to_state.state not in ['unknown', 'none', 'unavailable'] }}
action:
  - service: notify.mobile_app_<your_device>
    data:
      message: "Your Canadian Citizenship application has been updated."

Replace sensor.uci_1234_last_update_time with the actual entity ID corresponding to your application and <your_device> with your mobile device identifier in Home Assistant.

This integration checks for updates on your Canadian citizenship application every 4 hours.