ARSO Potresi is a custom integration for Home Assistant that fetches earthquake data from the ARSO Potresi API and presents it as a sensor entity. The sensor displays the most recent earthquake's location (e.g., "6 km JV od Jelšan") as its state, while additional details are available as attributes.
Data provided by ARSO Potresi - Agencija RS za okolje. This integration is unofficial.
- Real-Time Earthquake Data: Fetches the latest earthquake information from the ARSO Potresi API.
- Sensor Entity: Displays key data such as local and UTC times, location, coordinates, depth, magnitude, EMS-98 intensity, and verification status.
- Device Registry Support: The integration creates a device with proper device info and a unique ID.
- Config Flow: Configurable via Home Assistant’s UI, with a single option to set the update interval (in minutes).
- Place the integration folder in your Home Assistant
custom_componentsdirectory:custom_components/arso_potresi/ ├── __init__.py ├── const.py ├── config_flow.py └── sensor.py
- Restart Home Assistant.
If you use HACS, you can add this repository as a custom integration following the HACS documentation for custom integrations.
This integration is configured via the UI using Home Assistant's Config Flow. No YAML configuration is required.
- Go to Settings > Devices & Services > Integrations.
- Click Add Integration and search for ARSO Potresi.
- In the configuration dialog, set the update interval (in minutes).
- Complete the setup. The integration will create a sensor entity named
sensor.arso_potresithat displays the most recent earthquake’s location as its state and includes all details as attributes.
- Data Fetching: The sensor fetches data from the ARSO Potresi API. It assumes that the first element in the returned JSON is the latest earthquake event.
- Data Formatting:
- Local Time: Formatted from the API's
TIMEfield (e.g., "20. 2. 2025 ob 23.11"). - UTC Time: Derived from the
TIME_ORIGfield. - Coordinates: Latitude and longitude values are formatted with a comma as the decimal separator.
- Additional Attributes: Depth (with "km" appended), magnitude (formatted with one decimal and a comma), EMS-98 intensity (displayed as "-" if null), and verification status based on the
REVISIONfield.
- Identifiers:
(arso_potresi, arso_potresi_sensor) - Name: ARSO Potresi
- Manufacturer: ARSO
- Model: Potresi
-
Integration Not Showing Up:
-
Ensure that the integration is placed in the correct directory:
custom_components/arso_potresi/ -
Check your Home Assistant logs for errors.
-
Restart Home Assistant after installation.
-
Data Issues:
-
Check the logs for any error messages during data fetch.
Contributions are welcome!
This project is licensed under the MIT License.