概要
weathr は、リアルタイム天気データに基づく ASCIIアニメーション 付きターミナル天気アプリ。 Open-Meteo からの天気情報取得や、 自動位置検出 機能を搭載。 雨・雪・雷・飛行機・昼夜サイクルなど多彩な アニメーション表現。 多様なインストール方法と 柔軟な設定オプション を提供。 プライバシーやカスタマイズ性にも配慮した設計。
weathr：リアルタイムASCII天気アプリ
- リアルタイム天気取得 ：Open-MeteoのAPI利用
- ASCIIアニメーション ：雨・雪・雷・飛行機・昼夜サイクルを表現
- 自動位置検出 ：IPアドレスから位置自動判定
- 多様なカスタマイズ ：単位・表示内容・アニメーション制御
- クロスプラットフォーム対応 ：Linux, macOS, NixOS, Arch Linux
インストール方法
- Cargo による簡単インストール
cargo install weathr
- ソースビルド （Rust必須）
git clone https://github.com/veirt/weathr.gitcd weathrcargo install --path .
- Homebrew（macOS）
brew install Veirt/veirt/weathr
- Arch Linux（AUR）
yay -S weathrまたはyay -S weathr-bin
- Nix flake（NixOS）
inputs = { weathr.url = "github:Veirt/weathr"; };environment.systemPackagesやhome-managerで導入
設定ファイル（config.toml）
-
Linux ：
~/.config/weathr/config.tomlまたは$XDG_CONFIG_HOME/weathr/config.toml -
macOS ：
~/Library/Application Support/weathr/config.toml -
作業ディレクトリ優先 ：カレントディレクトリの
config.tomlが最優先 -
主な設定項目
hide_hud：天気詳細の非表示silent：起動時メッセージ抑制[location]：緯度・経度・自動検出・地名非表示[units]：温度・風速・降水量単位指定
-
サンプル地点設定
- 東京：
latitude = 35.6762,longitude = 139.6503 - シドニー：
latitude = -33.8688,longitude = 151.2093
- 東京：
使い方
- リアルタイム天気表示
weathr
- 天気シミュレーション
- 雨：
weathr --simulate rain - 夜の雪：
weathr --simulate snow --night - 晴れ・落ち葉：
weathr --simulate clear --leaves
- 雨：
- 対応天気条件
- 晴れ：
clear,partly-cloudy,cloudy,overcast - 降水：
fog,drizzle,rain,freezing-rain,rain-showers - 雪：
snow,snow-grains,snow-showers - 嵐：
thunderstorm,thunderstorm-hail
- 晴れ：
コマンドラインオプション
- 単位切替
- インペリアル：
weathr --imperial - メトリック（デフォルト）：
weathr --metric
- インペリアル：
- 位置情報関連
- 自動検出：
weathr --auto-location - 座標非表示：
weathr --hide-location
- 自動検出：
- 表示制御
- HUD非表示：
weathr --hide-hud - サイレントモード：
weathr --silent - 複数フラグ同時指定可能
- HUD非表示：
キーボード操作
qまたはQ：終了Ctrl+C：強制終了
環境変数対応
-
NO_COLOR ：色出力無効化（アクセシビリティ対応）
-
COLORTERM ：truecolorサポート検出（"truecolor", "24bit"）
-
TERM ：ターミナル機能検出（例："xterm-256color"）
- 例：
NO_COLOR=1 weathr
- 例：
プライバシーと位置情報
- 自動位置検出 を有効にすると、
ipinfo.ioにリクエスト送信しIPベースで位置特定 - 無効化可能 ：設定ファイルで
auto = falseとし、手動で座標指定すれば外部API不要
今後のロードマップ
- OpenWeatherMap や WeatherAPI 対応予定
- AUR 経由のインストールサポート
- 手動リフレッシュ や アニメーション速度調整 などのキーバインド追加
ライセンスとクレジット
- ライセンス ：GPL-3.0-or-later
- 天気データ ：Open-Meteo.com（CC BY 4.0）
- ASCIIアート提供者
- House/Airplane/Moon：Joan G. Stark
- Sun：Hayley Jane Wakenshaw (Flump)
- 著作権帰属不明の場合 は原著者に帰属