Skip to main content

TUI強震モニタ

ターミナル上で動作するリアルタイム地震情報モニターアプリケーション。

P2P地震情報 API v2 を利用して、地震情報・津波予報をリアルタイムに表示します。

機能

  • 🗾 ASCIIアート日本地図上に震源を表示
  • 🚨 緊急地震速報〔警報〕の受信時、地図上にP波・S波の到達予想円をアニメーション表示
  • ⏱️ 予報区ごとの主要動到達カウントダウン (「あと N 秒」)
  • 📊 震度分布をカラーバーチャートで表示
  • 📍 震度ごと・都道府県ごとの観測地点名 (市区町村レベル) を一覧表示
  • 📋 地震履歴の一覧表示
  • 🌊 津波予報の警告表示
  • 🔄 WebSocket によるリアルタイム更新
  • ⌨️ キーボードショートカットによる操作

インストール

PyPI からインストール (推奨)

パッケージ名は kanameishi、起動コマンドは kaname です。依存関係を専用の仮想環境に隔離したまま、どのディレクトリからでも実行できます。

# pipx が未導入の場合 (初回のみ)
brew install pipx
pipx ensurepath  # PATH 追加。反映されない場合はターミナルを再起動

pipx install kanameishi

uv を使っている場合:

uv tool install kanameishi

インストールせず一度だけ試す (コマンド名が違うため --from が必要):

uvx --from kanameishi kaname

更新・アンインストール:

pipx upgrade kanameishi
pipx uninstall kanameishi

Release の wheel を指定する

バージョンを固定したい場合は、Releases に添付された wheel を直接指定できます。

# X.Y.Z は Releases ページで最新のバージョンに置き換えてください
pipx install https://github.com/yamato3010/kanameishi/releases/download/vX.Y.Z/kanameishi-X.Y.Z-py3-none-any.whl

ソースからインストール

# リポジトリのルートで実行
pipx install .

# 更新する場合 (コードを変更/pull した後)
pipx install . --force

pipx を使わない場合

pip install --user .

開発用インストール (editable)

コードを編集しながら動作確認したい場合はこちら。

pip install -e .

使い方

# モジュールとして実行 (editable インストール時など)
python -m kanameishi

# グローバルインストール後はどこからでも実行可能
kaname

キーバインド

キー 動作
Q アプリ終了
R データ更新
(K J) 履歴スクロール
D 選択した地震の詳細表示
? このアプリについて (Esc で閉じる)
E 緊急地震速報のデモ表示 (動作確認用)

緊急地震速報について

  • P2P地震情報の code 556 (緊急地震速報〔警報〕) を受信して表示します。警報級 (予想最大震度5弱以上) のみ配信されるため、実際に受信する機会はまれです
  • P波 (○) ・S波 (●) の到達予想円は定数速度 (P: 7km/s, S: 4km/s) による近似で、気象庁の走時表とは数秒ずれることがあります
  • E キーでデモ用のEEWを表示して動作を確認できます
  • 環境変数 KANAME_SANDBOX=1 を設定して起動すると、P2P地震情報の開発サンドボックスAPI (過去データの繰り返し配信) に接続します

時刻の扱い

画面に出る時刻・相対表記 (「n分前」) ・カウントダウンはすべて日本標準時 (JST) 基準です。端末のタイムゾーンがJST以外でもずれません。

データソース

P2P地震情報 - 商用・非商用問わず無償利用可能

ライセンス

MIT

Download files

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

Source Distribution

kanameishi-0.2.0.tar.gz (32.9 kB view details)

Uploaded Source

Built Distribution

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

kanameishi-0.2.0-py3-none-any.whl (35.5 kB view details)

Uploaded Python 3

File details

Details for the file kanameishi-0.2.0.tar.gz.

File metadata

  • Download URL: kanameishi-0.2.0.tar.gz
  • Upload date:
  • Size: 32.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for kanameishi-0.2.0.tar.gz
Algorithm Hash digest
SHA256 b689570c10319f7aad1defebb23466d33ba4ff138a3077e9b1d127bdd6b2f413
MD5 05c4579d550ee01fd662e9edd12e8b95
BLAKE2b-256 52abfcb75c5df64791f23404c9b96b5754c5ac74d627aa978c29f6cd32c6404b

See more details on using hashes here.

Provenance

The following attestation bundles were made for kanameishi-0.2.0.tar.gz:

Publisher: release-please.yml on yamato3010/kanameishi

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

File details

Details for the file kanameishi-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: kanameishi-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 35.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for kanameishi-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 90e64b293ed23e4497fafb9a6f9e2abc79470b29738423d94c51b91868cbdf34
MD5 76ce6b761c6aa99aadbb3bbfabe796eb
BLAKE2b-256 fde16394f19a7cadd7d909ef91635ee3eb888f64a93d79555c596f6a8522f872

See more details on using hashes here.

Provenance

The following attestation bundles were made for kanameishi-0.2.0-py3-none-any.whl:

Publisher: release-please.yml on yamato3010/kanameishi

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page