explaingit

schachmat/wego

★ 8,457GoAudience · developerComplexity · 1/5Setup · easy

TLDR

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.

Mindmap

mindmap
  root((wego))
    What it shows
      Temperature
      Wind speed
      Precipitation
      Humidity
    Output formats
      Colored ASCII art
      Emoji display
      Markdown
      JSON
    Weather providers
      Open-Meteo free
      SMHI free
      OpenWeatherMap
      WeatherAPI
    Setup
      Go install
      Linux packages
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Check a 7-day weather forecast for any city from the terminal without opening a browser or app.

USE CASE 2

Set a default home location once, then get instant forecasts with a single command each day.

USE CASE 3

Pull forecast data in JSON format to feed into your own scripts or terminal dashboard.

Tech stack

Go

Getting it running

Difficulty · easy Time to first run · 5min

Some weather providers require a free API key, Open-Meteo and SMHI work with no sign-up.

In plain English

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".

Copy-paste prompts

Prompt 1
I want to set wego to show my city by default and use the Open-Meteo provider so I do not need an API key. How do I write the config file?
Prompt 2
How do I use wego to display a 4-day forecast for London in plain Markdown format instead of the colored ASCII art?
Prompt 3
I want to add wego output to my shell prompt so the current temperature shows every time I open a terminal. How do I pipe or embed the output?
Prompt 4
What config file options does wego support for controlling cache duration and switching between weather providers?
Open on GitHub → Explain another repo

← schachmat on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.