gitmyhub

wego

Go ★ 8.5k updated 18d ago

weather app for the terminal

Command-line tool that shows a colorful weather forecast for any location directly in your terminal, covering up to 7 days of temperature, wind, rain, and humidity.

Gosetup: easycomplexity 1/5

Wego is a command-line weather tool that displays weather forecasts directly in your terminal window. Instead of opening a browser or app, you type a command, and wego shows a formatted forecast for a location you specify. By default it uses colored ASCII art with icons to represent conditions, though you can also choose an emoji display, plain Markdown, or raw JSON output.

The forecast covers up to seven days and includes temperature (both measured and felt), wind speed and direction, visibility distance, precipitation amount and probability, and humidity. You set your default location once in a config file, then run wego from the terminal anytime to get the forecast. For a different city, you pass the location as an argument: for example, typing "wego 4 London" shows four days of forecast for London.

Wego can pull weather data from several different providers. Two of them, Open-Meteo and SMHI, are free and need no registration or API key. Others, like OpenWeatherMap, WeatherAPI, and PirateWeather, require a free sign-up to get an API key. The app caches weather data to disk so it does not make a new network request every time you run it. You can control how long cached data stays valid with a setting in the config file.

The program is written in Go and can be installed with a single Go install command. Most popular Linux distributions package it through their own repositories as well. A built-in manual page is available by running "wego --man".

Where it fits