samuelclay/NewsBlur is one of the data-focused repositories TopGit tracks, currently at 7.7k stars, written primarily in HTML. NewsBlur is a personal news reader that brings people together to talk about the world. A new sound of an old instrument.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
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
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):
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/
On first use, a browser window opens for you to log in to NewsBlur and authorize access.
What you can do
Read your feeds - Get unread stories from any feed or folder, search across all subscriptions, retrieve saved stories by tag.
Take action - Mark stories as read, save stories with tags and notes, subscribe to new feeds, share stories to your blurblog.
Train intelligence - View and update classifiers to like/dislike authors, tags, titles, and feeds. Let an AI agent analyze your reading patterns and suggest training rules.
Discover - Find new feeds by topic, see trending feeds, find feeds similar to ones you already follow.
Available tools
Tool
Description
newsblur_list_feeds
All subscribed feeds with folders and unread counts
newsblur_get_stories
Load stories from feeds, folders, or all subscriptions
newsblur_get_saved_stories
Saved stories filtered by tag
newsblur_search_stories
Full-text search across feeds
newsblur_get_original_text
Fetch full article from source website
newsblur_get_feed_info
Detailed feed metadata and statistics
newsblur_get_account_info
User profile and subscription tier
newsblur_mark_stories_read
Mark stories read by hash, feed, or folder
newsblur_save_story
Save a story with tags, notes, and highlights
newsblur_unsave_story
Remove from saved stories
newsblur_subscribe
Subscribe to a feed by URL
newsblur_unsubscribe
Remove a feed subscription
newsblur_organize_feed
Move feeds between folders, rename feeds/folders
newsblur_share_story
Share to your blurblog with comments
newsblur_train_classifier
Train like/dislike on title, author, tag, or feed
newsblur_get_classifiers
View all trained intelligence classifiers
newsblur_discover_feeds
Search, similar, or trending feed discovery
newsblur_manage_notifications
View/configure per-feed notifications
Prompt templates
The MCP server includes prompt templates for common workflows:
Daily Briefing - Summarize today's unread stories by folder
Triage Inbox - Review and categorize unread stories, save interesting ones
Research Topic - Search feeds and saved stories on a topic
Train from Reading - Analyze reading patterns and suggest classifier rules
Feed Health Check - Audit subscriptions for dead or unused feeds
Discover New Feeds - Find feeds based on interests
Self-hosted MCP server
If you self-host NewsBlur, the MCP server runs as a separate container on port 8099:
docker compose up newsblur_mcp
Point your MCP client to https://your-newsblur-domain/mcp/.
Contributing
NewsBlur welcomes contributions! The development workflow:
Web and Node servers restart automatically when code changes
Run make after git pull to apply migrations
See AGENTS.md for code style and development conventions
Support
Hosted service: newsblur.com (recommended)
Questions, suggestions, and bugs: forum.newsblur.com
The most recent commit recorded on samuelclay/NewsBlur was 3 months ago, based on the GitHub push timestamp. The repository has 1.0k forks — one of the better signals of community interest.
Is samuelclay/NewsBlur open source?
Yes — samuelclay/NewsBlur ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/samuelclay/NewsBlur.
What license does samuelclay/NewsBlur use?
samuelclay/NewsBlur is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is samuelclay/NewsBlur associated with?
GitHub's repository topics for samuelclay/NewsBlur: "android", "elasticsearch", "feed-reader", "ios", "mongodb", "postgresql", "python", "redis", "rss", "rss-reader". TopGit's editorial category is Data.
Where can I see samuelclay/NewsBlur in action?
The project maintains a homepage at http://www.newsblur.com. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about samuelclay/NewsBlur?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/samuelclay/NewsBlur is the definitive source.
Read full README in the tab above.
Is NewsBlur worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of NewsBlur.