RSSs-Widget for Übersicht

Übersicht Widget for displaying multiple RSS feeds on the desktop.


Still using the classic CoffeeScript widget format, as the AppleScript support is still broken on the React / JSX widgets.

---

"Übersicht lets you run system commands and display their output on your Mac desktop in little containers, called widgets."

---

Installation

1. Copy the RSSs.widget folder to the Übersicht widget folder.

2. Override the heading for RSS feeds through config.json (name property).

3. Override max number of items per feed or globally in config.json (default is 5).

4. Change styling and positioning in index.coffee.

5. Customize the feeds list by editing config.json

6. Customize list rendering through list.tmpl

   {
    "max_items": 5,
    "feeds": [
    {
        "name": "Boston Globe",
        "url": "http://www.bostonglobe.com/rss/feedly.xml",
        "max_items": 5},
    {
            "name": "BBC Top News",
        "url": "http://feeds.bbci.co.uk/news/rss.xml?edition=int"
    }, {
        "name": "The Verge",
        "url": "http://www.theverge.com/rss/frontpage"
    }]
   }
   

Render Template

feed.tmpl

 <h3>{{ .Title}}</h3>
 <ul>
 {{range .Items}}
  <li>
   <span>{{ .Title}}</span><a href='{{ .Link}}'>
   <i class='fa fa-solid fa-link'></i> </a>
  </li>
 {{end}}
 </ul>
</section>

Available gofeed Tags

Those can be used within the {{range .Items}} section.

gofeed.Item	RSS	Atom	JSON
Title	/rss/channel/item/title /rdf: RDF/item/title /rdf: RDF/item/dc:title /rss/channel/item/dc:title	/feed/entry/title	/items/title
Description	/rss/channel/item/description /rdf: RDF/item/description /rss/channel/item/dc:description /rdf: RDF/item/dc:description	/feed/entry/summary	/items/summary
Content	/rss/channel/item/content:encoded	/feed/entry/content	/items/content_html
Link	/rss/channel/item/link /rdf: RDF/item/link	/feed/entry/link[@rel=”alternate”]/@href /feed/entry/link[not(@rel)]/@href	/items/url
Updated	/rss/channel/item/dc:date /rdf: RDF/rdf:item/dc:date	/feed/entry/modified /feed/entry/updated	/items/date_modified
Published	/rss/channel/item/pubDate /rss/channel/item/dc:date	/feed/entry/published /feed/entry/issued	/items/date_published
Author	/rss/channel/item/author /rss/channel/item/dc:author /rdf: RDF/item/dc:author /rss/channel/item/dc:creator /rdf: RDF/item/dc:creator /rss/channel/item/itunes:author	/feed/entry/author	/items/author/name
Authors	/rss/channel/item/author /rss/channel/item/dc:author /rdf: RDF/item/dc:author /rss/channel/item/dc:creator /rdf: RDF/item/dc:creator /rss/channel/item/itunes:author	/feed/entry/authors[0]	/items/authors /items/author/name
GUID	/rss/channel/item/guid	/feed/entry/id	/items/id
Image	/rss/channel/item/itunes:image /rss/channel/item/media:image		/items/image /items/banner_image
Categories	/rss/channel/item/category /rss/channel/item/dc:subject /rss/channel/item/itunes:keywords /rdf: RDF/channel/item/dc:subject	/feed/entry/category	/items/tags
Enclosures	/rss/channel/item/enclosure	/feed/entry/link[@rel=”enclosure”]	/items/attachments

Added a noescape function to templates, that prevents escaping of HTML.

{{ .Content|noescape}}

Changelog

10.01.2023 - Alex

• Updated styles
• Updated and cleaned up the Go feed render script
• Moved feed rendering to a template for easy tweaking
• Moved to Font-Awesome 6 Free
• Documentation update
• Add noescape function for HTML

23.03.2017 - Erik

• Initial Release