Kanameishi(要石)
ターミナル上で動作するリアルタイム地震情報モニターアプリケーション。
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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file kanameishi-0.2.1.tar.gz.
File metadata
- Download URL: kanameishi-0.2.1.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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b6ceb7e9f032fed3c46bb9cd7de5235c20e8651dc195e7dbc633d6e955a426ed
|
|
| MD5 |
e3b20db3dabdbe4536ef2b94ed072c73
|
|
| BLAKE2b-256 |
1fd886b3e59b54237c2eb25ca9d148676400173658489d05cb4ecc27c2affbbc
|
Provenance
The following attestation bundles were made for kanameishi-0.2.1.tar.gz:
Publisher:
release-please.yml on yamato3010/kanameishi
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
kanameishi-0.2.1.tar.gz -
Subject digest:
b6ceb7e9f032fed3c46bb9cd7de5235c20e8651dc195e7dbc633d6e955a426ed - Sigstore transparency entry: 2280987121
- Sigstore integration time:
-
Permalink:
yamato3010/kanameishi@b5c8e87b3bde9c89c92c66e97cd92d3a3b02d1ed -
Branch / Tag:
refs/heads/main - Owner: https://github.com/yamato3010
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-please.yml@b5c8e87b3bde9c89c92c66e97cd92d3a3b02d1ed -
Trigger Event:
push
-
Statement type:
File details
Details for the file kanameishi-0.2.1-py3-none-any.whl.
File metadata
- Download URL: kanameishi-0.2.1-py3-none-any.whl
- Upload date:
- Size: 35.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1e76323f323e4a808cc836030191611d1484af0059c59e005eef0c4c25848375
|
|
| MD5 |
d7f5e75e3b9d8ec8ad08500cbe80b6de
|
|
| BLAKE2b-256 |
b825986f44c07524639d6972043daa610779c44b96c3418de795733c5feb75e0
|
Provenance
The following attestation bundles were made for kanameishi-0.2.1-py3-none-any.whl:
Publisher:
release-please.yml on yamato3010/kanameishi
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
kanameishi-0.2.1-py3-none-any.whl -
Subject digest:
1e76323f323e4a808cc836030191611d1484af0059c59e005eef0c4c25848375 - Sigstore transparency entry: 2280987130
- Sigstore integration time:
-
Permalink:
yamato3010/kanameishi@b5c8e87b3bde9c89c92c66e97cd92d3a3b02d1ed -
Branch / Tag:
refs/heads/main - Owner: https://github.com/yamato3010
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-please.yml@b5c8e87b3bde9c89c92c66e97cd92d3a3b02d1ed -
Trigger Event:
push
-
Statement type:
