[![Build Status](https://gitlab.gnome.org/GNOME/libgweather/badges/master/build.svg)](https://gitlab.gnome.org/GNOME/libgweather/pipelines)

libgweather
===========

Libgweather is a library to access weather information from online
services for numerous locations.

Documentation for the API is available online at:

  https://gnome.pages.gitlab.gnome.org/libgweather/

You may download updates to the package from:

  https://download.gnome.org/sources/libgweather/

To discuss libgweather, you may use the "gweather" tag in Discourse:

  https://discourse.gnome.org/tag/gweather

Dependencies
------------

Libgweather depends on the following projects:

- [gio-2.0](https://gitlab.gnome.org/GNOME/glib)
- [libsoup-3.0](https://gitlab.gnome.org/GNOME/libsoup)
- [libxml-2.0](https://gitlab.gnome.org/GNOME/libxml2)
- [geocode-glib-2.0](https://gitlab.gnome.org/GNOME/geocode-glib)
- [json-glib-1.0](https://gitlab.gnome.org/GNOME/json-glib)

Additionally, libgweather depends on the locations database provided by
[gweather-locations](https://gitlab.gnome.org/GNOME/gweather-locations).

How to report bugs
------------------

Bugs should be reported to the libgweather issues tracking system:

  https://gitlab.gnome.org/GNOME/libgweather/-/issues

Please read the GNOME Handbook on how to report an issue:

  https://handbook.gnome.org/issues/reporting.html

If you are interested in adding new locations (weather stations, or
cities), please refer to the libgweather documentation:

  https://gnome.pages.gitlab.gnome.org/libgweather/adding-locations.html

Please read the [contribution guide](./CONTRIBUTING.md) for information on
how to contribute to the project.

Licensing
---------

Libgweather is released under the terms of the GNU General Public License
version 2.0 or, at your option, any later version.
