diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index cc121fc..ce31f50 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -5,6 +5,8 @@ Your contributions are always welcome! ## Guidelines * Add one link per Pull Request. + * Make sure the PR title is in the format of `Add project-name`. + * Write down the reason why the library is awesome. * Add the link: `* [project-name](http://example.com/) - A short description ends with a period.` * Keep descriptions concise. * Add a section if needed. @@ -14,4 +16,3 @@ Your contributions are always welcome! * Don't mention `RSS` in the description as it's implied. * Check your spelling and grammar. * Remove any trailing whitespace. -* Send a Pull Request with the reason why the library is awesome. diff --git a/README.md b/README.md index c5fccc6..ddb36b8 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Awesome RSS [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome) -A curated list of awesome RSS/ATOM/Syndication links +A curated list of awesome ATOM/RSS/Syndication links. Inspired by [awesome-python](https://github.com/vinta/awesome-python). @@ -10,50 +10,61 @@ Inspired by [awesome-python](https://github.com/vinta/awesome-python). - [Readers](#readers) - [Syndication Formats](#syndication-formats) - - - - ## Syndication Formats -*Standards, or conventions for syndicating content* +*Standards, or conventions for syndicating content.* -* [ATOM](https://en.wikipedia.org/wiki/Atom_(standard)) - The Atom Syndication Format is an XML language used for web feeds -* [hFeed](http://microformats.org/wiki/h-feed) - h-feed is a microformat for marking up a stream or feed of posts, like complete posts on a home page or archive pages, or summaries or other brief lists of posts. -* [RSS](https://en.wikipedia.org/wiki/RSS) - Really Simple Syndication +* [ATOM](https://en.wikipedia.org/wiki/Atom_(standard)) - The Atom Syndication Format is an XML language used for web feeds. +* [h-feed](https://microformats.org/wiki/h-feed) - h-feed is a microformat for marking up a stream or feed of posts, like complete posts on a home page or archive pages, or summaries or other brief lists of posts. +* [RSS](https://en.wikipedia.org/wiki/RSS) - Really Simple Syndication. ## Hosted Readers *Tools to read feeds.* -* [Feed Wrangler](https://feedwrangler.net/welcome.html) - a modern, sustainable RSS reader. +* [BazQux](https://bazqux.com/) - Read news in one place. BazQux can also monitor social media pages like Facebook, Telegram and VK. * [Feedbin](https://feedbin.com/) - A fast, simple reader that delivers a great reading experience. -* [Feedly](http://feedly.com/) - The content you need to accelerate your research, marketing, and sales. -* [Inoreader](http://www.inoreader.com/) - The content reader for power users who want to save time. -* [NewsBlur](https://newsblur.com/) - NewsBlur is a personal news reader bringing people together to talk about the world +* [Feedly](https://feedly.com/) - The content you need to accelerate your research, marketing, and sales. +* [Inoreader](https://www.inoreader.com/) - The content reader for power users who want to save time. +* [NewsBlur](https://newsblur.com/) - NewsBlur is a personal news reader bringing people together to talk about the world. +* [The Old Reader](https://theoldreader.com/) - All your news frmo one place. Works on mobile, tablet, or desktop, giving you all the content you want, when you want it. +* [FeedLand](https://feedland.com) - A web service for managing lists of feeds, sharing them with others, and reading and sharing news. + +## Self-Hosted Readers -## Self-Hosted Readers -* [Fever](http://www.feedafever.com/) - Fever takes the temperature of your slice of the web and shows you what's hot. -* [Selfoss](https://selfoss.aditu.de/) - The new multipurpose rss reader, live stream, mashup, aggregation web application -* [TT-RSS](https://tt-rss.org/gitlab/fox/tt-rss/wikis/home) - Tiny Tiny RSS is an open source web-based news feed (RSS/Atom) reader and aggregator, designed to allow you to read news from any location, while feeling as close to a real desktop application as possible. +*Apps to host your service.* + +* [FeedHQ](https://github.com/feedhq/feedhq) - FeedHQ is a simple, lightweight web-based feed reader. +* [FreshRSS](https://freshrss.org/) - FreshRSS is a feed aggregator. It is lightweight, easy to work with, powerful, and customizable. +* [kriss_feed](https://github.com/tontof/kriss_feed) - A simple and smart (or stupid) feed reader. +* [Leed](https://github.com/LeedRSS/Leed) - Leed is a minimalist aggregator which offers fast consultation and non-intrusive features. +* [Liferea](https://lzone.de/liferea/) - Liferea brings together all of the content from your favorite subscriptions into a simple interface, similar to a desktop mail/news client, with an embedded web browser. +* [Miniflux](https://miniflux.app/) - Miniflux is a minimalist software. **It's purpose is to read feeds**. _Nothing else_. +* [Selfoss](https://selfoss.aditu.de/) - The new multipurpose rss reader, live stream, mashup, aggregation web application. +* [TT-RSS](https://tt-rss.org/) - Tiny Tiny RSS is an open source web-based news feed reader and aggregator, designed to allow you to read news from any location, while feeling as close to a real desktop application as possible. ## Apps -*Apps for reading feeds* +*Apps for reading feeds.* -* [minirss](https://github.com/132ikl/minirss) - A minuscule RSS notifier. Simply lets you know using your notification daemon when there's a new item and lets you navigate to it using your browser. -* [Reeder](http://reederapp.com/) - A news reader for Feedbin, Feedly, Feed Wrangler, FeedHQ, NewsBlur, The Old Reader, Inoreader, Minimal Reader, BazQux Reader, Fever, Readability and Instapaper. -* [Unread](http://supertop.co/unread/) - Rediscover the joy of reading your favorite writers with Unread. For iPhone or iPad. +* [minirss](https://github.com/132ikl/minirss) - A minuscule feed notifier. Simply lets you know using your notification daemon when there's a new item and lets you navigate to it using your browser. +* [NetNewsWire](https://netnewswire.com/) - NetNewsWire is a reader for Mac, iPhone, and iPad. +* [Newsboat](https://newsboat.org/) - Newsboat is a feed reader for the text console. It’s an actively maintained fork of Newsbeuter. +* [Reeder](https://reederapp.com/) - A news reader for Feedbin, Feedly, Feed Wrangler, FeedHQ, NewsBlur, The Old Reader, Inoreader, BazQux Reader, FreshRSS, Instapaper and Pocket. +* [Unread](https://www.goldenhillsoftware.com/unread/) - Unread supports syncing with Feedbin, Feedly, Fever-compatible, Inoreader, and NewsBlur accounts. It also has Local accounts. For iPhone or iPad. ## Libraries -*Various libraries for parsing, and producing feeds* - -* [feedparser](https://pypi.python.org/pypi/feedparser) - (Python) Universal feed parser, handles RSS 0.9x, RSS 1.0, RSS 2.0, CDF, Atom 0.3, and Atom 1.0 feeds -* [simplepie](http://simplepie.org/) - (PHP) SimplePie is a very fast and easy-to-use feed parser, written in PHP, that puts the 'simple' back into 'really simple syndication +*Various libraries for parsing, and producing feeds.* +* [feedparser](https://pypi.org/project/feedparser/) - (Python) Universal feed parser, handles RSS 0.9x and above, CDF, Atom 0.3 and above feeds. +* [simplepie](http://simplepie.org/) - (PHP) SimplePie is a very fast and easy-to-use feed parser, written in PHP, that puts the 'simple' back into 'really simple syndication. +* [gofeed](https://github.com/mmcdole/gofeed) - (Go) Gofeed a powerful and flexible library designed for parsing RSS, Atom, and JSON feeds across various formats and versions. # Contributing -Your contributions are always welcome! Please take a look at the [contribution guidelines](https://github.com/vinta/awesome-python/blob/master/CONTRIBUTING.md) first. +Your contributions are always welcome! Please take a look at the [contribution guidelines](CONTRIBUTING.md) first. -I will keep some pull requests open if I'm not sure whether those libraries are awesome, you could [vote for them](https://github.com/voidfiles/awesome-rss/pulls) by adding :+1: to them. Pull requests will be merged when their votes reach **5**. +I will not keep your pull requests on hold, especially because this is not a list of libraries but a list of softwares, so feel free to contribute with the above guide. :+1: