{"id":37141875,"url":"https://github.com/nilic/weatherman","last_synced_at":"2026-01-14T16:39:04.936Z","repository":{"id":65197664,"uuid":"534397165","full_name":"nilic/weatherman","owner":"nilic","description":"CLI tool for retrieving OpenWeather weather and pollution information ","archived":false,"fork":false,"pushed_at":"2023-08-22T19:30:36.000Z","size":49,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-06-21T14:04:43.285Z","etag":null,"topics":["cli","go","golang","openweather","openweather-api","openweathermap","openweathermap-api","pollution","weather","weather-forecast"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nilic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"nilic","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2022-09-08T21:20:37.000Z","updated_at":"2022-09-09T08:00:45.000Z","dependencies_parsed_at":"2023-12-15T21:17:42.341Z","dependency_job_id":"1e587e80-7bd6-4893-85d6-f1e9d6ec85ca","html_url":"https://github.com/nilic/weatherman","commit_stats":{"total_commits":24,"total_committers":1,"mean_commits":24.0,"dds":0.0,"last_synced_commit":"706bba1e2e4254757277f069f4034c3c048d61c9"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/nilic/weatherman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilic%2Fweatherman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilic%2Fweatherman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilic%2Fweatherman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilic%2Fweatherman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nilic","download_url":"https://codeload.github.com/nilic/weatherman/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilic%2Fweatherman/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28426119,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T16:32:27.303Z","status":"ssl_error","status_checked_at":"2026-01-14T16:28:36.419Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","go","golang","openweather","openweather-api","openweathermap","openweathermap-api","pollution","weather","weather-forecast"],"created_at":"2026-01-14T16:39:04.435Z","updated_at":"2026-01-14T16:39:04.930Z","avatar_url":"https://github.com/nilic.png","language":"Go","funding_links":["https://ko-fi.com/nilic"],"categories":[],"sub_categories":[],"readme":"## ☀️ weatherman - OpenWeather CLI ☀️\r\nweatherman is a CLI tool that can retrieve [OpenWeather](https://openweathermap.org/) data such as current weather, forecast and pollution information for a given location and display it in a human-readable format.\r\n\r\n## Getting started\r\n\r\n1. Download weatherman from the [Releases](https://github.com/nilic/weatherman/releases) page\r\n2. Register on the [OpenWeather](https://openweathermap.org/) site and get a free API key\r\n3. Save the API key to weatherman configuration by running `weatherman key save \u003cyour_API_key\u003e`\r\n\r\nNow you can start using weatherman! \r\n\r\n## Usage\r\n\r\n```\r\nUsage:\r\n  weatherman [command]\r\n\r\nAvailable Commands:\r\n  completion  Generate the autocompletion script for the specified shell\r\n  country     Commands for managing default country configuration\r\n  current     Retrieve current weather conditions for a given location\r\n  forecast    Retrieve 5-day weather forecast for a given location\r\n  help        Help about any command\r\n  key         Commands for managing OpenWeather API key\r\n  location    Commands for managing default location configuration\r\n  pollution   Retrieve pollution information for a given location\r\n  version     Returns the current version of weatherman\r\n\r\nFlags:\r\n  -h, --help   help for weatherman\r\n```\r\n\r\n### Get current weather\r\n\r\n```\r\n$ weatherman current Paris,FR\r\n\r\nLocation: Palais-Royal (FR)\r\nCurrent temperature: 17°C\r\nFeels like: 17°C\r\nWeather conditions: scattered clouds\r\nWind speed: 3 m/s\r\nPressure: 1009 mbar\r\nHumidity: 84%\r\nSunrise: 07:17\r\nSunset: 20:20\r\n```\r\n\r\n### Get 5-day weather forecast\r\n\r\n```\r\n$ weatherman forecast \"New York,US\"\r\n\r\nLocation: New York (US)\r\n+------------------+-------------+------------------+------------+-------------------------+\r\n|    LOCAL TIME    | TEMPERATURE |    CONDITIONS    | WIND SPEED | CHANCE OF PRECIPITATION |\r\n+------------------+-------------+------------------+------------+-------------------------+\r\n| 08.09.2022 17:00 | 25°C        | scattered clouds | 4 m/s      | 0%                      |\r\n| 08.09.2022 20:00 | 25°C        | few clouds       | 2 m/s      | 0%                      |\r\n| 08.09.2022 23:00 | 24°C        | clear sky        | 1 m/s      | 0%                      |\r\n| 09.09.2022 02:00 | 22°C        | clear sky        | 1 m/s      | 0%                      |\r\n| 09.09.2022 05:00 | 20°C        | clear sky        | 3 m/s      | 0%                      |\r\n| 09.09.2022 08:00 | 20°C        | clear sky        | 4 m/s      | 0%                      |\r\n| 09.09.2022 11:00 | 24°C        | clear sky        | 3 m/s      | 0%                      |\r\n| 09.09.2022 14:00 | 26°C        | clear sky        | 3 m/s      | 0%                      |\r\n| 09.09.2022 17:00 | 26°C        | clear sky        | 3 m/s      | 0%                      |\r\n| 09.09.2022 20:00 | 23°C        | clear sky        | 4 m/s      | 0%                      |\r\n| 09.09.2022 23:00 | 22°C        | clear sky        | 3 m/s      | 0%                      |\r\n| 10.09.2022 02:00 | 21°C        | clear sky        | 2 m/s      | 0%                      |\r\n| 10.09.2022 05:00 | 20°C        | clear sky        | 2 m/s      | 0%                      |\r\n| 10.09.2022 08:00 | 21°C        | clear sky        | 1 m/s      | 0%                      |\r\n| 10.09.2022 11:00 | 26°C        | clear sky        | 2 m/s      | 0%                      |\r\n| 10.09.2022 14:00 | 27°C        | few clouds       | 4 m/s      | 0%                      |\r\n| 10.09.2022 17:00 | 27°C        | overcast clouds  | 4 m/s      | 0%                      |\r\n| 10.09.2022 20:00 | 25°C        | overcast clouds  | 4 m/s      | 0%                      |\r\n| 10.09.2022 23:00 | 23°C        | overcast clouds  | 4 m/s      | 0%                      |\r\n| 11.09.2022 02:00 | 22°C        | overcast clouds  | 3 m/s      | 0%                      |\r\n| 11.09.2022 05:00 | 22°C        | overcast clouds  | 3 m/s      | 0%                      |\r\n| 11.09.2022 08:00 | 22°C        | overcast clouds  | 2 m/s      | 0%                      |\r\n| 11.09.2022 11:00 | 23°C        | overcast clouds  | 3 m/s      | 0%                      |\r\n| 11.09.2022 14:00 | 25°C        | overcast clouds  | 2 m/s      | 0%                      |\r\n| 11.09.2022 17:00 | 24°C        | overcast clouds  | 4 m/s      | 3%                      |\r\n| 11.09.2022 20:00 | 24°C        | light rain       | 2 m/s      | 24%                     |\r\n| 11.09.2022 23:00 | 23°C        | overcast clouds  | 3 m/s      | 26%                     |\r\n| 12.09.2022 02:00 | 22°C        | light rain       | 4 m/s      | 63%                     |\r\n| 12.09.2022 05:00 | 21°C        | moderate rain    | 4 m/s      | 100%                    |\r\n| 12.09.2022 08:00 | 22°C        | light rain       | 4 m/s      | 100%                    |\r\n| 12.09.2022 11:00 | 24°C        | light rain       | 4 m/s      | 46%                     |\r\n| 12.09.2022 14:00 | 27°C        | overcast clouds  | 2 m/s      | 42%                     |\r\n| 12.09.2022 17:00 | 27°C        | overcast clouds  | 0 m/s      | 22%                     |\r\n| 12.09.2022 20:00 | 26°C        | overcast clouds  | 1 m/s      | 22%                     |\r\n| 12.09.2022 23:00 | 24°C        | scattered clouds | 1 m/s      | 26%                     |\r\n| 13.09.2022 02:00 | 23°C        | light rain       | 0 m/s      | 27%                     |\r\n| 13.09.2022 05:00 | 23°C        | light rain       | 2 m/s      | 27%                     |\r\n| 13.09.2022 08:00 | 23°C        | light rain       | 1 m/s      | 74%                     |\r\n| 13.09.2022 11:00 | 25°C        | light rain       | 1 m/s      | 57%                     |\r\n| 13.09.2022 14:00 | 29°C        | light rain       | 1 m/s      | 54%                     |\r\n+------------------+-------------+------------------+------------+-------------------------+\r\n```\r\n\r\n### Get pollution information\r\n\r\n```\r\n$ weatherman pollution Belgrade,RS\r\n\r\nAir Quality Index (1/Good -\u003e 5/Very poor): 2 (Fair)\r\nConcentration of Carbon monoxide (CO): 233.65\r\nConcentration of Nitrogen monoxide (NO): 0\r\nConcentration of Nitrogen dioxide (NO2): 13.54\r\nConcentration of Ozone (O3): 39.34\r\nConcentration of Sulphur dioxide (SO2): 1.4\r\nConcentration of Fine particles matter (PM2.5): 11.02\r\nConcentration of Coarse particulate matter (PM10): 16.24\r\nConcentration of Ammonia (NH3): 4.43\r\n```\r\n\r\n## Specifying location\r\n\r\nWhen running `current`, `forecast` and `pollution` commands, a geographical location needs to be specified in format:\r\n\r\n`\u003ccity name\u003e,\u003ctwo-letter ISO 3166 country code\u003e`\r\n\r\neg. `Paris,FR` or `\"New York,US\"` (note the necessary quotes when city name includes one or more space characters). \r\n\r\nCommand `weatherman country list-iso-codes` can be used to display a list of all known countries along with their ISO 3166 codes.\r\n\r\n### Setting a default location\r\n\r\n`weatherman` allows for configuring a default location which will be used if no location is specified:\r\n\r\n```\r\n$ weatherman location set Chichester,GB\r\nSetting location to Chichester,GB\r\nDone!\r\n\r\n$ weatherman current\r\n\r\nLocation: Chichester (GB)\r\nCurrent temperature: 17°C\r\nFeels like: 17°C\r\nWeather conditions: broken clouds\r\nWind speed: 3 m/s\r\nPressure: 1002 mbar\r\nHumidity: 93%\r\nSunrise: 06:27\r\nSunset: 19:34\r\n```\r\n\r\nIf default location is not set, information for `Belgrade,RS` will be displayed when no location is supplied for the `current`, `forecast` or `pollution` commands. \r\n\r\n### Setting a default country\r\n\r\nSimilarly to default location, a default country can be set so that the country information can be omitted:\r\n\r\n```\r\n$ weatherman country set DE\r\nSetting country to Germany\r\nDone!\r\n\r\n$ weatherman current Berlin\r\n\r\nLocation: Alt-Kölln (DE)\r\nCurrent temperature: 16°C\r\nFeels like: 16°C\r\nWeather conditions: few clouds\r\nWind speed: 4 m/s\r\nPressure: 1006 mbar\r\nHumidity: 94%\r\nSunrise: 06:28\r\nSunset: 19:40\r\n\r\n$ weatherman current Hamburg\r\n\r\nLocation: Hamburg (DE)\r\nCurrent temperature: 14°C\r\nFeels like: 14°C\r\nWeather conditions: fog\r\nWind speed: 2 m/s\r\nPressure: 1007 mbar\r\nHumidity: 98%\r\nSunrise: 06:41\r\nSunset: 19:54\r\n```\r\nIf default country is not set, Serbia (`RS`) is presumed.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnilic%2Fweatherman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnilic%2Fweatherman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnilic%2Fweatherman/lists"}