From d3d5c973f6c5cbbf08aa5c2a26fd313d6dd135e3 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Fri, 27 Mar 2026 08:58:06 +0100 Subject: [PATCH 01/16] Add Eve Online integration documentation --- source/_integrations/eveonline.markdown | 164 ++++++++++++++++++++++++ 1 file changed, 164 insertions(+) create mode 100644 source/_integrations/eveonline.markdown diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown new file mode 100644 index 000000000000..40274be1c081 --- /dev/null +++ b/source/_integrations/eveonline.markdown @@ -0,0 +1,164 @@ +--- +title: Eve Online +description: Instructions on how to integrate Eve Online with Home Assistant. +ha_release: "2026.5" +ha_category: + - Sensor +ha_iot_class: Cloud Polling +ha_config_flow: true +ha_codeowners: + - '@ronaldvdmeer' +ha_domain: eveonline +ha_platforms: + - binary_sensor + - diagnostics + - sensor +ha_integration_type: hub +--- + +The **Eve Online** {% term integration %} allows you to monitor [Eve Online](https://www.eveonline.com/) server status and character data in Home Assistant. Eve Online is a massively multiplayer online game by CCP Games. This integration uses the [Eve Swagger Interface (ESI)](https://esi.evetech.net/) API to retrieve data about the Tranquility server and your characters. + +## Prerequisites + +- An Eve Online account. You can create one at [eveonline.com](https://www.eveonline.com/). +- An Eve Online developer application for OAuth2 authentication. Instructions for that are in the next step. + +### Create an Eve Online developer application + +For Home Assistant to communicate with Eve Online, you need to create an application at the Eve Online developer portal. This provides you with the application credentials Home Assistant needs to allow you to log in with your Eve Online account. + +1. Log in to the [Eve Online Developer Portal](https://developers.eveonline.com/). + +2. Select **Create New Application**. + +3. Enter a name and description for your application. + +4. Under **Connection Type**, select **Authentication & API Access**. + +5. Add the following **Permissions (Scopes)**: + + - `esi-location.read_location.v1` + - `esi-location.read_ship_type.v1` + - `esi-location.read_online.v1` + - `esi-skills.read_skills.v1` + - `esi-skills.read_skillqueue.v1` + - `esi-clones.read_clones.v1` + - `esi-wallet.read_character_wallet.v1` + - `esi-characters.read_standings.v1` + - `esi-characters.read_corporation_roles.v1` + - `esi-killmails.read_killmails.v1` + +6. Set the **Callback URL** to: + + `https://my.home-assistant.io/redirect/oauth` + +7. Select **Create Application**. + +8. On the application details page, note the **Client ID** and **Secret Key**. You will need these during the integration setup in Home Assistant. + +{% details "I have manually disabled My Home Assistant" %} + +If you don't have [My Home Assistant](/integrations/my) on your installation, +you can use `/auth/external/callback` as the callback URL +instead. + +The `` must be the same as used during the configuration/ +authentication process. + +Internal examples: `http://192.168.0.2:8123/auth/external/callback`, `http://homeassistant.local:8123/auth/external/callback`. + +{% enddetails %} + +{% include integrations/config_flow.md %} + +## Supported functionality + +The integration creates two devices: one for the Tranquility server, and one for each character you add. + +### Server sensors + +- **Players online** + - **Description**: The number of players currently online on Tranquility. + +- **Server version** + - **Description**: The current server version of Tranquility. + +- **Start time** + - **Description**: The time the server was last started. + +### Server binary sensors + +- **Server VIP mode** + - **Description**: Whether the Tranquility server is in VIP mode. + - **Remarks**: This entity is disabled by default. + +### Character sensors + +- **Wallet balance** + - **Description**: The ISK balance of your character's wallet. + +- **Skill points** + - **Description**: The total number of skill points your character has. + +- **Skill queue** + - **Description**: The number of skills currently in your character's skill queue. + +- **Current ship** + - **Description**: The name of the ship type your character is currently flying. + +- **Location** + - **Description**: The solar system your character is currently in. + +- **Clone location** + - **Description**: The station or structure where your character's active clone is located. + +- **Security status** + - **Description**: Your character's current security status. + +- **Corporation** + - **Description**: The corporation your character is a member of. + +- **Alliance** + - **Description**: The alliance your character's corporation belongs to. + +- **Birthday** + - **Description**: The date your character was created. + +- **Current ship name** + - **Description**: The custom name of your character's current ship. + +- **Unread mail** + - **Description**: The number of unread mail messages. + - **Remarks**: This entity is disabled by default. + +- **Jump fatigue** + - **Description**: Your character's jump fatigue expiry time. + - **Remarks**: This entity is disabled by default. + +- **Active implants** + - **Description**: The number of active implants your character has. + - **Remarks**: This entity is disabled by default. + +### Character binary sensors + +- **Online** + - **Description**: Whether your character is currently online. + +## Using multiple characters + +This integration supports multiple Eve Online characters. You don't need to create another developer application. To add an additional character, add the integration again and log in with a different character. + +## Data updates + +The integration {% term polling polls %} data from the Eve Online ESI API every 60 seconds. + +## Known limitations + +- The integration only connects to the Tranquility server (the main live server). Singularity (test server) is not supported. +- Some character data may be delayed due to ESI API caching. + +## Removing the integration + +This integration follows standard integration removal, no extra steps are required. + +{% include integrations/remove_device_service.md %} From ba045631a67dcdb972b2a3adfad4505fee5839d1 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Fri, 27 Mar 2026 09:20:21 +0100 Subject: [PATCH 02/16] Add ha_quality_scale and troubleshooting section --- source/_integrations/eveonline.markdown | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 40274be1c081..b8f03edd155c 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -14,6 +14,7 @@ ha_platforms: - diagnostics - sensor ha_integration_type: hub +ha_quality_scale: bronze --- The **Eve Online** {% term integration %} allows you to monitor [Eve Online](https://www.eveonline.com/) server status and character data in Home Assistant. Eve Online is a massively multiplayer online game by CCP Games. This integration uses the [Eve Swagger Interface (ESI)](https://esi.evetech.net/) API to retrieve data about the Tranquility server and your characters. @@ -157,6 +158,20 @@ The integration {% term polling polls %} data from the Eve Online ESI API every - The integration only connects to the Tranquility server (the main live server). Singularity (test server) is not supported. - Some character data may be delayed due to ESI API caching. +## Troubleshooting + +### OAuth2 callback error + +If you get an error during the OAuth2 login flow, make sure the **Callback URL** in your Eve Online developer application is set to exactly: + +`https://my.home-assistant.io/redirect/oauth` + +Also ensure that [My Home Assistant](/integrations/my) is correctly configured and can reach your Home Assistant instance. + +### Entities show as unavailable + +If all entities become unavailable, the ESI API may be experiencing downtime. Check the [Eve Online server status](https://login.eveonline.com/) page. If the issue persists, try reauthenticating via **Settings** > **Devices & services** > **Eve Online** > **Reconfigure**. + ## Removing the integration This integration follows standard integration removal, no extra steps are required. From 91fbd23a9e258219533a43e967926c45f6b37843 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Fri, 27 Mar 2026 10:23:50 +0100 Subject: [PATCH 03/16] Fix documentation wording per review --- source/_integrations/eveonline.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index b8f03edd155c..88d12a6624d4 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -22,7 +22,7 @@ The **Eve Online** {% term integration %} allows you to monitor [Eve Online](htt ## Prerequisites - An Eve Online account. You can create one at [eveonline.com](https://www.eveonline.com/). -- An Eve Online developer application for OAuth2 authentication. Instructions for that are in the next step. +- An Eve Online developer application for OAuth2 authentication. Instructions are in the next section. ### Create an Eve Online developer application @@ -63,10 +63,10 @@ If you don't have [My Home Assistant](/integrations/my) on your installation, you can use `/auth/external/callback` as the callback URL instead. -The `` must be the same as used during the configuration/ +The `` must be the same as used during the configuration and authentication process. -Internal examples: `http://192.168.0.2:8123/auth/external/callback`, `http://homeassistant.local:8123/auth/external/callback`. +Example callback URLs: `http://192.168.0.2:8123/auth/external/callback`, `http://homeassistant.local:8123/auth/external/callback`. {% enddetails %} From 29f06d3bbfd779658270cddaed9b241adb0c8d11 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Fri, 27 Mar 2026 15:38:47 +0100 Subject: [PATCH 04/16] Update docs to match current integration (sensor-only, no diagnostics) --- source/_integrations/eveonline.markdown | 79 ++++++++++--------------- 1 file changed, 31 insertions(+), 48 deletions(-) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 88d12a6624d4..6a5ee3fd936d 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -10,8 +10,6 @@ ha_codeowners: - '@ronaldvdmeer' ha_domain: eveonline ha_platforms: - - binary_sensor - - diagnostics - sensor ha_integration_type: hub ha_quality_scale: bronze @@ -38,16 +36,16 @@ For Home Assistant to communicate with Eve Online, you need to create an applica 5. Add the following **Permissions (Scopes)**: + - `esi-characters.read_fatigue.v1` + - `esi-industry.read_character_jobs.v1` - `esi-location.read_location.v1` - - `esi-location.read_ship_type.v1` - `esi-location.read_online.v1` - - `esi-skills.read_skills.v1` + - `esi-location.read_ship_type.v1` + - `esi-mail.read_mail.v1` + - `esi-markets.read_character_orders.v1` - `esi-skills.read_skillqueue.v1` - - `esi-clones.read_clones.v1` + - `esi-skills.read_skills.v1` - `esi-wallet.read_character_wallet.v1` - - `esi-characters.read_standings.v1` - - `esi-characters.read_corporation_roles.v1` - - `esi-killmails.read_killmails.v1` 6. Set the **Callback URL** to: @@ -83,67 +81,52 @@ The integration creates two devices: one for the Tranquility server, and one for - **Server version** - **Description**: The current server version of Tranquility. - -- **Start time** - - **Description**: The time the server was last started. - -### Server binary sensors - -- **Server VIP mode** - - **Description**: Whether the Tranquility server is in VIP mode. - **Remarks**: This entity is disabled by default. ### Character sensors +- **Location** + - **Description**: The solar system your character is currently in. + +- **Ship** + - **Description**: The ship type your character is currently flying. + - **Wallet balance** - **Description**: The ISK balance of your character's wallet. -- **Skill points** +- **Total skill points** - **Description**: The total number of skill points your character has. +- **Unallocated skill points** + - **Description**: The number of unallocated skill points your character has. + - **Remarks**: This entity is disabled by default. + - **Skill queue** - **Description**: The number of skills currently in your character's skill queue. -- **Current ship** - - **Description**: The name of the ship type your character is currently flying. +- **Current training skill** + - **Description**: The skill currently being trained, including the target level. -- **Location** - - **Description**: The solar system your character is currently in. - -- **Clone location** - - **Description**: The station or structure where your character's active clone is located. +- **Current skill finish** + - **Description**: The estimated completion time of the skill currently being trained. -- **Security status** - - **Description**: Your character's current security status. +- **Unread mail** + - **Description**: The number of unread mail messages. -- **Corporation** - - **Description**: The corporation your character is a member of. +- **Industry jobs** + - **Description**: The number of active industry jobs. -- **Alliance** - - **Description**: The alliance your character's corporation belongs to. +- **Next industry finish** + - **Description**: The estimated completion time of the next industry job to finish. -- **Birthday** - - **Description**: The date your character was created. +- **Sell orders** + - **Description**: The number of active sell orders on the market. -- **Current ship name** - - **Description**: The custom name of your character's current ship. - -- **Unread mail** - - **Description**: The number of unread mail messages. - - **Remarks**: This entity is disabled by default. +- **Buy orders** + - **Description**: The number of active buy orders on the market. - **Jump fatigue** - **Description**: Your character's jump fatigue expiry time. - - **Remarks**: This entity is disabled by default. - -- **Active implants** - - **Description**: The number of active implants your character has. - - **Remarks**: This entity is disabled by default. - -### Character binary sensors - -- **Online** - - **Description**: Whether your character is currently online. ## Using multiple characters From 1d8b1ef5cab83488a2fc717817501f2962f383ec Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Mon, 30 Mar 2026 09:01:43 +0200 Subject: [PATCH 05/16] Improve eveonline docs: fix ha_release, details block, config_basic, status URL, troubleshooting structure --- source/_integrations/eveonline.markdown | 30 ++++++++++++++++++++----- 1 file changed, 25 insertions(+), 5 deletions(-) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 6a5ee3fd936d..c537185c8e6d 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -1,7 +1,7 @@ --- title: Eve Online description: Instructions on how to integrate Eve Online with Home Assistant. -ha_release: "2026.5" +ha_release: 2026.5 ha_category: - Sensor ha_iot_class: Cloud Polling @@ -58,18 +58,27 @@ For Home Assistant to communicate with Eve Online, you need to create an applica {% details "I have manually disabled My Home Assistant" %} If you don't have [My Home Assistant](/integrations/my) on your installation, -you can use `/auth/external/callback` as the callback URL +you can use `/auth/external/callback` as the redirect URI instead. -The `` must be the same as used during the configuration and +The `` must be the same as used during the configuration/ authentication process. -Example callback URLs: `http://192.168.0.2:8123/auth/external/callback`, `http://homeassistant.local:8123/auth/external/callback`. +Internal examples: `http://192.168.0.2:8123/auth/external/callback`, `http://homeassistant.local:8123/auth/external/callback`. {% enddetails %} {% include integrations/config_flow.md %} +The integration setup will next give you instructions to enter the [Application Credentials](/integrations/application_credentials/) (OAuth Client ID and Client Secret) and authorize Home Assistant to access your Eve Online account. + +{% configuration_basic %} +Client ID: + description: "The Client ID from your Eve Online developer application." +Client Secret: + description: "The Secret Key from your Eve Online developer application." +{% endconfiguration_basic %} + ## Supported functionality The integration creates two devices: one for the Tranquility server, and one for each character you add. @@ -153,7 +162,18 @@ Also ensure that [My Home Assistant](/integrations/my) is correctly configured a ### Entities show as unavailable -If all entities become unavailable, the ESI API may be experiencing downtime. Check the [Eve Online server status](https://login.eveonline.com/) page. If the issue persists, try reauthenticating via **Settings** > **Devices & services** > **Eve Online** > **Reconfigure**. +#### Symptom + +All entities show as unavailable. + +#### Description + +The ESI API may be experiencing downtime. + +#### Resolution + +1. Check the [Eve Online server status](https://status.eveonline.com/) page to see if there is a known outage. +2. If the status is healthy and the issue persists, try reauthenticating: go to {% my integrations title="**Settings** > **Devices & services**" %}, select **Eve Online**, and then select **Reconfigure**. ## Removing the integration From 86f8c2b001913950b429be18611cab7dc0f68bcd Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Mon, 30 Mar 2026 09:15:03 +0200 Subject: [PATCH 06/16] Fix Eve Online developer portal setup steps to match current UI --- source/_integrations/eveonline.markdown | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index c537185c8e6d..e501977a54d6 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -28,13 +28,15 @@ For Home Assistant to communicate with Eve Online, you need to create an applica 1. Log in to the [Eve Online Developer Portal](https://developers.eveonline.com/). -2. Select **Create New Application**. +2. Select **Manage Applications**. -3. Enter a name and description for your application. +3. Select **Create Application**. -4. Under **Connection Type**, select **Authentication & API Access**. +4. Enter a name and description for your application under **Basic information**. -5. Add the following **Permissions (Scopes)**: +5. Set the **Callback URL** to: `https://my.home-assistant.io/redirect/oauth` under **Application Settings**. + +6. Select the following **Enabled Scopes**: - `esi-characters.read_fatigue.v1` - `esi-industry.read_character_jobs.v1` @@ -47,13 +49,9 @@ For Home Assistant to communicate with Eve Online, you need to create an applica - `esi-skills.read_skills.v1` - `esi-wallet.read_character_wallet.v1` -6. Set the **Callback URL** to: - - `https://my.home-assistant.io/redirect/oauth` - -7. Select **Create Application**. +7. Select **Save**. -8. On the application details page, note the **Client ID** and **Secret Key**. You will need these during the integration setup in Home Assistant. +8. On the **Your applications** page, note the **Client ID** and **Client Secret**. You will need these during the integration setup in Home Assistant. {% details "I have manually disabled My Home Assistant" %} From 28b43d6608aeb2abab281081e85e9b0d5d7d01b6 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Mon, 30 Mar 2026 09:38:54 +0200 Subject: [PATCH 07/16] Mention daily downtime (11:00-11:15 UTC) in troubleshooting --- source/_integrations/eveonline.markdown | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index e501977a54d6..7edc1d21e4d4 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -56,8 +56,7 @@ For Home Assistant to communicate with Eve Online, you need to create an applica {% details "I have manually disabled My Home Assistant" %} If you don't have [My Home Assistant](/integrations/my) on your installation, -you can use `/auth/external/callback` as the redirect URI -instead. +you can use `/auth/external/callback` as the redirect URI instead. The `` must be the same as used during the configuration/ authentication process. @@ -166,12 +165,15 @@ All entities show as unavailable. #### Description -The ESI API may be experiencing downtime. +Every day, the Eve Online servers go offline for routine maintenance from 11:00 to approximately 11:15 UTC (known as "daily downtime"). During this window, all entities will show as unavailable — this is expected and they will recover automatically once the servers come back online. + +Outside of this daily window, unavailable entities may indicate an unplanned outage or an ESI API issue. #### Resolution -1. Check the [Eve Online server status](https://status.eveonline.com/) page to see if there is a known outage. -2. If the status is healthy and the issue persists, try reauthenticating: go to {% my integrations title="**Settings** > **Devices & services**" %}, select **Eve Online**, and then select **Reconfigure**. +1. If it is between 11:00 and 11:15 UTC, wait for the daily downtime to end. Entities will recover automatically. +2. Otherwise, check the [Eve Online server status](https://status.eveonline.com/) page to see if there is a known outage. +3. If the status is healthy and the issue persists, try reauthenticating: go to {% my integrations title="**Settings** > **Devices & services**" %}, select **Eve Online**, and then select **Reconfigure**. ## Removing the integration From 13ded1b37e970791d10b0a068d341ba1e34809dd Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Mon, 30 Mar 2026 09:40:51 +0200 Subject: [PATCH 08/16] Mention extended downtime on patch days in troubleshooting --- source/_integrations/eveonline.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 7edc1d21e4d4..af97f8268ccd 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -167,7 +167,9 @@ All entities show as unavailable. Every day, the Eve Online servers go offline for routine maintenance from 11:00 to approximately 11:15 UTC (known as "daily downtime"). During this window, all entities will show as unavailable — this is expected and they will recover automatically once the servers come back online. -Outside of this daily window, unavailable entities may indicate an unplanned outage or an ESI API issue. +On patch days, the downtime can last significantly longer than 15 minutes. CCP Games usually announces extended downtime in advance via the [Eve Online status page](https://status.eveonline.com/) and their official channels. + +Outside of the daily downtime window, unavailable entities may indicate an unplanned outage or an ESI API issue. #### Resolution From 11646f545a827a7cc12b6d3a5bdf291253687062 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Tue, 31 Mar 2026 00:20:43 +0200 Subject: [PATCH 09/16] Remove server status sensors from Eve Online integration docs --- source/_integrations/eveonline.markdown | 15 +++------------ 1 file changed, 3 insertions(+), 12 deletions(-) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index af97f8268ccd..74625c2a4f06 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -15,7 +15,7 @@ ha_integration_type: hub ha_quality_scale: bronze --- -The **Eve Online** {% term integration %} allows you to monitor [Eve Online](https://www.eveonline.com/) server status and character data in Home Assistant. Eve Online is a massively multiplayer online game by CCP Games. This integration uses the [Eve Swagger Interface (ESI)](https://esi.evetech.net/) API to retrieve data about the Tranquility server and your characters. +The **Eve Online** {% term integration %} allows you to monitor [Eve Online](https://www.eveonline.com/) character data in Home Assistant. Eve Online is a massively multiplayer online game by CCP Games. This integration uses the [Eve Swagger Interface (ESI)](https://esi.evetech.net/) API to retrieve data about your characters. ## Prerequisites @@ -78,16 +78,7 @@ Client Secret: ## Supported functionality -The integration creates two devices: one for the Tranquility server, and one for each character you add. - -### Server sensors - -- **Players online** - - **Description**: The number of players currently online on Tranquility. - -- **Server version** - - **Description**: The current server version of Tranquility. - - **Remarks**: This entity is disabled by default. +The integration creates one device per character you add. ### Character sensors @@ -175,7 +166,7 @@ Outside of the daily downtime window, unavailable entities may indicate an unpla 1. If it is between 11:00 and 11:15 UTC, wait for the daily downtime to end. Entities will recover automatically. 2. Otherwise, check the [Eve Online server status](https://status.eveonline.com/) page to see if there is a known outage. -3. If the status is healthy and the issue persists, try reauthenticating: go to {% my integrations title="**Settings** > **Devices & services**" %}, select **Eve Online**, and then select **Reconfigure**. +3. If the status is healthy and the issue persists, check your application credentials at {% my application_credentials title="**Settings** > **Application credentials**" %}. ## Removing the integration From 161970eb5cd5506f920b7728f81f4307f1be4c17 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Tue, 31 Mar 2026 11:06:45 +0200 Subject: [PATCH 10/16] Add notes about scope future-proofing and credential privacy --- source/_integrations/eveonline.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 74625c2a4f06..79a11028d3ef 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -51,6 +51,10 @@ For Home Assistant to communicate with Eve Online, you need to create an applica 7. Select **Save**. +{% note %} +The scopes listed above are the minimum required for the current version of the integration. To prepare for future updates, consider enabling additional scopes on the Eve Online developer portal now. This way, you won't need to update your developer application when a new version of the integration adds support for more character data. +{% endnote %} + 8. On the **Your applications** page, note the **Client ID** and **Client Secret**. You will need these during the integration setup in Home Assistant. {% details "I have manually disabled My Home Assistant" %} @@ -76,6 +80,10 @@ Client Secret: description: "The Secret Key from your Eve Online developer application." {% endconfiguration_basic %} +{% note %} +Your Client ID and Client Secret are stored exclusively in your Home Assistant instance and are never shared with the integration developer or any third party. These credentials are used solely to authenticate your Home Assistant with the Eve Online API on your behalf. +{% endnote %} + ## Supported functionality The integration creates one device per character you add. From c4bfe569f4e7ccf14c60da099aa21ad25b023315 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Tue, 31 Mar 2026 11:11:51 +0200 Subject: [PATCH 11/16] Move future-proof scope note after step 8 to fix list numbering --- source/_integrations/eveonline.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 79a11028d3ef..8189c4debcda 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -51,12 +51,12 @@ For Home Assistant to communicate with Eve Online, you need to create an applica 7. Select **Save**. +8. On the **Your applications** page, note the **Client ID** and **Client Secret**. You will need these during the integration setup in Home Assistant. + {% note %} The scopes listed above are the minimum required for the current version of the integration. To prepare for future updates, consider enabling additional scopes on the Eve Online developer portal now. This way, you won't need to update your developer application when a new version of the integration adds support for more character data. {% endnote %} -8. On the **Your applications** page, note the **Client ID** and **Client Secret**. You will need these during the integration setup in Home Assistant. - {% details "I have manually disabled My Home Assistant" %} If you don't have [My Home Assistant](/integrations/my) on your installation, From 3b82d11dd90e2d49b94e4ff352eb77143c3100b5 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Tue, 31 Mar 2026 11:18:28 +0200 Subject: [PATCH 12/16] Add automation examples to Eve Online integration docs --- source/_integrations/eveonline.markdown | 53 +++++++++++++++++++++++++ 1 file changed, 53 insertions(+) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 8189c4debcda..8642dc9353f7 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -133,6 +133,59 @@ The integration creates one device per character you add. - **Jump fatigue** - **Description**: Your character's jump fatigue expiry time. +## Examples + +### Notify when skill queue is empty + +When your skill queue runs out, your character stops gaining skill points. This automation sends you a notification as soon as the queue drops to zero, giving you time to plan your next skills. + +```yaml +- alias: "Notify when skill queue is empty" + triggers: + - trigger: numeric_state + # Replace with your character's skill queue entity + entity_id: sensor.my_character_skill_queue + below: 1 + actions: + - action: notify.notify + data: + message: "Your skill queue is empty. Time to add new skills!" +``` + +### Notify when jump fatigue expires + +After jumping across systems, your character may have a jump fatigue timer active. This automation notifies you the moment the timer expires so you know when you can jump again. + +```yaml +- alias: "Notify when jump fatigue expires" + triggers: + - trigger: state + # Replace with your character's jump fatigue entity + entity_id: sensor.my_character_jump_fatigue + to: "unknown" + actions: + - action: notify.notify + data: + message: "Your jump fatigue has expired. Ready to jump again!" +``` + +### Alert when wallet balance drops below a threshold + +Keep an eye on your ISK balance with this automation. It triggers when your wallet drops below a set amount, so you can top it up before your market orders or industry jobs are affected. + +```yaml +- alias: "Alert when wallet balance is low" + triggers: + - trigger: numeric_state + # Replace with your character's wallet balance entity + entity_id: sensor.my_character_wallet_balance + below: 1000000 + actions: + - action: notify.notify + data: + message: "Your wallet balance dropped below 1,000,000 ISK." +``` + ## Using multiple characters This integration supports multiple Eve Online characters. You don't need to create another developer application. To add an additional character, add the integration again and log in with a different character. From adb179b387054be4a53de5866a9db1eb59b2688a Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Tue, 31 Mar 2026 11:24:06 +0200 Subject: [PATCH 13/16] Update wallet balance threshold to 100,000,000 ISK in example --- source/_integrations/eveonline.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 8642dc9353f7..6a12b4608ea0 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -179,11 +179,11 @@ Keep an eye on your ISK balance with this automation. It triggers when your wall - trigger: numeric_state # Replace with your character's wallet balance entity entity_id: sensor.my_character_wallet_balance - below: 1000000 + below: 100000000 actions: - action: notify.notify data: - message: "Your wallet balance dropped below 1,000,000 ISK." + message: "Your wallet balance dropped below 100,000,000 ISK." ``` ## Using multiple characters From f981ce9cc06efd7d7da8d0a6f73350aab7b3f7aa Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Tue, 31 Mar 2026 11:40:03 +0200 Subject: [PATCH 14/16] Add from: null to jump fatigue trigger to prevent false fires on restart --- source/_integrations/eveonline.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 6a12b4608ea0..0a3666c69ace 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -162,6 +162,7 @@ After jumping across systems, your character may have a jump fatigue timer activ - trigger: state # Replace with your character's jump fatigue entity entity_id: sensor.my_character_jump_fatigue + from: ~ to: "unknown" actions: - action: notify.notify From 5a766db54a21f95051b1b79c6432026042c3d9f3 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Tue, 31 Mar 2026 11:58:28 +0200 Subject: [PATCH 15/16] Fix jump fatigue example: use time trigger instead of state trigger --- source/_integrations/eveonline.markdown | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 0a3666c69ace..85179d2fb880 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -154,16 +154,14 @@ When your skill queue runs out, your character stops gaining skill points. This ### Notify when jump fatigue expires -After jumping across systems, your character may have a jump fatigue timer active. This automation notifies you the moment the timer expires so you know when you can jump again. +After jumping across systems, your character may have a jump fatigue timer active. This automation fires at the exact time stored in the jump fatigue sensor, notifying you the moment the cooldown is over. ```yaml - alias: "Notify when jump fatigue expires" triggers: - - trigger: state + - trigger: time # Replace with your character's jump fatigue entity - entity_id: sensor.my_character_jump_fatigue - from: ~ - to: "unknown" + at: sensor.my_character_jump_fatigue actions: - action: notify.notify data: From 20d5266d1036b4fa933264d170620dbe2c4c7368 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Tue, 31 Mar 2026 13:26:55 +0200 Subject: [PATCH 16/16] Add blank line before credential privacy note for spacing --- source/_integrations/eveonline.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/eveonline.markdown b/source/_integrations/eveonline.markdown index 85179d2fb880..827be5a11ea1 100644 --- a/source/_integrations/eveonline.markdown +++ b/source/_integrations/eveonline.markdown @@ -80,6 +80,7 @@ Client Secret: description: "The Secret Key from your Eve Online developer application." {% endconfiguration_basic %} + {% note %} Your Client ID and Client Secret are stored exclusively in your Home Assistant instance and are never shared with the integration developer or any third party. These credentials are used solely to authenticate your Home Assistant with the Eve Online API on your behalf. {% endnote %}