Skip to content

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

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

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages