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

# georss-generic-client — A GeoRSS generic client library.

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

## What it is and what it does

This library wraps GeoRSS feed consumption with location-aware filtering and state tracking. You instantiate a feed class with coordinates and optional filters (radius in kilometers, category names), call update() to fetch and parse the feed, and receive a status code plus a list of entries. The Feed Manager layer tracks changes across updates, reporting new entries, updates to existing ones, and removals—useful for applications that need to react incrementally to feed changes rather than reprocessing everything each time.

It's designed for scenarios where you're monitoring geographic events (alerts, incidents, weather) from remote feeds and want to filter by proximity and category without writing your own GeoRSS parser. The library handles the HTTP fetch, XML parsing, and state bookkeeping; you provide the feed URL and filter criteria.

Use it for:

- Monitor bushfire or emergency alerts within a specified radius of a home location.
- Track geographic event feeds (earthquakes, weather warnings) filtered by distance and category.
- Build a feed aggregator that detects and reports only new or changed entries since the last poll.
- Integrate location-based feed updates into a home automation or alerting system.
- Filter multi-category GeoRSS feeds to show only events matching specific criteria.

## Worth the install?

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

Provides generic access to GeoRSS feeds with location-based filtering and change tracking across feed updates.

Yes, if you need to consume GeoRSS feeds with location filtering. The library is actively maintained, has no known vulnerabilities, supports modern Python versions, and carries a permissive license. Install friction is low. The main unknown is the stability of its single runtime dependency; verify that georss_client itself meets your reliability requirements before committing.

## Install

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

## Installing georss-generic-client

Before you install: Low install friction with a single runtime dependency. Active maintenance with a recent release (48 days old) and commits through July 2026. Supports current Python versions (3.11–3.14).

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install georss-generic-client

from georss_generic_client import GenericFeed
feed = GenericFeed((-27.5, 153.0), filter_radius=200,
                   url="https://example.com/feed.xml")
status, entries = feed.update()

Requires Python 3.11 or later.

Verify before relying:

- Whether the single runtime dependency (georss_client) itself has stable maintenance and low friction.
- Performance characteristics when processing large feeds or frequent updates.
- Real-world reliability of the Feed Manager's change detection across different GeoRSS feed formats.

## Package facts

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

## Tags

georss feed client, location-based feed filtering, geographic rss parser, feed change tracking, georss feed manager, distance-based feed filtering, rss feed updates, georss, location-filtering, feed-management

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