rssrender
Render RSS feeds for terminal display with customizable Jinja2 templates.
Features
- Parse RSS feeds and render them for terminal output
- Filter entries by age (only show recent entries)
- Customizable output using Jinja2 templates
- HTML to plain text conversion with formatting preservation
- Content length limiting
- Optional link hiding
Installation
pip install rssrender
Or install from source:
git clone git@github.com:berkeley-stat/rssrender.git
cd rssrender
pip install -e .
Usage
rssrender --feed-url <RSS_FEED_URL> [--template <TEMPLATE_PATH>]
Options
--feed-url(required): RSS feed URL--template: Path to Jinja2 template file (default: included example template)--day-threshold: Number of days to consider an entry as recent (default: 30)--max-body-length: Maximum length of the body content (default: 400)--hide-http-link: If set, the HTTP link will not be displayed in the output
Example
# Use the default template
rssrender --feed-url https://example.com/feed.xml
# Use a custom template and filter by last 7 days
rssrender --feed-url https://example.com/feed.xml --template ./my-template.j2 --day-threshold 7
Template Format
Templates use Jinja2 syntax and have access to:
description: Feed description (if available)entries: List of entries with the following fields:date: Publication date (YYYY-MM-DD format)title: Entry titlelink: Entry URL (if not hidden)content: Entry content (HTML converted to plain text)
Custom Filters
Two custom filters are available in templates:
wrap(width, subsequent_indent, indent_all): Wrap text to specified widthindent(width, first): Indent lines by specified number of spaces
See the included example template for reference.
Use Cases
- Generate MOTD (Message of the Day) from RSS feeds
- Display news feeds in terminal dashboards
- Create plain text digests from blogs
- Any terminal-based RSS feed display
License
BSD 3-Clause License - See LICENSE file for details.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
rssrender-0.1.0.tar.gz
(7.3 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rssrender-0.1.0.tar.gz.
File metadata
- Download URL: rssrender-0.1.0.tar.gz
- Upload date:
- Size: 7.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
190d66ca136d92c9595c64696d08717fb75179e607922ece3fa3f87d638d4603
|
|
| MD5 |
dca0ec09f31da70489f58c59228dc37d
|
|
| BLAKE2b-256 |
89b206ad500d871f3f9b222642ca60313ff05d94dfd35828d6fd1624614325a7
|
Provenance
The following attestation bundles were made for rssrender-0.1.0.tar.gz:
Publisher:
publish.yml on berkeley-stat/rssrender
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
rssrender-0.1.0.tar.gz -
Subject digest:
190d66ca136d92c9595c64696d08717fb75179e607922ece3fa3f87d638d4603 - Sigstore transparency entry: 756082508
- Sigstore integration time:
-
Permalink:
berkeley-stat/rssrender@eaebc7c7daeb34aea9691d5a2beec49d11588cb8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/berkeley-stat
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@eaebc7c7daeb34aea9691d5a2beec49d11588cb8 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file rssrender-0.1.0-py3-none-any.whl.
File metadata
- Download URL: rssrender-0.1.0-py3-none-any.whl
- Upload date:
- Size: 8.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
daaebad824e93705467e7948e701736589514dff240ba4f4def5d8caa6eb776f
|
|
| MD5 |
330736b7b767e87d570cdf9a6510cbeb
|
|
| BLAKE2b-256 |
a53ee93789bf14fa6b01441e910ce3f6ae5750e91bb58af08ccec8739cf8ee0f
|
Provenance
The following attestation bundles were made for rssrender-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on berkeley-stat/rssrender
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
rssrender-0.1.0-py3-none-any.whl -
Subject digest:
daaebad824e93705467e7948e701736589514dff240ba4f4def5d8caa6eb776f - Sigstore transparency entry: 756082530
- Sigstore integration time:
-
Permalink:
berkeley-stat/rssrender@eaebc7c7daeb34aea9691d5a2beec49d11588cb8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/berkeley-stat
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@eaebc7c7daeb34aea9691d5a2beec49d11588cb8 -
Trigger Event:
workflow_dispatch
-
Statement type:
