Click here to Skip to main content
14,538,935 members


Rate this:
4.96 (24 votes)
Please Sign up or sign in to vote.
4.96 (24 votes)
13 Jan 2020CPOL
WinForms RSS Reader similar to FeedReader



RealNews is a Winforms RSS Reader similar in features to FeedReader which is out of support for 10 years now and is showing its age on the Windows 10 operating system. As a replacement for FeedReader, I tried out many other RSS readers like RSSOwl (which is also unsupported) but none of them felt right, so I decided to write my own.

This is a personal need project which I have released to the public for anyone who has a similar need and might find useful. It uses the following libraries:

RealNews source code is also on github at


RealNews has the following features:

  • Super fast performance
  • No database used or required
  • Tiny 310KB single EXE file
  • Fully offline mode to view feed items with associated images
  • Download images in a daily time window
  • Download Images less than a size limit only
  • Update every X minutes globally or based on each individual feed setting
  • Manual update for individual feed or globally
  • Editable style.css for the feed view window
  • HTML sanitizer for the feed item content to strip out JavaScript and potentially risky tags
  • Read feed definitions from an OPML file
  • Light and dark theme


Currently (this may change in the future), there are the following limitations:

  • No writing OPML files
  • Drag move feeds to folders

Using RealNews

You can get started with RealNews by importing an existing OPML file or by adding feeds individually from the File menu, when adding individually, you will see the following form:


You put your feed in the Feed Address text box and press the get info button so RealNews can fetch the feed name from the URL for you.

You can put this feed in a category folder in the treeview by setting the category text.

If you set the Update Every number > 0, then this feed will update on its own schedule as well as the global schedule.

If you minimize RealNews, it will go down to the tray, and you can restore or exit from there if you need.


Controlling RealNews

All the settings for the application are in the form below which is self explanatory:


If you click on the style.css link, you can edit the feed item style that is used in the browser control.

Keyboard Shortcuts

You can control RealNews with the following shortcut keys:

Key Description
F2 edit feed information
ctrl+L show logs
ctrl+S toggle star for feed item
space move to next feed item
Alt+up move up in current feed
Alt+down move down in current feed
ctrl+D delete current or selected items

The Internals

Most of the code is in the frmMain.cs class and handles the complex UI for the application.

The Files and Folders

RealNews has the following folder structure:


  • cache: the storage of images for feed items (see the image cache section)

  • configs

    • settings.config: all the apps settings in json format
    • style.css: the CSS styling for viewing feed items
  • feeds

    • icons: holds the downloaded feed icons for the RSS site (if it has one)
    • lists: holds the feed item lists

The feed lists are json files of the feed items by the feed name you have specified. Also in the feed folder, there are 2 other files:

  • downloadimg.list: is the download queue for images extracted from feed items in json
  • feeds.list: is the main feed lists of all the feeds you have added in json

Feed Reader

The feed reader code is from the URL at the top of the article, it has been modified to support extracting all the information in the "non-standard" standard RSS formats.

Internal Web Server

RealNews has an integrated web server to show the feed items for the web browser control. The web server serves the HTML for the feed item and also handles the serving of images that are in the content via the ImageChache class.

You can also view the content in a normal browser by going to the localhost URL and the associated port from the settings file.

The content page generated replaces the image tag URLs with a link back to this web server, so the images are served from the image cache and not the internet.

Image Cache

Most feed readers use a database to store the content (images, etc.), I went back and forth on this and initially used RaptorDB but I decided against it when I came up with this solution. First, let me state the problem:

  • Images in RSS feeds can be really long URLs and may not end in an image extension.
  • Storing this URL on disk may not be feasible because of the length of characters and file system limitations that may contain special characters that the file system does not like.

An example of a URL is below (this was taken from downloadimg.list and is json stringified):


This is just one image URL and as you can see, there is no way to reliably get the image name to save to disk for example.

So the solution I came up with is dead simple, instead of parsing headaches to get the image name to store to disk with all the limitations stated, all I did was to generate the hash of the URL and use that number as the file name on disk (the simplest hash is the one already defined for string in .NET).

To isolate images more, I also extract the domain name from the URL and store the hash in that folder which is handy for humans to browse through when needed.


All this removes the need for a database which essentially is just mapping a lookup URL to a filename anyway.

HTML Sanitizer

The HTML sanitizers job is to strip out potentially problematic HTML tags from the feed item and replace them with safe ones, so the viewing of that feed item is less a security risk.

Image Downloader

Between the start time and end time in the settings file, RealNews will start downloading images it has in the download queue. The image download task will first check the image size by getting that information from the server if that is below the settings you have specified, it will download it and save it to the cache.

If the download fails with a timeout, then it will re-queue for retry later, else it will just skip that image.

The image downloader starts 200 tasks at once with a break of 4secs between the batches until the queue is empty.

Points of Interest

WebClient and https

Weirdly for the WebClient to work correctly with https in .NET 4, you have to add the following code (which is undocumented, no intellisense):

ServicePointManager.SecurityProtocol = (SecurityProtocolType)3072;

Also for the WebClient to force using http compression on connections, you need to change the request, the entire new code is as follows:

public class mWebClient : WebClient
	public mWebClient()
		Timeout = 10 * 1000;
		// KLUDGE : https security for .NET 4
		ServicePointManager.SecurityProtocol = (SecurityProtocolType)3072;
		base.Encoding = System.Text.Encoding.UTF8;
		if (Settings.UseSytemProxy) // FEATURE : else define a proxy
			Proxy = WebRequest.DefaultWebProxy;
	public int Timeout { get; set; }

	protected override WebRequest GetWebRequest(Uri uri)
		WebRequest request = base.GetWebRequest(uri);
		var http = request as HttpWebRequest;
		if (http != null)
			http.AutomaticDecompression = DecompressionMethods.GZip |
			http.ReadWriteTimeout = Timeout;

		request.Timeout = Timeout;
		return request;

Non Standard, Feed Standards

While the RSS feed has its standards (there are multiple ones), there are interpretation differences for each provider which was a real headache to handle despite the excellent feed reader code used.

For example, The Gaurdian and CNN feeds have their images not in the main feed description but the "extra" content.

Also, feeds like Android Central have their entire content in the extra section instead of the description section.

For all these non standard "standards", I had to change the feed reader code to extract these extra sections too for showing in the view area.

Single Instancing

To stop data conflicts, the app needed to run as a single instance with the added requirement of from the running folder (you can have multiple instances if each run from its own folder).

For this, first I created a "temp" file in the data folder on startup and was deleted on closing, which I checked the existence of when starting to handle single instancing. The problem with this was that it failed if the computer died on power outs, and I had to manually delete the temp file to get it working again.

The final solution was to check the running processes on the computer and check the path of the running EXE matches this processes path:

_path = Path.GetDirectoryName(Assembly.GetEntryAssembly().Location);
var name = Process.GetCurrentProcess().MainModule.ModuleName.Split('.')[0];
if (_path.EndsWith("\\") == false) _path += "\\";
var pp = Process.GetProcessesByName(name);
var found = 0;
foreach (var pi in pp)
	if (pi.MainModule.FileName.StartsWith(_path))
if(found == 1)
    // run app here
    MessageBox.Show("Only one instance at a time");

If the found count = 1 (this includes itself), then were ok to run else one is already running.

HTML Rendering vs Browser Control

At first, for security reasons, I decided to have the feed be rendered as HTML with a variety of HTML render controls I found, but neither of these were suited for the task I needed and all had their limitations, so they were scrapped.

After a lot of testing, a fell back to the WinForms browser control (which is a really old IE wrapper) but for the purpose of RealNews works fine since the app's HTML sanitizer strips out all JavaScript and potential threat tags, which the browser control can handle (for newer web pages, the IE control just chokes with a lot of errors for JavaScript it doesn't understand).

I also looked in the Chrome browser control for Winforms but this added 50MB to the size of the application which for needs here is excessive.


The black & white icons are from FontAwesome web icon font which where extracted by a little program I found on CodeProject which generates .png files for a given image dimension you require.

a tags with target=_blank

If the HTML in the description has a tags with the target set, then the browser control opens IE to that URL which is a disaster, to overcome this and open the tags in your default browser, you need to add the following code (also add a COM reference to "Microsoft Internet Controls"):

(this.webBrowser1.ActiveXInstance as SHDocVw.WebBrowser).NewWindow3 += FrmMain_NewWindow3;  

private void FrmMain_NewWindow3(ref object ppDisp, ref bool Cancel, 
                                uint dwFlags, string bstrUrlContext, string bstrUrl)
	// fix for a tags with target = new window
	Cancel = true;

The Many Versions of MoveNextUnread()

This method went through a lot of revisions and tweaks which started out as a lot of foreach loops without folder/category support and finally came down to some interesting linq statements which are really cool:

var found = false;
if (_currentFeed.Folder != "") // in a folder 
	var f = _feeds.FindAll(x => x.UnreadCount > 0 &&
					x.Folder != "" &&
					x.FullTitle.CompareTo(_currentFeed.FullTitle) > 0)
						  .OrderBy(x => x.FullTitle)
	if (f.Count() > 0)
		_currentFeed = f[0];
		found = true;
if (found == false)
    // not in folder
	var f = _feeds.FindAll(x => x.UnreadCount > 0 &&
							  x.Folder == "" )
						  .OrderBy(x => x.Title)
	if (f.Count() > 0)
		_currentFeed = f[0];
        // loop back to start 
		f = _feeds.FindAll(x => x.UnreadCount > 0 &&
							  x.Folder != "")
						  .OrderBy(x => x.FullTitle)
		if (f.Count() > 0)
			_currentFeed = f[0];

This version seems to work intuitively moving down the tree, looping back to the top and finding the next unread feed (hopefully!)

Previous Versions


  • Initial Version v1.0: 2nd August, 2018
  • Update v1.1: 23rd August, 2018
    • Upgrade to fastJSON v2.2.0
    • Search clear button visible only if text entered
    • Fix search and current unread count update
    • Added cleanup image cache for orphan images
  • Update v1.3: 25th February, 2019
    • Usability tweaks
    • Check image already downloaded before downloading
    • Code cleanup
    • Added feed update timeout
    • Local datetime in settings.config
    • Selecting folder/category shows all feeds below it
  • Update v1.4: 11th April, 2019
    • Added alt+up and down to navigate the feed list
    • Usability tweaks
    • Fix for some sites returning 403
  • Update v1.4.1: 8th June, 2019
    • Added Google search the feed item title in the toolbar
    • Cleaned up the UI style
    • Updated to new zipstorer.cs
  • Update v1.4.3: 23rd August 2019
    • Added the use of a custom proxy
    • Colour coding feeds in tree if failed to get data
    • Search title pre-process plugin
  • Update v1.4.4: 30th August 2019
    • Add/edit feed form validation checks
    • Added OnCloseMinimize config to close or minimize on form close click
    • Adding a new feed with category updates the tree correctly
    • Added SkipFeedItemsDaysOlderThan config for feeds that don't filter recent items when sending
    • Singleton app now works correctly and opens existing window even if in tray
  • Update v1.5.0: 11th December 2019
    • bug fix filtering old items when item does not provide a publish date
    • cleanup all, resets failed feed colours
    • added dark theme
  • Update v1.5.1 : 30th December 2019
    • bug fix ensuring items are visible at the end of the feed list
    • memory cleanup on load and save feeds
    • bug fix running on WinXP
  • Update v1.5.2 : 14th January 2020
    • bug fix running on Win7
    • check for 0 length images in cache


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Mehdi Gholam
Architect -
United Kingdom United Kingdom
Mehdi first started programming when he was 8 on BBC+128k machine in 6512 processor language, after various hardware and software changes he eventually came across .net and c# which he has been using since v1.0.
He is formally educated as a system analyst Industrial engineer, but his programming passion continues.

* Mehdi is the 5th person to get 6 out of 7 Platinum's on Code-Project (13th Jan'12)
* Mehdi is the 3rd person to get 7 out of 7 Platinum's on Code-Project (26th Aug'16)

Comments and Discussions

BugWindows XP Pin
inariy18-Dec-19 7:59
Memberinariy18-Dec-19 7:59 
GeneralRe: Windows XP Pin
Mehdi Gholam18-Dec-19 18:13
MemberMehdi Gholam18-Dec-19 18:13 
GeneralRe: Windows XP Pin
Mehdi Gholam30-Dec-19 3:18
MemberMehdi Gholam30-Dec-19 3:18 
GeneralMy vote of 5 Pin
inariy18-Dec-19 7:54
Memberinariy18-Dec-19 7:54 
QuestionWPF update ? Pin
kiquenet.com16-Dec-19 11:16
professionalkiquenet.com16-Dec-19 11:16 
AnswerRe: WPF update ? Pin
Mehdi Gholam16-Dec-19 18:35
MemberMehdi Gholam16-Dec-19 18:35 
PraiseGreat article! Pin
Ravi Bhavnani12-Dec-19 9:41
professionalRavi Bhavnani12-Dec-19 9:41 
SuggestionOnce Instance Only Pin
Bassam Abdul-Baki23-Aug-19 4:13
professionalBassam Abdul-Baki23-Aug-19 4:13 
GeneralRe: Once Instance Only Pin
Mehdi Gholam23-Aug-19 4:19
MemberMehdi Gholam23-Aug-19 4:19 
GeneralRe: Once Instance Only Pin
Mehdi Gholam29-Aug-19 22:59
MemberMehdi Gholam29-Aug-19 22:59 
BugCategory No Worky Pin
Bassam Abdul-Baki23-Aug-19 3:05
professionalBassam Abdul-Baki23-Aug-19 3:05 
GeneralRe: Category No Worky Pin
Mehdi Gholam23-Aug-19 3:55
MemberMehdi Gholam23-Aug-19 3:55 
GeneralRe: Category No Worky Pin
Bassam Abdul-Baki23-Aug-19 4:06
professionalBassam Abdul-Baki23-Aug-19 4:06 
GeneralRe: Category No Worky Pin
Mehdi Gholam23-Aug-19 4:13
MemberMehdi Gholam23-Aug-19 4:13 
GeneralRe: Category No Worky Pin
Bassam Abdul-Baki23-Aug-19 4:19
professionalBassam Abdul-Baki23-Aug-19 4:19 
GeneralRe: Category No Worky Pin
Bassam Abdul-Baki23-Aug-19 4:33
professionalBassam Abdul-Baki23-Aug-19 4:33 
PraiseNice work! Pin
Ravi Bhavnani23-Aug-18 8:00
professionalRavi Bhavnani23-Aug-18 8:00 
GeneralRe: Nice work! Pin
kiquenet.com27-Aug-18 3:21
professionalkiquenet.com27-Aug-18 3:21 
AnswerRe: Nice work! Pin
Ravi Bhavnani27-Aug-18 8:03
professionalRavi Bhavnani27-Aug-18 8:03 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Posted 1 Aug 2018


40 bookmarked