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, 6:28:55 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

7 sources
While I may have written and designed NewsBlur, I am using a ton of other open-source technologies: * Django: Web framework written in Python, used to serve all pages. * Celery & RabbitMQ: Asynchronous queueing server, used to fetch and parse RSS feeds. * MongoDB, Pymongo, & Mongoengine: Non-relational database, used to store stories, read stories, feed/page fetch histories, and proxied sites. * PostgreSQL: Relational database, used to store feeds, subscriptions, and user accounts. * jQuery: Cross-browser compliant JavaScript code. IE works without effort. * Underscore.js: Functional programming for JavaScript. Indispensible. * And many miscellaneous jQuery Plugins: Everything from resizable layouts, to progress bars, sortables, date handling, colors, corners, JSON, animations. See the complete list on NewsBlur's GitHub Javascript folder:
Read the rest
In NewsBlur: A feed reader with intelligence
Hey folks, I'm a HNer. I created NewsBlur with Hacker News in mind the entire time. In fact, I thought up the idea during a summer NYC Hackers and Founders last year. For the past 16 months, I kept trying to pick a date when NewsBlur would be ready to submit. Finally, embarrassed as I am by the bugs galore, today is that day and I am glad to say that NewsBlur is far enough along to show off. NewsBlur is an RSS feed reader that tries to do two things very well: 1) Shows you the original site instead of a context-less feed. Read the original and NewsBlur marks the stories you've read. 2) Filter stories you either like or dislike. A three-stop slider goes between dislike, neutral, and like (red, yellow, and green). Training is super-easy and all click-based (as opposed to you having to writing out what you like in a site, NewsBlur asks you,
Read the rest
semi-Hunch-style, your opinions on facets of the site). I started working on NewsBlur to see if I could do it. Put the AI together with the back-end feed processing and fetching, along with the nifty front-end of the original site. This is one of those projects where I just kept pushing in all directions until I felt I had something good, not knowing if I could do it at all, but believing the entire time that I was able to complete the project. If you have a project kicking around in the back of your mind, just dedicate enough weeks and months to get it done and done well. Provided you do that, you're almost guaranteed to succeed in some way. Those first few months of writing NewsBlur, I felt like a fraud, wishing I could just get threaded feed fetching to not break every few minutes. Even what I considered to be simple python gave me headaches. (Turns out threading is evil, use multiprocessing instead.) NewsBlur is entirely open-source: http://github.com/samuelclay/NewsBlur/. The iPhone app, the front-end JavaScript, and the back-end Python. Pick it apart, but know that it is more a learning experience than a business. Turning it into something profitable may not be easy, but I only need 80 premium users to make that happen.
In NewsBlur: A feed reader with intelligence
A bunch of folks in this thread have asked about an alternative that is better than Google Reader. I created NewsBlur, http://www.newsblur.com, which is an intelligent feed reader. It shows you the original site (which is why I never liked using RSS in the first place, but once you read enough sites, you have little choice but to switch to a reader). It also has an intelligence trainer that allows you to explicitly hide and highlight stories that you like or dislike. It imports directly from Google Reader. It's just a project, but if people like it well enough, I could be persuaded to add some more advanced features (metrics on your subscriptions, advanced AI, etc) for a monthly/yearly cost. I'm afraid to put a Paypal/Amazon Checkout button on there, because that means NewsBlur is held to a much more difficult/higher standard. But anyways
Read the rest
, please, offer feedback and let me know if you think this is a good alternative. I worked very hard on NewsBlur, and so I make it all open-source (everything from the feed fetcher, the reader interface, and the coming iPhone app) on GitHub, so that other developers could benefit from all the tricks and knowledge I acquired while creating this multi-faceted project: http://github.com/samuelclay/NewsBlur/.
In Bloglines to close

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.