Integrations

Your home, earthquake-aware.

When the GeoShake network confirms an earthquake, your smart home can react in seconds — flash the lights, sound a siren, announce a warning, run your emergency scene. Free, open source, five-minute setup.

A helpful extra layer — not a life-safety system. Automations can be delayed or fail to run. For official earthquake early warning, always rely on your national authority (e.g. AFAD/Kandilli in Türkiye, USGS ShakeAlert in the US) and GeoShake's own app alerts.

Home Assistant

Available

Bring GeoShake earthquake alerts into Home Assistant in about five minutes. No coding, no configuration files — you just sign in with your GeoShake account.

What you'll need

  • A running Home Assistant installation (version 2024.11 or newer — OS, Container or Supervised all work)
  • HACS (Home Assistant Community Store) installed
  • Your GeoShake account (email + password)
  • About 5 minutes
No device required. You don't need a GeoShake sensor of your own to receive network-wide alerts — the integration listens to confirmed events from the whole GeoShake network. A GeoShake T1 of your own strengthens coverage where you live.

How it works

01

Network confirms

3+ GeoShake stations agree an earthquake is real — false alarms stay out.

02

Secure alert

The event reaches your Home Assistant over a personal, read-only, encrypted (TLS) connection.

03

Sensor turns ON

The Earthquake sensor flips ON for two minutes, then clears itself automatically.

04

Your home reacts

Automations run — lights, sirens, announcements, scenes, phone notifications.

The integration sets up its own connection — it does not use or occupy Home Assistant's MQTT integration.

Setup

Install the integration (HACS)

  1. In Home Assistant, open HACS.
  2. Click ⋮ (top right) → Custom repositories and add the repository below with type Integration:
https://github.com/GeoShake/geoshake-homeassistant
  1. Search for GeoShake in HACS → Download (latest version).
  2. Restart Home Assistant (Settings → System → Restart).

Sign in with your GeoShake account

  1. Go to Settings → Devices & Services → + Add Integration and search GeoShake.
  2. Choose "Sign in with GeoShake account (recommended)".
  3. Enter your GeoShake email and passwordSubmit.

That's it — your personal connection credentials are created automatically behind the scenes, and your account password is never stored in Home Assistant. A GeoShake Network device appears with three entities:

EntityWhat it shows
EarthquakeON when the network confirms an earthquake; clears after 2 minutes. Attributes: intensity class, station count, max PGA, coordinates, distance_km from your home.
Last eventTime of the most recent confirmed event, with the same attributes.
ConnectionLive connection status (diagnostic) — handy for support.

Quick check: Developer Tools → States, filter by geoshake. Earthquake should show off and Connection should be Connected.

Create an automation

Make Home Assistant do something when an earthquake is detected. Use the visual editor — it's the easiest way and avoids YAML mistakes.

  1. Settings → Automations & Scenes → + Create Automation → Start with an empty automation.
  2. When (trigger): Add Trigger → Entity → State · Entity: the GeoShake Earthquake sensor · To: On (Detected).
  3. Then do (action): pick what should happen — e.g. light.turn_on for a light or switch.turn_on for a smart plug.
  4. Save and name it, e.g. "GeoShake earthquake alert".
GoalAction to add
Flash lights redlight.turn_on → color red, brightness 100%
Power a siren or buzzerswitch.turn_on on the smart plug it's connected to
Voice announcementtts.speak"Earthquake warning. Take cover."
Run a scenescene.turn_on → your "emergency" scene
Phone notificationnotify.mobile_app_… → your device
Match the service to the device type. A smart plug is a switch → use switch.turn_on. Using light.turn_on on a plug won't work. And for voice: some smart speakers have limited non-English support — an English announcement or a language-independent siren sound is the most reliable.

Options — alert radius & auto-clear

Settings → Devices & Services → GeoShake → Configure:

OptionDefaultWhat it does
Alarm auto-clear delay120 sHow long the alarm stays ON after the last event.
Alert radius from home0 (off)0 = alarm for every confirmed network event. Set a distance in km to only trigger for earthquakes near your home. Uses your Home Assistant home location (Settings → System → General) — set it correctly first. The Last event sensor always shows every network event regardless of the radius.
One account = one installation. Signing in again on a second Home Assistant refreshes your personal credentials — the previous installation loses its connection. Advanced: a Manual MQTT credentials option also exists in the setup menu for users with dedicated read-only credentials; most users should use account sign-in.

Apple Home

Via Home Assistant

Home Assistant can expose the GeoShake sensor to Apple Home through its built-in HomeKit Bridge — so a confirmed earthquake can trigger HomePod automations, scenes and stronger notifications on your iPhone.

Add the HomeKit Bridge

Settings → Devices & Services → + Add Integration → HomeKit Bridge. When asked which entities to include, add the GeoShake Earthquake sensor.

Scan the code in the Home app

Home Assistant shows a setup / QR code. On your iPhone, open the Home app → Add Accessory → scan it.

Automate

The sensor appears in Apple Home as a safety sensor, so it can trigger HomePod automations — lights, scenes, alarm sounds — and time-sensitive notifications.

You'll need: Home Assistant always running, plus an Apple hub at home (HomePod or Apple TV) for automations to run.

Google Home

Available

Two ways to connect — pick whichever fits your setup.

Easiest: link your account directly

GeoShake has a direct Google Home integration that doesn't need Home Assistant at all. In the Google Home app, link your GeoShake account, then create a routine on the GeoShake Seismic Sensor — for example: "When Earthquake is detected → Broadcast 'Earthquake warning' on your speakers."

Via Home Assistant Cloud

  1. Settings → Home Assistant Cloud → enable Google Assistant (Nabu Casa).
  2. Expose the GeoShake Earthquake sensor.
  3. In the Google Home app, create your routine on the exposed sensor.

Smart Life / Tuya

Available

Smart Life and Tuya Smart are the same platform, and between them they run a very large share of the world's smart plugs, bulbs, sirens and cameras. Connect your GeoShake T1 once and a confirmed earthquake becomes something your house can act on — not just a notification you have to read. It only reacts to earthquakes within about 300 km of the sensor — a quake on the other side of the world does nothing.

What you'll need

A GeoShake T1 that is online, and a free account in Smart Life or Tuya Smart. Either app works — they share the same platform, so pick whichever you already have. No hub and no bridge: the sensor talks to the Tuya cloud through GeoShake.

Connect it

Nothing to scan. Open the GeoShake app → the My Station tab → tap your sensor → at the top right → IntegrationsSmart Life / Tuya SmartConnect to Smart Life. The app hands you over to Smart Life to finish adding the sensor.

Build the automation

The sensor now appears in your app like any other device, so it can start a Tap-to-Run or an Automation: turn the hall lights on, open a smart lock, sound a siren, start a camera recording, cut power to a heater.

Two signals — network and local. Get this right.

The sensor reports two separate states, and they answer two different questions. Picking the wrong one is the single most common way these automations end up switched off after a week, so it is worth thirty seconds now.

Shock State (network)Lock Shock (local)
Answers"Was there a real earthquake?""Did this sensor just move?"
Who decidesThe GeoShake network — several stations have to agree, and the earthquake has to be within about 300 km of your sensorThis one device, on its own
DistanceOnly within about 300 km of your sensor. Farther earthquakes are never sent, however strongNot applicable — this device only
Valuesnormalvibration → back to normal.
The list also offers drop and tilt — GeoShake never sets them
normalshaking → back to normal
How longStays in alert for two minutes, then clears itselfShort pulse, then a cool-down before it can fire again
False alarmsVery rare — one station alone can never trigger itExpected. A slammed door, a passing truck or someone bumping the shelf will do it
DefaultOnOff — you turn it on, and pick one of three sensitivity levels
Build on itYes — safety automations belong here. Lights, locks, sirens, cutting powerOnly for "something happened in this room" reactions. Never for anything that must not fire by mistake
The short version: if the automation would embarrass you or wake the house when it goes off for nothing, put it on the network signal. The local signal is a nice extra — it is faster, because it does not wait for the network to agree, but it cannot tell an earthquake from a delivery van hitting the kerb.

A worked example: lights on when an earthquake is confirmed

Two minutes in the Smart Life app, no hub and nothing to install. This is the automation to build first.

  1. Open Smart Life (or Tuya Smart) → the Smart tab → Automation+.
  2. When: choose When device status changes → pick your GeoShake sensor. The app offers two statuses: pick Shock State (the network signal) and set it to vibration.
    Watch out: that list also shows drop and tilt. GeoShake never sets those — an automation built on them will simply never run. For the network alert the only value that fires is vibration.
  3. Then: Run the device → pick your hallway light → Switch: On, and if it is a bulb, Brightness: 100%. Add more tasks the same way — a plug for a siren, a smart lock to unlock.
  4. Save and name it something you will recognise at 3 a.m., e.g. "Earthquake — light the way out".
If you wantAdd this task
A lit exit routeHallway, stairs and entrance lights → On, brightness 100%
To be woken upA siren or buzzer on a smart plug → On
The door not to jam shutSmart lock → Unlock (check your own risk trade-off first)
Less to burnHeater, iron, water pump plugs → Off
To see what happenedCamera → Start recording

You do not need a second automation to turn things off: the sensor clears itself after two minutes. If you want the lights to go off again, add a second automation on the same status going back to normal.

What people actually build

  • Light the way out. Hallway, stairs and entrance lights to full brightness — power often goes at the worst moment, and a lit exit route is worth more than a phone in your pocket.
  • Open the escape route. A smart lock or garage door that unlocks, so a jammed door frame is not what stops you.
  • Wake the house. A siren or smart speaker announcement — the alert reaches people who are asleep or not holding a phone.
  • Cut the risk. Smart plugs off for heaters, irons and the water pump; a fire that starts after the shaking is a well-documented pattern.
  • Look afterwards. Cameras start recording, so you can check on rooms, pets or elderly relatives without walking through the house.
Good to know: in Smart Life the sensor is read-only — GeoShake reports to it, nothing in the app can change your device. It reacts when the GeoShake network confirms an earthquake within about 300 km of your sensor — not to events on the other side of the world. Removing the device from your GeoShake account also removes the Smart Life connection, and capacity is limited while the integration rolls out — if every slot is in use the app takes your e-mail and tells you when one opens.

Understanding the alerts

  • The sensor turns ON only for network-confirmed earthquakes (3+ GeoShake stations agree) — this keeps false alarms very low.
  • By default it covers the whole GeoShake network. Only care about nearby events? Set the alert radius.
  • The sensor clears itself automatically (default 2 minutes, configurable).
  • An alert travels network → cloud → Home Assistant → your devices in a few seconds, so for a very close earthquake the warning window may be short. A helpful layer — never your primary warning.

Your data & privacy

  • Your account password is never stored — it's used once during setup to create personal connection credentials.
  • The connection is read-only and encrypted (TLS). Home Assistant can only listen — it can never publish to the GeoShake network, so injecting a fake alert from your side is impossible.
  • Earthquake events are public data (they already appear on the live map) — nothing private is exposed.
Migrating from the old manual MQTT setup?
  1. Remove the mqtt: binary_sensor: GeoShake block from configuration.yaml (Developer Tools → Check Configuration → reload YAML).
  2. If the GeoShake server occupied your MQTT integration, delete that MQTT config or repoint it to your own local broker — the new integration connects on its own and frees the MQTT slot.
  3. Install the integration (steps above) and update your automations to trigger on the new Earthquake entity.

Troubleshooting

"Invalid email or password"

Check your GeoShake account credentials — the same ones you use for the GeoShake app and Google Home linking.

"Too many attempts"

Wait about 5 minutes and try again — sign-in is rate-limited for security.

"Could not connect to the GeoShake server"

Check your internet connection and that outbound port 8883 isn't blocked by your firewall, then try again.

Entities show "Unavailable"

Check the Connection diagnostic entity. The integration reconnects automatically; if it stays disconnected, your network may block port 8883 — or your credentials were refreshed by a newer installation. Re-add the integration to sign in again.

The sensor exists but never turns ON

Normal until an earthquake occurs. The Last event sensor shows the most recent confirmed network event.

The alarm never triggers with a radius set

Make sure your Home Assistant home location is set (Settings → System → General) — the radius measures from there. Set the radius to 0 to receive all events.

The automation runs but nothing happens

Check that the service matches the device: smart plug → switch.turn_on, light → light.turn_on.

GeoShake doesn't appear in HACS search

Make sure you added the custom repository with type Integration, then refresh HACS.

Make your home part of the network.

The GeoShake T1 strengthens detection where you live — and your smart home reacts the moment it matters.