FeedSense

Dieses Projekt ist ein moderner RSS-Reader mit Web-Oberfläche, der RSS-Feeds abruft und im Browser anzeigt.

Funktionen

• RSS-Feeds per URL abrufen
• Automatische Zusammenfassung der Feed-Inhalte
• Einfache, moderne Web-Oberfläche (Flask-basiert)

Favoritenfunktion

Du kannst beliebig viele RSS-Quellen als Favoriten speichern und bequem zwischen ihnen wechseln:

• Über das Dropdown-Menü (Desktop) oder das Menü (Smartphone) kannst du gespeicherte Favoriten direkt auswählen und laden.
• Mit dem Stern-Button neben dem URL-Feld kannst du die aktuelle Feed-URL als Favorit speichern oder wieder entfernen.
• Die Favoriten werden dauerhaft in der Datei favorites.json gespeichert.
• Die Favoritenfunktion benötigt keine zusätzlichen Python-Module.

Hinweis: Die Anzahl der gespeicherten Favoriten ist nicht begrenzt. Auf schwächeren Systemen (z.B. Raspberry Pi) empfiehlt es sich jedoch, die Zahl der Favoriten moderat zu halten, da alle Favoriten-Feeds regelmäßig im Hintergrund aktualisiert werden. Viele parallele Feeds können die Systemleistung beeinflussen.

Tipp: Die Favoriten sind sofort nach dem Hinzufügen/Entfernen im Dropdown-Menü verfügbar.

Mobile Optimierung

• Das Layout passt sich automatisch an Smartphones und Tablets an (responsive Design).
• Buttons und Eingabefelder sind auf Touch-Bedienung optimiert.
• Die Darstellung ist kompakter und moderner auf kleinen Bildschirmen.
• Ein Floating-Button zum schnellen Scrollen erscheint auf Mobilgeräten.
• Die App erkennt mobile Geräte automatisch (User-Agent) und kann das Verhalten weiter anpassen.

Tipp: Die App kann als Web-App zum Home-Bildschirm hinzugefügt werden und zeigt dann ein schönes RSS-Icon.

Neue Features (2025)

• Menü-Button: Immer ganz oben rechts fixiert, auch auf Smartphones.
• Startbild: Das Hintergrundbild wird auf der Startseite vollflächig und responsiv angezeigt.
• Favoriten-Feeds: Werden alle 15 Minuten automatisch im Hintergrund aktualisiert und in der SQLite-Datenbank gespeichert. Dadurch sind die Feeds beim Öffnen sofort aktuell und das Laden geht blitzschnell.

Neues UI-Layout (2025)

• Favoriten-Auswahl: Links oben befindet sich jetzt ein Favoriten-Dropdown mit einem goldenen Stern-Icon (★) als Hinweis. So ist sofort klar, dass es sich um die Favoriten handelt.
• Feed-Adresse: Rechts daneben befindet sich das Eingabefeld für die Feed-Adresse sowie der "Laden"-Button. Die Adresse kann unabhängig von den Favoriten eingegeben werden.
• Menü-Button: Der Hamburger-Menü-Button ist immer oben rechts sichtbar – auf Desktop und Mobilgeräten.
• Vereinfachte Bedienung: Die Buttons "Feed laden" und "Favorisieren" im Desktop-Formular wurden entfernt. Die Bedienung erfolgt jetzt über das neue, aufgeräumte Layout.
• Responsives Design: Auf Mobilgeräten werden Favoriten-Auswahl und Feed-Eingabe automatisch untereinander dargestellt.

Hinweis zu Updates und Cache (PWA/Startseite)

Wenn nach einem Update die Startseite oder die PWA ("Zum Startbildschirm hinzufügen") nicht korrekt angezeigt wird, liegt das meist am Browser- oder App-Cache. In diesem Fall:

• Die App/Seite im Browser komplett schließen (auch aus dem App-Switcher entfernen).
• In den Browser-Einstellungen unter "Website-Daten" oder "App-Daten" die gespeicherte PWA/Seite löschen.
• Danach die Seite neu öffnen – jetzt wird alles frisch geladen.

Durch die eingebauten Cache-Busting-Parameter an CSS und Manifest werden neue Versionen normalerweise sofort geladen. Bei PWAs kann es trotzdem nötig sein, die App-Daten einmalig zu löschen.

Installation und Betrieb auf einem Server (z.B. Raspberry Pi)

Voraussetzungen

• Python 3 muss installiert sein (bei Raspberry Pi OS meist schon vorhanden)
• Git ist installiert (sudo apt install git)
• Optional: Virtuelle Umgebung (empfohlen)

Schritt-für-Schritt-Anleitung

1. Repository klonen

   git clone https://github.com/ElectronicResearch/RSS-Reader.git
   cd RSS-Reader

2. Virtuelle Umgebung erstellen und aktivieren

   python3 -m venv venv
   source venv/bin/activate

3. Abhängigkeiten installieren

   pip install -r requirements.txt

4. Flask-App für Netzwerkzugriff starten Passe die letzte Zeile in app.py an (falls nicht schon geschehen):

   if __name__ == '__main__':
       app.run(host='0.0.0.0', port=5000, debug=True)

   Starte die App:

   python app.py

   Jetzt ist die App im gesamten Netzwerk unter http://<SERVER-IP>:5000 erreichbar.

5. Zugriff im Netzwerk

   • Öffne im Browser eines anderen Geräts im selben Netzwerk:
     http://<SERVER-IP>:5000
   • <SERVER-IP> ist die IP-Adresse deines Raspberry Pi oder Servers (z.B. 192.168.1.100).

6. (Optional) Firewall anpassen

   sudo ufw allow 5000

7. (Optional) Produktionsbetrieb mit Gunicorn

   pip install gunicorn
   gunicorn -w 4 -b 0.0.0.0:5000 app:app

   Für den Einsatz im Internet empfiehlt sich zusätzlich ein Reverse Proxy wie nginx.

---

Damit kannst du den RSS-Reader einfach im lokalen Netzwerk oder – mit weiteren Schritten – auch im Internet bereitstellen.

Automatischer Start beim Systemneustart (z.B. Raspberry Pi)

Um den RSS-Reader automatisch beim Hochfahren des Systems zu starten, empfiehlt sich ein systemd-Service.

Beispiel: systemd-Service einrichten

1. Service-Datei erstellen Erstelle die Datei /etc/systemd/system/rssreader.service mit folgendem Inhalt (Pfad ggf. anpassen!):

   [Unit]
   Description=RSS Reader Flask App
   After=network.target
   
   [Service]
   User=pi
   WorkingDirectory=/home/pi/RSS-Reader
   ExecStart=/home/pi/RSS-Reader/venv/bin/python app.py
   Restart=always
   Environment=PYTHONUNBUFFERED=1
   
   [Install]
   WantedBy=multi-user.target

   Hinweis: Passe User und WorkingDirectory ggf. an deinen Benutzernamen und Installationspfad an!

2. Service aktivieren und starten

   sudo systemctl daemon-reload
   sudo systemctl enable rssreader.service
   sudo systemctl start rssreader.service

3. Status prüfen

   sudo systemctl status rssreader.service

Jetzt startet der RSS-Reader automatisch bei jedem Neustart des Raspberry Pi bzw. Servers.

Nutzung

1. Anwendung starten:

   python app.py

2. Im Browser öffnen: http://localhost:5000
3. RSS-Feed-URL eingeben und auf "Feed laden" klicken.

Beispiel-Feeds

• https://www.tagesschau.de/xml/rss2
• https://www.heise.de/rss/heise-atom.xml

Veröffentlichung auf GitHub

1. Repository initialisieren (falls noch nicht geschehen):

   git init
   git remote add origin https://github.com/<DEIN_USERNAME>/rss_reader.git

2. Änderungen committen und pushen:

   git add .
   git commit -m "Initialer RSS Reader Commit"
   git push -u origin master

Lizenz

MIT

© M. Koznjak 2025

Feed-Caching mit SQLite

FeedSense nutzt eine lokale SQLite-Datenbank, um RSS-Feeds und deren Einträge effizient zwischenzuspeichern:

• Beim Laden eines Feeds werden zuerst die letzten 2 Tage aus der Datenbank angezeigt.
• Neue Einträge werden automatisch ergänzt, alte (älter als 2 Tage) werden gelöscht.
• Das sorgt für deutlich schnellere Ladezeiten, weniger Datenverbrauch und eine bessere Nutzererfahrung – auch bei großen Feeds.
• Die Datenbankdatei heißt feedsense.db und wird automatisch im Projektverzeichnis angelegt.