HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
samuelclay
NewsBlur
HTML2010–2026
samuelclay / NewsBlur

NewsBlur

NewsBlur is a personal news reader that brings people together to talk about the world. A new sound of an old instrument.

51Distinct people
75Mentions
3Explicit recommenders
7.7KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

NewsBlur is a personal news reader that brings people together to talk about the world. A new sound of an old instrument.

GitHub

Where it is used

No documented product use was verified in the last source check.

What people are saying

I don't know about "best", but I've tried many, Reeder, Feedly etc, for many years. These are not OSS though, but Reeder was my favorite of the bunch. I settled on running…

stasomatic used a recommendation phrase. 3 indexed comments match. This is a phrase match, not a verdict.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 9–Nov 16 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/16/2026, 12:56:33 AM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year75 dated mentions

Observed mentions: 2010-06-27 18:09:31 UTC to 2026-10-07 17:25:28 UTC.

051015202010-01-01 00:00:00 UTC to 2011-01-01 00:00:00 UTC (exclusive): 7 mentions; 0 submissions, 7 comments20102011-01-01 00:00:00 UTC to 2012-01-01 00:00:00 UTC (exclusive): 4 mentions; 0 submissions, 4 comments2012-01-01 00:00:00 UTC to 2013-01-01 00:00:00 UTC (exclusive): 10 mentions; 1 submissions, 9 comments2013-01-01 00:00:00 UTC to 2014-01-01 00:00:00 UTC (exclusive): 20 mentions; 1 submissions, 19 comments2014-01-01 00:00:00 UTC to 2015-01-01 00:00:00 UTC (exclusive): 9 mentions; 0 submissions, 9 comments2015-01-01 00:00:00 UTC to 2016-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments2016-01-01 00:00:00 UTC to 2017-01-01 00:00:00 UTC (exclusive): 3 mentions; 0 submissions, 3 comments2017-01-01 00:00:00 UTC to 2018-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments2018-01-01 00:00:00 UTC to 2019-01-01 00:00:00 UTC (exclusive): 3 mentions; 0 submissions, 3 comments20182019-01-01 00:00:00 UTC to 2020-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments2020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments2021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 3 mentions; 0 submissions, 3 comments2022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments2023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments2024-01-01 00:00:00 UTC to 2025-01-01 00:00:00 UTC (exclusive): 3 mentions; 0 submissions, 3 comments2025-01-01 00:00:00 UTC to 2026-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments2026-01-01 00:00:00 UTC to 2027-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments. Incomplete calendar period.2026*

* An incomplete calendar period is marked with an outlined bar. Its count is not directly comparable with a full period.

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20102010-01-01 00:00:00 UTC2011-01-01 00:00:00 UTC707
20112011-01-01 00:00:00 UTC2012-01-01 00:00:00 UTC404
20122012-01-01 00:00:00 UTC2013-01-01 00:00:00 UTC1019
20132013-01-01 00:00:00 UTC2014-01-01 00:00:00 UTC20119
20142014-01-01 00:00:00 UTC2015-01-01 00:00:00 UTC909
20152015-01-01 00:00:00 UTC2016-01-01 00:00:00 UTC202
20162016-01-01 00:00:00 UTC2017-01-01 00:00:00 UTC303
20172017-01-01 00:00:00 UTC2018-01-01 00:00:00 UTC202
20182018-01-01 00:00:00 UTC2019-01-01 00:00:00 UTC303
20192019-01-01 00:00:00 UTC2020-01-01 00:00:00 UTC202
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC202
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC303
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC101
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC101
20242024-01-01 00:00:00 UTC2025-01-01 00:00:00 UTC303
20252025-01-01 00:00:00 UTC2026-01-01 00:00:00 UTC101
2026 (partial)2026-01-01 00:00:00 UTC2027-01-01 00:00:00 UTC202

From the project README

An excerpt from the repository, fetched Nov 12, 2026.

Read the project’s introduction
NewsBlur A personal news reader bringing people together to talk about the world. A new sound of an old instrument. www.newsblur.com About NewsBlur is a personal news reader with intelligence. It's an RSS feed reader and social news network that shows the original site while giving you powerful filtering tools. Train NewsBlur to learn what you like and dislike, and it will automatically highlight and hide stories. NewsBlur is free to use at newsblur.com (up to 64 sites) with premium plans available, or you can self-host your own instance using this repository. Features Real-time RSS - Stories are pushed directly to you, so you can read news as it comes in Original Site View - Read the content in context, the way it was meant to be seen Training - Hide the stories you don't like and highlight the stories you do Shared Stories - Reading news is better with friends. Share stories on your public blurblog Full Text Search - Quickly find stories across all of your subscriptions Story Tagging - Save stories with custom tags for fast references Blurblog Privacy - Share stories with the world or only with your friends Saved Searches - Regularly used searches are conveniently given their own feeds Read the Full Story - The original story from truncated RSS feeds is seamlessly expanded Track Changes - See how a story evolved since it was first published Email Newsletters - Read your email newsletters where they belong, in a news reader Multiple Layouts - Grid, List, Split, or Magazine view for each site Dark Mode - Easy on the eyes and built into the web, iOS, and Android YouTube Channels - Even sites that don't publish RSS feeds can be followed Third-party Apps - Supports Reeder, ReadKit, Unread, and many more IFTTT Integration - Hook NewsBlur up to nearly every service on the web MCP Server - Connect AI agents to your feeds, stories, and classifiers Native Mobile Apps - Free iOS, macOS, and Android apps jam-packed with features Technology NewsBlur is a Django application (Python 3.7+) with a Backbone.js frontend. It uses: PostgreSQL for relational data (feeds, subscriptions, accounts) MongoDB for stories and read states Redis for story assembly and caching Elasticsearch for search (optional) Celery for background tasks (feed fetching) Node.js services for text extraction and image processing Self-Hosted Installation This repository contains everything you need to run your own NewsBlur instance with complete control over your data. Prerequisites: Docker and Docker Compose git clone https://github.com/samuelclay/NewsBlur.git cd NewsBlur make Visit https://localhost (type thisisunsafe to bypass the self-signed certificate warning). Common commands: make - Start/update and apply migrations (run after git pull) make log - View web and node logs make logall - View all container logs make shell - Django shell with auto-imported models make bash - Bash shell in web container make test - Run tests make lint - Format code (isort, black, flake8) make down - Stop containers Bootstrap discover feeds (without fetching): docker exec -t newsblur_web python manage.py bootstrap_popular_feeds --skip-fetch This creates PopularFeed records from the curated fixtures file without fetching any feed content. You can filter by type with --type youtube, --type reddit, --type podcast, --type newsletter, or --type rss. Database access: make mongo - MongoDB shell make redis - Redis CLI make postgres - PostgreSQL shell See AGENTS.md for detailed development guidelines. Configuration To customize your NewsBlur installation, create newsblur_web/local_settings.py to override settings from docker_local_settings.py. Settings for self-hosted installations: NEWSBLUR_URL - Your domain (default: https://localhost). Also used for Archive browser extension OAuth. SESSION_COOKIE_DOMAIN - Cookie domain for authentication AUTO_PREMIUM - Give new users premium features (default: True) AUTO_ENABLE_NEW_USERS - Auto-activate new accounts (default: True) ENFORCE_SIGNUP_CAPTCHA - Require captcha on signup (default: False) OPENAI_API_KEY - AI features and Discover for related stories DAYS_OF_UNREAD - Story retention for premium users in days (default: 30) DAYS_OF_UNREAD_FREE - Story retention for free users in days (default: 14) HOMEPAGE_USERNAME - Username shown on homepage to unauthenticated users (default: "popular") Uncommon settings (for running full newsblur.com): EMAIL_BACKEND - Email delivery method STRIPE_SECRET / STRIPE_PUBLISHABLE - Stripe payment processing PAYPAL_API_CLIENTID / PAYPAL_API_SECRET - PayPal payment processing S3_* settings - AWS S3 bucket configuration for backups, icons, avatars FACEBOOK_APP_ID / TWITTER_CONSUMER_KEY / YOUTUBE_API_KEY - Social API keys See the full list in docker_local_settings.py and settings.py. Development with Worktrees NewsBlur supports Git worktrees for working on multiple features simultaneously, with each worktree running on its own set of ports. This is ideal when working with AI coding assistants like Claude Code. Create and start a worktree: git worktree add .worktree/feature-name cd .worktree/feature-name make worktree Each worktree automatically gets unique ports based on its directory name: Main repo: https://localhost (ports 80/443) Worktree: https://localhost:XXXX (unique ports) View your worktree's URLs: make worktree Follow the worktree logs: make worktree-log Close a worktree: make worktree-close # Stops containers and removes worktree if no uncommitted changes All worktrees share the same database services (PostgreSQL, MongoDB, Redis, Elasticsearch), so you can test multiple features without duplicating data. MCP Server & CLI NewsBlur includes an MCP server that lets AI agents (Claude Desktop, Claude Code, Cursor, or any MCP-compatible client) interact with your feeds, stories, and classifiers. Premium subscription required. Connect Claude Code: claude mcp add --transport http newsblur https://newsblur.com/mcp/ Codex: Add to ~/.codex/config.toml: [mcp_serv
Read the full README on GitHub

What Hacker News says

10 sources
Awesome, I used this technique to find the dominant color in favicons so I could create a gradient in NewsBlur. See the effect here: http://cl.ly/KElb Here's the Python I use to do it: https://github.com/samuelclay/NewsBlur/blob/master/utils/Ima... from PIL import Image import scipy import scipy.cluster from pprint import pprint image = Image.open('logo.png') NUM_CLUSTERS = 5 # Convert image into array of values for each point. ar = scipy.misc.fromimage(image) shape = ar.shape # Reshape array of values to merge color bands. if len(shape) > 2: ar = ar.reshape(scipy.product(shape[:2]), shape[2]) # Get NUM_CLUSTERS worth of centroids. codes, _ = scipy.cluster.vq.kmeans(ar, NUM_CLUSTERS) # Pare centroids, removing blacks and whites and shades of really dark and really light.
Read the rest
original_codes = codes for low, hi in [(60, 200), (35, 230), (10, 250)]: codes = scipy.array([code for code in codes if not ((code[0] < low and code[1] < low and code[2] < low) or (code[0] > hi and code[1] > hi and code[2] > hi))]) if not len(codes): codes = original_codes else: break # Assign codes (vector quantization). Each vector is compared to the centroids # and assigned the nearest one. vecs, _ = scipy.cluster.vq.vq(ar, codes) # Count occurences of each clustered vector. counts, bins = scipy.histogram(vecs, len(codes)) # Show colors for each code in its hex value. colors = [''.join(chr(c) for c in code).encode('hex') for code in codes] total = scipy.sum(counts) color_dist = dict(zip(colors, [count/float(total) for count in counts])) pprint(color_dist) # Find the most frequent color, based on the counts. index_max = scipy.argmax(counts) peak = codes[index_max] color = ''.join(chr(c) for c in peak).encode('hex')
In Using python and k-means to find dominant colors in images

Ask HN: Large Open Sourced Web Apps

Hi guys, Since I'm eager to learn the latest technologies behind the 'cool' web apps, lately I've been researching about large AND relatively cutting edge open source web apps in the wild, not necessarily commercial. One striking example that I've found (here at HN) was NewsBlur: https://github.com/samuelclay/NewsBlur (massive cudos to Samuel Clay for open sourcing it) The technologies involved in making NewsBlur tick are pretty much in sync with what I plan to learn (I'll try installing and debugging it at my VPS) but I'm curious of other such open sourced projects that you know of. Your turn, Cheers
3 points · Open discussion
There is a mention of `json.dumps` being too naive to be used in an API, and there's good reason for that. If you want a more advanced JSON serializer for Django, here's what I use on NewsBlur. From https://github.com/samuelclay/NewsBlur/blob/master/utils/jso...: def json_encode(data, *args, **kwargs): """ The main issues with django's default json serializer is that properties that had been added to an object dynamically are being ignored (and it also has problems with some models). """ def _any(data): ret = None # Opps, we used to check if it is of type list, but that fails # i.e. in the case of django.newforms.utils.ErrorList, which extends # the type "list". Oh man, that was a dumb mistake! if hasattr(data, 'to_json'):
Read the rest
ret = data.to_json() elif isinstance(data, list): ret = _list(data) # Same as for lists above. elif isinstance(data, dict): ret = _dict(data) elif isinstance(data, Decimal): # json.dumps() cant handle Decimal ret = str(data) elif isinstance(data, models.query.QuerySet): # Actually its the same as a list ... ret = _list(data) elif isinstance(data, models.Model): ret = _model(data) # here we need to encode the string as unicode (otherwise we get utf-16 in the json-response) elif isinstance(data, basestring): ret = unicode(data) # see http://code.djangoproject.com/ticket/5868 elif isinstance(data, Promise): ret = force_unicode(data) elif isinstance(data, datetime.datetime) or isinstance(data, datetime.date): ret = str(data) else: ret = data return ret def _model(data): ret = {} # If we only have a model, we only want to encode the fields. for f in data._meta.fields: ret[f.attname] = _any(getattr(data, f.attname)) # And additionally encode arbitrary properties that had been added. fields = dir(data.__class__) + ret.keys() add_ons = [k for k in dir(data) if k not in fields] for k in add_ons: ret[k] = _any(getattr(data, k)) return ret def _list(data): ret = [] for v in data: ret.append(_any(v)) return ret def _dict(data): ret = {} for k,v in data.items(): ret[str(k)] = _any(v) return ret ret = _any(data) return json.dumps(ret) You can get the imports from the link above, but the point is that you want to normalize any data structures into something that `json.dumps` can handle easily. Things like datetimes, models, and querysets. A trick that I use is to give each of my models a `Model.to_json()` method, which looks something like this: def to_json(self): return { 'date': self.date, 'category': self.category, 'title': self.title, 'content': self.content, 'with_user_id': self.with_user_id, 'feed_id': self.feed_id, 'content_id': self.content_id, }
In Choosing an API framework for Django
I am very excited to see how you grow NewsBlur. It's a really great looking take on RSS feeds. As someone who had a large social group sharing items on Reader before their last round of changes, I would love to hear what your plans/timeline on adding social features are. (fyi, Samuel mentioned adding social features in his 2011 year-in-review blog post, http://blog.newsblur.com/post/15993667293/2011-year-in-revie..., and there is a social branch on github, https://github.com/samuelclay/NewsBlur/tree/social)
In From project to profession: going indie on NewsBlur
Not only is Samuel an amazing developer, but he is also the perfect person to build the news reader of the future. Check out his Github repo for some of the cleanest Python / JS code you'll ever come across. https://github.com/samuelclay/NewsBlur I worked on a personalized news reader in 2009 (http://www.readwriteweb.com/start/2009/11/parsely-a-feed-rea...). We decided ultimately to abandon the project to pursue Parse.ly Dash, a media analytics tool. When we were winding down Parse.ly Reader, I discovered Newsblur. I can say confidently that NewsBlur gets everything "right" that we got "wrong" in our original design. I now use NewsBlur as my primary reader and I am a paying customer. I have also evangelized it to my friends. I am really excited that Samuel is going to go full-time on this project and make it one of the best pieces of soft
Read the rest
ware on the web for news junkies like me.
In From project to profession: going indie on NewsBlur

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.