linecast

Terminal weather, solar arc, and tide visualizations. Pure Python, zero dependencies.

All data comes from free public APIs with no keys required.

Commands

weather — Current conditions, hourly braille temperature curve, 7-day forecast with color range bars, precipitation sparkline, natural language comparisons, and weather alerts for 36 countries. Available in 16 languages.

sunshine — Solar arc inspired by the Apple Watch Solar Graph face. Shows the sun's position on its daily arc with sky color gradients, day length with daily delta, and moon phase.

tides — NOAA tide predictions rendered as a sunlight-shaded braille chart with scrollable multi-day window, current water level, high/low extremes with timestamps, and mouse hover tooltips.

All three launch in full-screen live mode by default when run in a terminal (auto-refreshing, with keyboard navigation). Use --print for a single static snapshot printed to stdout. When piped, --print behavior is automatic.

Install

pip install linecast

Or with a Homebrew tap:

brew tap ashuttl/linecast
brew install linecast

Usage

weather                          # current location via IP geolocation
weather --location "new york"    # search by place name (uses top result)
weather --location 44.54,-68.42  # specific coordinates
weather --search québec          # find coordinates by city name
weather --metric                 # metric units (°C, km/h, mm)
weather --celsius                # celsius only (wind/precip stay imperial)
weather --metric --fahrenheit    # °F with km/h and mm
weather --lang fr                # UI in French (also covers alert text when available)
# other language codes: es, de, it, pt, nl, pl, no, sv, is, da, fi, ja, ko, zh
weather --print                  # single static snapshot (no live mode)
sunshine                         # solar arc (live by default)
sunshine --print                 # static snapshot
sunshine --classic-colors        # use fixed-color (theme agnostic) sunshine gradient/palette

tides                            # nearest NOAA station (live by default)
tides --station "Bar Harbor"     # search by station name (uses first match)
tides --station 8413320          # specific station ID
tides --search "Bar Harbor"      # find stations by name
tides --metric                   # heights in meters instead of feet
tides --lang fr                  # UI in French
tides --print                    # static snapshot

Language support

Use --lang or set LINECAST_LANG to switch the full UI into another language. This covers weather descriptions, day names, natural language comparisons, precipitation forecasts, and alert timing. Non-English languages also use 24-hour time.

Supported: English, French, Spanish, German, Italian, Portuguese, Dutch, Polish, Norwegian, Swedish, Icelandic, Danish, Finnish, Japanese, Korean, Chinese

All commands are also available under the linecast namespace if the short names conflict with other tools on your system:

linecast weather
linecast sunshine --print
linecast tides --station 8413320

Shell completion

Generate shell completion from the CLI:

# Bash
source <(linecast completion bash)

# Zsh
source <(linecast completion zsh)

# Fish
linecast completion fish | source

This installs completions for both linecast <command> and standalone weather, tides, and sunshine.

Weather alerts

Alerts are sourced automatically based on location from eight providers covering 36 countries:

• US — National Weather Service
• Canada — Environment and Climate Change Canada
• China — China Meteorological Administration
• Germany — Deutscher Wetterdienst (via BrightSky)
• Ireland — Met Éireann
• Japan — Japan Meteorological Agency
• Norway — MET Norway
• 29 European countries — MeteoAlarm (Austria, Belgium, Bulgaria, Croatia, Cyprus, Czechia, Denmark, Estonia, Finland, France, Greece, Hungary, Iceland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, UK)

Alert text comes from each national weather service in its native language. When available, alerts are served in your --lang preference.

Environment variables

Variable	Description
WEATHER_LOCATION	Default lat,lng for weather (e.g., 44.54,-68.42)
TIDE_STATION	Default NOAA station ID for tides (e.g., 8413320)
TIDES_UNITS	Set to metric for tide heights in meters (same as --metric)
LINECAST_LANG	UI language, including alerts when available: en, fr, es, de, it, pt, nl, pl, no, sv, is, da, fi, ja, ko, zh
WEATHER_UNITS	Set to metric for Celsius, km/h, and mm (same as --metric)
LINECAST_ICONS	Set to emoji to use standard emoji instead of Nerd Font icons
LINECAST_COLOR	Color mode: auto (default), truecolor, 256, 16, or none
LINECAST_THEME	Theme input mode: auto (default) to query terminal colors, or classic / legacy / off for pre-theme palette behavior
LINECAST_THEME_TIMEOUT_MS	OSC theme query timeout in milliseconds (default 100)
NO_COLOR	Any non-empty value disables ANSI colors (standard convention)

Requirements

• Python 3.10+
• A terminal with ANSI color support (truecolor looks best; weather remains usable in low/no color)
• A Nerd Font for best icon rendering (optional — use --emoji for standard emoji fallback)
• macOS or Linux (uses termios for live mode)

License

MIT