# django-rss-filter
This is a Django app that creates filtered RSS feeds. It does this by filtering existing RSS feeds, removing articles that match filtered words and/or filtered categories. It's what powers https://www.rssfilter.com.
It comes with one view that returns the filtered feed XML, as well as Django Admin configuration to make it possible and easy to self-host your own instance of django-rss-filter. It does not come with views to create or edit filtered feeds; this can be done using the Django Admin.
## Getting started
All instructions use [uv](https://docs.astral.sh/uv/), but should work just as well with pip or Poetry for example.
In an existing Django project:
1. Install: `uv add django-rss-filter`
2. Add `rssfilter` to `INSTALLED_APPS`
3. `uv run ./manage.py migrate`
4. Include the URL config: `path("", include("rssfilter.urls"))`
If you don't have a Django project yet, these are the steps to get started:
1. `uv init my-django-project`
2. `cd my-django-project`
3. `uv add django`
4. `uv run django-admin startproject my_django_app .`
5. `uv run ./manage.py migrate`
6. `uv run ./manage.py createsuperuser`
7. `uv run ./manage.py runserver`
This will get you up and running with a working Admin site at http://127.0.0.1:8000/admin/.
Then follow the first four steps to add django-rss-filter to your Django project.
## Example project
There's an example Django project using django-rss-filter under `example/`.
1. `cd example`
2. `uv run ./manage.py migrate`
3. `uv run ./manage.py createsuperuser`
4. `uv run ./manage.py runserver`
You can then go to http://127.0.0.1:8000/admin/ to create a feed, which you can then access at http://127.0.0.1:8000/[feed_uuid]/.
## Settings
There is one setting that can be configured: `RSS_FILTER_CACHE_SECONDS`. The default value is 300 (5 minutes).
This setting controls how long a feed will be cached before it's fetched, filtered, and stored again.
## Tests
Unit tests can be run with `uv run pytest`.
## About Feature Requests
This project is feature-complete — it does what I needed it to do, and I’m not actively looking to expand its functionality.
I’m not accepting feature requests via issues. Please understand that asking for new features is essentially asking for free work — not just to build something, but to maintain it over time. And since I don’t personally need those features, I’m unlikely to invest time in them.
If you’d like to add a new feature, you’re welcome to open a pull request. Just know that I’ll evaluate it carefully, because even merged contributions become part of what I maintain. To avoid spending time on a PR that may not be accepted, I recommend starting a discussion first — that way we can talk through the idea and see if it fits.
This approach helps me avoid burnout and keep the project sustainable. Thanks for understanding!
Raw data
{
"_id": null,
"home_page": null,
"name": "django-rss-filter",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "rss, atom, feed, filter, mute, django",
"author": "Kevin Renskers",
"author_email": "Kevin Renskers <kevin@loopwerk.io>",
"download_url": "https://files.pythonhosted.org/packages/90/db/d164c23f5a68321ac1a0925c6eafc93b1cd63da7ca84fa81477e1951f494/django_rss_filter-0.13.0.tar.gz",
"platform": null,
"description": "# django-rss-filter\n\nThis is a Django app that creates filtered RSS feeds. It does this by filtering existing RSS feeds, removing articles that match filtered words and/or filtered categories. It's what powers https://www.rssfilter.com.\n\nIt comes with one view that returns the filtered feed XML, as well as Django Admin configuration to make it possible and easy to self-host your own instance of django-rss-filter. It does not come with views to create or edit filtered feeds; this can be done using the Django Admin.\n\n## Getting started\n\nAll instructions use [uv](https://docs.astral.sh/uv/), but should work just as well with pip or Poetry for example.\n\nIn an existing Django project:\n\n1. Install: `uv add django-rss-filter`\n2. Add `rssfilter` to `INSTALLED_APPS`\n3. `uv run ./manage.py migrate`\n4. Include the URL config: `path(\"\", include(\"rssfilter.urls\"))`\n\nIf you don't have a Django project yet, these are the steps to get started:\n\n1. `uv init my-django-project`\n2. `cd my-django-project`\n3. `uv add django`\n4. `uv run django-admin startproject my_django_app .`\n5. `uv run ./manage.py migrate`\n6. `uv run ./manage.py createsuperuser`\n7. `uv run ./manage.py runserver`\n\nThis will get you up and running with a working Admin site at http://127.0.0.1:8000/admin/.\n\nThen follow the first four steps to add django-rss-filter to your Django project.\n\n## Example project\n\nThere's an example Django project using django-rss-filter under `example/`.\n\n1. `cd example`\n2. `uv run ./manage.py migrate`\n3. `uv run ./manage.py createsuperuser`\n4. `uv run ./manage.py runserver`\n\nYou can then go to http://127.0.0.1:8000/admin/ to create a feed, which you can then access at http://127.0.0.1:8000/[feed_uuid]/.\n\n## Settings\n\nThere is one setting that can be configured: `RSS_FILTER_CACHE_SECONDS`. The default value is 300 (5 minutes).\n\nThis setting controls how long a feed will be cached before it's fetched, filtered, and stored again.\n\n## Tests\n\nUnit tests can be run with `uv run pytest`.\n\n## About Feature Requests\n\nThis project is feature-complete \u2014 it does what I needed it to do, and I\u2019m not actively looking to expand its functionality.\n\nI\u2019m not accepting feature requests via issues. Please understand that asking for new features is essentially asking for free work \u2014 not just to build something, but to maintain it over time. And since I don\u2019t personally need those features, I\u2019m unlikely to invest time in them.\n\nIf you\u2019d like to add a new feature, you\u2019re welcome to open a pull request. Just know that I\u2019ll evaluate it carefully, because even merged contributions become part of what I maintain. To avoid spending time on a PR that may not be accepted, I recommend starting a discussion first \u2014 that way we can talk through the idea and see if it fits.\n\nThis approach helps me avoid burnout and keep the project sustainable. Thanks for understanding!\n",
"bugtrack_url": null,
"license": null,
"summary": "Filter public RSS feeds, remove articles that contain certain keywords or categories.",
"version": "0.13.0",
"project_urls": {
"Homepage": "https://github.com/loopwerk/django-rss-filter/",
"Issues": "https://github.com/loopwerk/django-rss-filter/issues",
"Repository": "https://github.com/loopwerk/django-rss-filter.git"
},
"split_keywords": [
"rss",
" atom",
" feed",
" filter",
" mute",
" django"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "10b6b39148f6ab562fce64afabcdfea59ba4c43be363a02e217946ef8effa148",
"md5": "e9cb503c6c02ac6631b1527ea79e8150",
"sha256": "dbd69f4f5d27642012f0955eff303c44db7ac1a3b40c8da2013a492132b53be4"
},
"downloads": -1,
"filename": "django_rss_filter-0.13.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e9cb503c6c02ac6631b1527ea79e8150",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 9361,
"upload_time": "2025-07-12T15:28:19",
"upload_time_iso_8601": "2025-07-12T15:28:19.855182Z",
"url": "https://files.pythonhosted.org/packages/10/b6/b39148f6ab562fce64afabcdfea59ba4c43be363a02e217946ef8effa148/django_rss_filter-0.13.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "90dbd164c23f5a68321ac1a0925c6eafc93b1cd63da7ca84fa81477e1951f494",
"md5": "9a4bf1e8f1cf214fb117247331fca7bd",
"sha256": "2d11bf6d6d7150cdc5f1a3386252cc74b5b8e1979dd26cbc489c23d97f24c277"
},
"downloads": -1,
"filename": "django_rss_filter-0.13.0.tar.gz",
"has_sig": false,
"md5_digest": "9a4bf1e8f1cf214fb117247331fca7bd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 6566,
"upload_time": "2025-07-12T15:28:20",
"upload_time_iso_8601": "2025-07-12T15:28:20.943320Z",
"url": "https://files.pythonhosted.org/packages/90/db/d164c23f5a68321ac1a0925c6eafc93b1cd63da7ca84fa81477e1951f494/django_rss_filter-0.13.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-12 15:28:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "loopwerk",
"github_project": "django-rss-filter",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "django-rss-filter"
}
JSON
