2024-10-03 14:27:37 +00:00
|
|
|
# [yr]
|
2024-09-24 18:38:24 +00:00
|
|
|
|
2024-10-03 14:13:14 +00:00
|
|
|
Get the weather delivered to your command-line.
|
|
|
|
|
|
2024-10-03 14:27:37 +00:00
|
|
|
The project uses [Meteorologisk institutt]'s public API, [`LocationForecast`],
|
|
|
|
|
and [OpenStreetMap]'s [Nominatim] API.
|
|
|
|
|
|
2024-10-03 14:13:14 +00:00
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# Get help
|
|
|
|
|
yr --help
|
|
|
|
|
|
|
|
|
|
# Current forecast for location
|
|
|
|
|
yr now bergen
|
|
|
|
|
|
|
|
|
|
# Or with a space
|
|
|
|
|
yr now "new york"
|
|
|
|
|
|
|
|
|
|
# Forecast for multiple hours
|
|
|
|
|
yr forecast "new york"
|
|
|
|
|
|
|
|
|
|
# Forecast for next 5 hours
|
|
|
|
|
yr forecast "new york" -i 5
|
|
|
|
|
|
|
|
|
|
# Open forecast in your web browser
|
|
|
|
|
yr forecast "new york" --web
|
|
|
|
|
|
|
|
|
|
# Open now in your web browser
|
|
|
|
|
yr now "new york" --web
|
|
|
|
|
```
|
2024-10-03 14:27:37 +00:00
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
|
|
|
|
Anyone can contribute to [yr]. Please refer to the [contribution guidelines].
|
|
|
|
|
|
|
|
|
|
Send patches to the [mailing list], report bugs on the [issue tracker].
|
|
|
|
|
|
|
|
|
|
[yr]: https://sr.ht/~timharek/yr/
|
|
|
|
|
[Meteorologisk institutt]: https://www.met.no/
|
|
|
|
|
[`LocationForecast`]: https://api.met.no/weatherapi/locationforecast/2.0/documentation
|
|
|
|
|
[OpenStreetMap]: https://www.openstreetmap.org/
|
|
|
|
|
[Nominatim]: https://nominatim.org/
|
|
|
|
|
[mailing list]: https://lists.sr.ht/~timharek/yr
|
|
|
|
|
[issue tracker]: https://todo.sr.ht/~timharek/yr
|
|
|
|
|
[contribution guidelines]: ./CONTRIBUTING.md
|
