{"id":20036837,"url":"https://github.com/vborovikov/syndication","last_synced_at":"2026-05-10T13:44:58.832Z","repository":{"id":224064904,"uuid":"761079111","full_name":"vborovikov/syndication","owner":"vborovikov","description":"Feed reader library","archived":false,"fork":false,"pushed_at":"2024-12-29T22:02:17.000Z","size":2337,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-12T18:51:44.254Z","etag":null,"topics":["csharp","dotnet","feed-reader","rss","rss-parser","rss-reader"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vborovikov.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-21T07:43:51.000Z","updated_at":"2024-12-29T22:02:21.000Z","dependencies_parsed_at":"2024-06-21T05:42:50.247Z","dependency_job_id":"9a74a0c9-1fca-4b2d-b0e5-3e91979e3f61","html_url":"https://github.com/vborovikov/syndication","commit_stats":null,"previous_names":["vborovikov/syndication"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vborovikov%2Fsyndication","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vborovikov%2Fsyndication/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vborovikov%2Fsyndication/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vborovikov%2Fsyndication/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vborovikov","download_url":"https://codeload.github.com/vborovikov/syndication/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241466289,"owners_count":19967431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csharp","dotnet","feed-reader","rss","rss-parser","rss-reader"],"created_at":"2024-11-13T10:16:59.952Z","updated_at":"2026-05-10T13:44:58.581Z","avatar_url":"https://github.com/vborovikov.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Syndication\n\n[![Downloads](https://img.shields.io/nuget/dt/SyndicationLib.svg)](https://www.nuget.org/packages/SyndicationLib)\n[![NuGet](https://img.shields.io/nuget/v/SyndicationLib.svg)](https://www.nuget.org/packages/SyndicationLib)\n[![MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/vborovikov/syndication/blob/master/LICENSE)\n\nSyndication is a .NET library used for reading and parsing RSS and ATOM feeds. Supports **RSS 0.91, 0.92, 1.0, 2.0 and ATOM**.\n\nDeveloped because tested existing libraries do not work with different languages, encodings or have other issues. Library tested with multiple languages, encodings and feeds.\n\nOriginal FeedReader library is available as NuGet package:\n\n[![NuGet](https://img.shields.io/nuget/v/CodeHollow.FeedReader.svg)](https://www.nuget.org/packages/CodeHollow.FeedReader)\n\n## Usage\nThe simplest way to read a feed and show the information is:\n```csharp\n    var feed = await FeedReader.ReadAsync(\"https://arminreiter.com/feed\");\n\n    Console.WriteLine(\"Feed Title: \" + feed.Title);\n    Console.WriteLine(\"Feed Description: \" + feed.Description);\n    Console.WriteLine(\"Feed Image: \" + feed.ImageUrl);\n    // ...\n    foreach(var item in feed.Items)\n    {\n        Console.WriteLine(item.Title + \" - \" + item.Link);\n    }\n```\n\nThere are some properties that are only available in e.g. RSS 2.0. If you want to get those properties, the property \"SpecificFeed\" is the right one:\n\n```csharp\n    var feed = await FeedReader.ReadAsync(\"https://arminreiter.com/feed\");\n\n    Console.WriteLine(\"Feed Title: \" + feed.Title);\n            \n    if(feed.Type == FeedType.Rss_2_0)\n    {\n        var rss20feed = (Feeds.Rss20Feed)feed.SpecificFeed;\n        Console.WriteLine(\"Generator: \" + rss20feed.Generator);\n    }\n```\n\nIf the url to the feed is not known, then you can use FeedReader.GetFeedUrlsFromUrl(url) to parse the url from the html webpage:\n\n```csharp\n    string url = \"arminreiter.com\";\n    var urls = FeedReader.GetFeedUrlsFromUrl(url);\n            \n    string feedUrl;\n    if (urls.Count() \u003c 1) // no url - probably the url is already the right feed url\n        feedUrl = url;\n    else if (urls.Count() == 1)\n        feedUrl = urls.First().Url;\n    else if (urls.Count() == 2) // if 2 urls, then its usually a feed and a comments feed, so take the first per default\n        feedUrl = urls.First().Url;\n    else\n    {\n        // show all urls and let the user select (or take the first or ...)\n        // ...\n    }\n\n    var readerTask = FeedReader.ReadAsync(feedUrl);\n    readerTask.ConfigureAwait(false);\n\n    foreach (var item in readerTask.Result.Items)\n    {\n        Console.WriteLine(item.Title + \" - \" + item.Link);\n        // ...\n    }\n```\n\n## Specifications\n- RSS 0.91: http://www.rssboard.org/rss-0-9-1-netscape\n- RSS 0.92: http://backend.userland.com/rss092, http://www.rssboard.org/rss-0-9-2\n- RSS 1.0 : http://web.resource.org/rss/1.0/spec\n- RSS 2.0 : https://validator.w3.org/feed/docs/rss2.html\n- ATOM    : https://validator.w3.org/feed/docs/atom.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvborovikov%2Fsyndication","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvborovikov%2Fsyndication","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvborovikov%2Fsyndication/lists"}