RSS Newsfeed Viewer (Flask)

Responsive RSS viewer that shows headlines slide-by-slide (latest 5 items), with a placeholder logo, feed title, and subtle background + slide animations.

Run locally

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python app.py

Open: http://127.0.0.1:5000

Optional: choose a different feed

http://127.0.0.1:5000/?url=https%3A%2F%2Fexample.com%2Frss.xml

Or set an env var:

set RSS_URL=https://example.com/rss.xml
python app.py

Optional: set a custom logo

By default a bundled placeholder logo is used. To override it:

set LOGO_URL=https://example.com/logo.png
python app.py

Run with Docker Compose

Edit docker-compose.yml and adjust:

• RSS_URL (RSS feed)
• LOGO_URL (logo image URL)

Then run:

docker compose up --build

Docker runs the app using Gunicorn (production WSGI server).

Open: http://127.0.0.1:5000

Release (git + docker)

There is a helper script that:

• updates release.py with the version
• commits + pushes to git using the version as the commit message
• builds + pushes Docker images tagged with the version (and optionally latest)

Example:

python release_tool.py v1.0.2 --image git.alphen.cloud/bramval/rssfeedviewer --also-latest

Dry run (prints commands only):

python release_tool.py v1.0.2 --dry-run

Controls

• Click/tap: next headline
• Left/right arrow keys: previous/next
• Space: pause/resume