---
id: georss-client
version: "2026.6.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# georss-client — A GeoRSS client library.

License: permissive · Maintenance: active · Downloads: 104.9K/mo

## What it is and what it does

This is a base framework for building GeoRSS feed clients—libraries that fetch and parse geographic event feeds from sources like earthquake monitors and bushfire alerts. It handles the common plumbing: fetching feeds via HTTP, parsing GeoRSS XML, extracting location and event data, and managing feed state across updates. The package itself is not a complete client; instead, you use it to build concrete clients for specific feeds (several examples are listed in the documentation, covering earthquakes, fires, and generic GeoRSS sources).

The framework provides a feed manager that tracks which entries are new, updated, or removed between successive feed fetches, returning status codes to indicate success or failure. This is useful for applications like Home Assistant that need to monitor multiple geographic event feeds and react to changes. You instantiate a concrete implementation, call update() to fetch the latest feed, and receive a tuple of status and entry data; the feed manager handles the bookkeeping of what changed since the last update.

Use it for:

- Build a Home Assistant integration that monitors earthquake feeds from multiple regional sources.
- Track bushfire alerts from government GeoRSS feeds and notify users of events near their location.
- Aggregate generic GeoRSS feeds from multiple providers and deduplicate entries based on external IDs.
- Implement a location-aware alert system that filters feed entries by geographic proximity using haversine distance.
- Monitor feed updates over time and detect when entries are removed or updated between polling cycles.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A framework for building client libraries that fetch and parse GeoRSS feeds, extracting geographic event data and managing feed updates over time.

Yes, if you are building a GeoRSS-based client or Home Assistant integration. The framework is actively maintained, has low install friction, carries a permissive license, and solves a specific problem well—managing feed state and change detection. Install only if you need to consume GeoRSS feeds; this is not a standalone tool but a library for developers.

## Install

pip install georss-client
uv add georss-client
poetry add georss-client

## Installing georss-client

Before you install: Low friction installation with four common dependencies (haversine, xmltodict, requests, python-dateutil). Active maintenance as of late July 2026 with recent release history since 2018.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most integration scenarios.

Quickstart:

pip install georss-client

from georss_client import GeoRSSClient

client = GeoRSSClient()
status, entries = client.update()

Requires Python 3.11 or later; concrete implementations (e.g., for earthquakes or bushfires) are separate packages.

Verify before relying:

- Whether the framework includes built-in feed manager state persistence or if that must be implemented by the consumer.
- Performance characteristics when handling feeds with large numbers of entries or frequent updates.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 104.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

georss feed client library, geographic rss parser, location-based feed updates, earthquake fire alert feeds, geospacial event tracking, feed manager with change detection, homeassistant georss integration, georss, feed-management, homeassistant

[View on SkillFed](https://skillfed.io/packages/georss-client) · [View on PyPI](https://pypi.org/project/georss-client/)