Metadata-Version: 2.5
Name: fdsn-rush
Version: 0.1.0
Summary: Fast and reliable download of seismic waveform data from FDSN web services into SDS archives
Project-URL: Homepage, https://miili.github.io/FDSN-rush/
Project-URL: Documentation, https://miili.github.io/FDSN-rush/
Project-URL: Repository, https://github.com/miili/FDSN-rush
Project-URL: Issues, https://github.com/miili/FDSN-rush/issues
Project-URL: Releases, https://github.com/miili/FDSN-rush/releases
Author-email: Marius Paul Isken <marius.isken@gfz.de>
Maintainer-email: Marius Paul Isken <marius.isken@gfz.de>
License-Expression: GPL-3.0-or-later
License-File: LICENSE
Keywords: download,eida,fdsn,fdsnws,miniseed,sds,seismology
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.11
Requires-Dist: aiohttp>=3.12.14
Requires-Dist: pydantic>=2.11.7
Requires-Dist: pyrocko>=2025.1.21
Requires-Dist: rich>=14.1.0
Requires-Dist: typer>=0.16.0
Description-Content-Type: text/markdown

# FDSN Rush

*Fast and modern FDSN Download*

[![Tests](https://github.com/miili/FDSN-rush/actions/workflows/tests.yaml/badge.svg)](https://github.com/miili/FDSN-rush/actions/workflows/tests.yaml)
[![Documentation](https://github.com/miili/FDSN-rush/actions/workflows/docs.yaml/badge.svg)](https://miili.github.io/FDSN-rush/)
[![Pre-commit](https://github.com/miili/FDSN-rush/actions/workflows/pre-commit.yaml/badge.svg)](https://github.com/miili/FDSN-rush/actions/workflows/pre-commit.yaml)
[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

*FDSN Rush* downloads seismic waveform data from [FDSN](https://www.fdsn.org/webservices/) servers into a local [SDS](https://www.seiscomp.de/doc/apps/slarchive.html#slarchive-section-sds) archive in a fast, reproducible and reliable way. It also saves the matching StationXML metadata.

- Concurrent, rate-limited downloads from one or more data centres.
- Resumable: reruns only fetch what is missing.
- Channel priorities, wildcard station selection and sampling-rate filters.
- Restricted data with EIDA tokens.

**Documentation: <https://miili.github.io/FDSN-rush/>**

## Installation

Requires Python 3.11 or newer.

```sh
uv tool install git+https://github.com/miili/FDSN-rush
# or
pip install git+https://github.com/miili/FDSN-rush
```

## Quick start

```sh
fdsn-rush init > config.json      # write the default configuration
# edit station_selection and time_range in config.json
fdsn-rush download config.json    # download into data/ and metadata/
```

Convert existing MiniSEED files into an SDS archive:

```sh
fdsn-rush convert in-folder/ out-sds-folder/
```

See the [Getting started guide](https://miili.github.io/FDSN-rush/getting-started/) for a full walkthrough and the [configuration reference](https://miili.github.io/FDSN-rush/reference/configuration/) for all options.
