
3分钟上手 weathr 终端天气应用从一键脚本到 Docker 的 8 种安装方式完全教程【免费下载链接】weathra terminal weather app with ascii animation项目地址: https://gitcode.com/gh_mirrors/wea/weathrweathr 是一款开源的终端天气应用用实时天气数据驱动 ASCII 动画——下雨、落雪、雷暴、飞机掠过、昼夜切换全部在你的终端里上演。本文是一份面向新手的 weathr 安装教程3 分钟带你走完全 8 种安装方式从一键安装脚本、Cargo 到 Docker 全覆盖并附上快速体验与配置入门。 效果预览终端里的真实天气动画安装完成前先看看 weathr 终端天气应用跑起来是什么感觉——以下动图全部来自项目自带演示天气数据来自 Open-Meteo 的实时接口动画场景雨滴、雪花、闪电、飞鸟、月亮盈亏会随真实天气自动匹配这也是它和传统命令行查天气工具最大的区别它不只是报数据而是把天气演出来。 安装方式速览8 种方法一分钟对照| # | 安装方式 | 适用平台 | 难度 | | :- | :------- | :------- | :-: | | 1 | 一键安装脚本 | macOS / Linux / FreeBSD | ⭐ | | 2 | Cargo | 已装 Rust 的环境 | ⭐ | | 3 | 源码编译 | 需要 Rust 工具链 | ⭐⭐ | | 4 | Docker 容器 | 任意支持 Docker 的系统 | ⭐ | | 5 | Homebrew / MacPorts | macOS | ⭐ | | 6 | AUR 包管理器 | Arch Linux | ⭐ | | 7 | Nix flake | NixOS / home-manager | ⭐⭐ | | 8 | Winget | Windows | ⭐ | 新手建议Linux / macOS 直接选方式一Windows 选方式八追求干净隔离选方式四 Docker。1️⃣ 一键安装脚本macOS / Linux / FreeBSD 最快方案项目自带的 install.sh 是官方推荐的一键安装方式。它会自动检测你的操作系统Linux / macOS / FreeBSD、CPU 架构amd64 / arm64以及 Linux 的 libcglibc / musl然后下载对应的最新预编译二进制安装到~/.local/binroot 用户则装到/usr/local/bin。克隆仓库后在根目录执行即可git clone https://gitcode.com/gh_mirrors/wea/weathr cd weathr sh install.sh脚本内置了依赖检查curl、mktemp 等、下载重试--retry 3与空文件校验安装结束后若提示~/.local/bin不在 PATH 中按提示把export PATH$PATH:~/.local/bin加进 shell 配置即可。2️⃣ 通过 Cargo 安装 Rust 版天气工具如果机器上已有 Rust 工具链一条命令搞定Cargo 会自动从 crates.io 拉取 weathr 包并编译cargo install weathr安装后可用cargo install --list | grep weathr确认版本。这是 Rust 生态下最标准的安装姿势缺点是没有预编译缓存首次编译需要几分钟。3️⃣ 从源码编译 weathr适合想改代码、或者想要最新主干功能的开发者。项目提供 nix/shell.nix 一键开发环境内含 rustc、cargo、rust-analyzergit clone https://gitcode.com/gh_mirrors/wea/weathr cd weathr cargo install --path .Nix 用户可以nix develop直接进入带完整 Rust 工具链的开发 shell无需手动装任何依赖。发布用的 Linux 打包流程nfpm 生成 deb/rpm 包 manpage在 scripts/package-linux.sh 中可顺带了解它如何分发。4️⃣ Docker 容器运行终端天气应用两种方式任选其一方式 A直接运行官方发布镜像docker run --rm -it ghcr.io/veirt/weathr:latest方式 B本地构建镜像再运行仓库根目录的 Dockerfile 采用多阶段构建rust 基础镜像负责编译最终产物基于scratch只带上 CA 证书和时区数据镜像体积极小。docker build -t weathr . docker run --rm -it weathr⚠️ 注意必须带-it参数TUI 界面需要接管你的终端。 如果已有本地配置可以把它只读挂载进容器docker run --rm -it \ -v $HOME/.config/weathr:/.config/weathr:ro \ ghcr.io/veirt/weathr:latestDocker 方案的最大好处是零环境污染适合服务器有 TTY 的会话或临时尝鲜。5️⃣ macOS 双方案Homebrew / MacPortsmacOS 用户有两条官方包管理渠道# Homebrew brew install Veirt/veirt/weathr # MacPorts sudo port install weathr两者都会处理可执行文件的放置与 PATH选你日常在用的那个即可。6️⃣ Arch LinuxAUR 一条命令Arch 与衍生产EndeavourOS、ArcoLinux 等通过 AUR 助手安装yay -S weathr # 源码编译版 yay -S weathr-bin # 预编译二进制版更快weathr-bin省去本地编译是更省时的选择。7️⃣ Nix flake 安装NixOS / home-manager项目在 flake.nix 中提供了完整 flake支持 x86_64 / aarch64 的 Linux 与 macOS。NixOS 系统级安装inputs { weathr.url github:Veirt/weathr; }; environment.systemPackages [ inputs.weathr.packages.${system}.default ];home-manager 模块化安装nix/hm-module.nix 暴露了programs.weathr选项还能直接声明式管理配置文件imports [ inputs.weathr.homeModules.weathr ]; programs.weathr { enable true; settings { hide_hud true; }; };8️⃣ WindowsWinget 一键安装Windows 用户走微软官方的 Winget 渠道winget install -i Veirt.weathr安装完成后打开终端建议 Windows Terminal字体渲染更佳直接输入weathr即可看到 ASCII 天气动画。 装好了怎么玩3 个命令快速体验weathr # 实时天气 自动动画 weathr --simulate rain # 模拟下雨不用等真实降雨 weathr --simulate snow --night # 夜间落雪配星空效果其他常用参数--imperial华氏度/英里、--metric公制默认、--auto-location按 IP 自动定位、--hide-hud隐藏状态面板。运行中按q或CtrlC退出。不想等真实天气--simulate支持 14 种天气条件clear、partly-cloudy、cloudy、overcast、fog、drizzle、rain、freezing-rain、rain-showers、snow、snow-grains、snow-showers、thunderstorm、thunderstorm-hail逐一试一遍就是免费解压。⚙️ 配置入门配置文件位置与常用选项配置文件是 TOML 格式各平台位置Linux~/.config/weathr/config.tomlmacOS~/Library/Application Support/weathr/config.tomlWindows~/AppData/Roaming/weathr/config.toml最小可用配置示例hide_hud false # 是否隐藏天气详情面板 silent false # 静默启动 [location] latitude 31.2304 # 手动指定坐标上海 longitude 121.4737 auto false # true 按 IP 自动定位 [units] temperature celsius # celsius / fahrenheit wind_speed kmh # kmh / ms / mph / kn precipitation mm # mm / inch 隐私提示只有开启auto true或--auto-location时weathr 才会请求 ipinfo.io 定位手动填写坐标则完全无外部定位调用。 想深入源码这些路径值得收藏模块路径说明一键安装脚本install.sh平台检测 二进制分发逻辑动画系统src/animation/mod.rs雨、雪、雷暴、飞鸟等动画调度天气数据层src/weather/mod.rs拉取、缓存与归一化Open-Meteo 数据源src/weather/provider/open_meteo.rs实时天气 API 对接配置解析src/config.rsTOML 配置加载命令行参数src/cli.rs--simulate等参数定义Docker 构建Dockerfile多阶段构建 scratch 运行时Linux 打包scripts/package-linux.shnfpm 生成 deb/rpm 包Nix 配置flake.nix、nix/hm-module.nixflake 与 home-manager 模块✅ 小结weathr 把「查天气」变成了「看天气」实时数据驱动 ASCII 动画8 种安装方式覆盖 macOS、Linux、Windows 与容器环境。推荐路径新手走一键脚本或平台包管理器极客玩 Nix / 源码编译求稳上 Docker。装好后敲一句weathr --simulate thunderstorm让终端替你打一场雷暴吧 ⚡【免费下载链接】weathra terminal weather app with ascii animation项目地址: https://gitcode.com/gh_mirrors/wea/weathr创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考