seedlink-client

SeedLink protocol client for streaming geophysical (seismic) data, with transparent support for both SeedLink 3.x and 4.0. SeedLink is a real-time streaming protocol used by seismological data systems (e.g. SeisComP, EarthScope's ringserver) to deliver miniSEED data as it is recorded.

Requires Python 3.11+.

Installation

pip install seedlink-client

Usage

Sync API

from seedlink_client import SeedLink

with SeedLink("rtserve.earthscope.org") as sl:
    sl.add_stream("IU_COLA", "BH?")
    for packet in sl.collect():
        print(packet.station_id, packet.seqnum, len(packet.payload))

Async API

AsyncSeedLink offers the same API as SeedLink, built on asyncio. Only the methods that do network I/O (connect, collect, info, ...) are coroutines; stream selection (add_stream and friends) is plain configuration and stays synchronous on both clients:

import asyncio
from seedlink_client import AsyncSeedLink

async def main():
    async with AsyncSeedLink("rtserve.earthscope.org") as sl:
        sl.add_stream("IU_COLA", "BH?")
        async for packet in sl.collect():
            print(packet.station_id, packet.seqnum, len(packet.payload))

asyncio.run(main())

Protocol versions

SeedLink/AsyncSeedLink negotiate SeedLink 3.x or 4.0 automatically from the server's HELLO reply and speak whichever is offered -- selectors, sequence numbers, time windows, and INFO queries all work the same way from the caller's side regardless of which protocol is in use. Pass protocol=Protocol.V3 or Protocol.V4 to pin a version instead of negotiating.

Packets carry their payload as raw bytes; call packet.record() to decode it as a pymseed MS3Record.

Command-line client

A non-interactive client is available after install:

seedlink-client [host:port]

Default is localhost:18000. Use seedlink-client --help for options (stream selection, time windows, state files, INFO queries, TLS, auth). Pass -c/--interactive for a low-level interactive shell that sends individual protocol commands (HELLO, STATION, SELECT, DATA, INFO, ...).

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for earthscope from gravatar.com earthscope

Credits

Author: EarthScope Data Services

License

Apache Software License (Apache-2.0)

Requires

Python >=3.11

Provides Extra

test

Tags

earthscope ringserver seedlink seismology

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seedlink_client-0.1.0.tar.gz (41.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

seedlink_client-0.1.0-py3-none-any.whl (49.1 kB view details)

Uploaded Python 3

File details

Details for the file seedlink_client-0.1.0.tar.gz.

File metadata

  • Download URL: seedlink_client-0.1.0.tar.gz
  • Upload date:
  • Size: 41.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for seedlink_client-0.1.0.tar.gz
Algorithm Hash digest
SHA256 7144f0900d683ceccd600dc5e4959a65f7a32e2e82e1ad4c657dd199d0cf2c15
MD5 a30adae49d100e0497d1e2b4d51ff2b7
BLAKE2b-256 1f51c5d1920f45610a9a5bcd2c4ad711d6fa883e854b1ab7da5cbc129ae33619

See more details on using hashes here.

Provenance

The following attestation bundles were made for seedlink_client-0.1.0.tar.gz:

Publisher: publish.yml on EarthScope/seedlink-client

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file seedlink_client-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for seedlink_client-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 736c78ecec5a1acd0457e19bd1f66e43fa970a575f65d142b8df5af24901b545
MD5 405b09613dda4edbd2109e5797937b33
BLAKE2b-256 5af21e2ce766170444c0b687879ef95d0f7f747fd85986160be1618772f015fa

See more details on using hashes here.

Provenance

The following attestation bundles were made for seedlink_client-0.1.0-py3-none-any.whl:

Publisher: publish.yml on EarthScope/seedlink-client

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.2.0

2 files

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page