Skip to content
GeoShakePublic

About

Desktop tool for deep analysis of earthquakes captured by the GeoShake network)

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Repository files navigation

GeoShake Scope — a station listening above, a hypocenter radiating below

GeoShake Scope

T1 catches it. Scope explains it.

geoshake.org · Live Map · API · Downloads

Desktop tool for deep analysis of earthquakes captured by the GeoShake network. Open source (GPL-3.0-or-later). Runs locally on Windows, macOS and Linux.

Feeds on the public map.geoshake.org APIs: pick a network event, an official catalog earthquake (AFAD/USGS/EMSC) or a single station trigger — waveforms download automatically (SAC, 3-axis, m/s²). Or open local SAC files offline.

Features

  • Waveform grid with band-pass presets; gaps stay gaps (never zero-filled)
  • Spectrogram + Welch PSD per trace
  • P/S phase picking: STA/LTA auto-suggestion + draggable cursors, S-P → epicentral distance (Vp=6, Vs=3.5 km/s)
  • Ground motion: PGA / PGV / significant duration, station & event magnitude (GeoShake anchored-attenuation v1, UNCALIBRATED), approximate MMI (Worden 2012)
  • Verification: side-by-side with the official catalog (Δt, Δepicenter, ΔM), distance-sorted record section
  • Network events: the stations that solved the event on top, then every other station that triggered on it ("also triggered", the same list as the map replay), then every station within 150 km as a 1 Hz noise-normalised trace with expected P/S marks, so stations that did not trigger (and kept no waveform) are visible too
  • Station triggers show their official-catalog match right in the list (the same match as the station page on map.geoshake.org), with a "matches only" filter

Screenshots

A real M3.4 event (AFAD, 2026-08-18, Halkapınar, Türkiye) captured by station GEO-FVYSA:

Waveforms — 3-axis with band-pass presets Spectrogram heatmap + Welch PSD
P/S picking with catalog predictions Official-catalog verification

Install & run

Prebuilt packages: grab the latest from Releases — Windows (zip), macOS (zip, Apple Silicon) and Linux (tar.gz). The builds are unsigned for now, so the first launch needs a one-time unlock:

  • macOS — move the app to Applications, then either run xattr -dr com.apple.quarantine "/Applications/GeoShake Scope.app" in Terminal, or try to open it once and allow it under System Settings → Privacy & Security → Open Anyway.
  • Windows — accept the SmartScreen prompt (More info → Run anyway).

From source — requires uv (Python 3.12 is provisioned automatically):

git clone https://github.com/GeoShake/scope.git
cd scope
uv sync
uv run geoshake-scope

Configuration

Env var Meaning Default
GEOSHAKE_API_BASE API origin https://map.geoshake.org
GEOSHAKE_SCOPE_CACHE SAC cache dir OS user-cache dir

Tests

uv run pytest -q

Tests never touch the network. Be polite to the public API: the tool caches every downloaded SAC on disk and endpoints are IP rate-limited.

GeoShake T1 — the station behind the data

Scope analyzes what GeoShake T1 stations record: a compact seismic station that sets up over Wi-Fi in minutes and streams ground motion to the network 24/7. Get one, put it on your floor, and your own earthquakes show up here.

GeoShake mobile app

Watch the live network and get earthquake alerts on your phone:

Get it on Google Play Download on the App Store

License

GPL-3.0-or-later — see LICENSE.

About

Desktop tool for deep analysis of earthquakes captured by the GeoShake network)

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages