Self-host kriss_feed
8.26Simple, database-free RSS feed reader in PHP
- Stars
- 292
What is kriss_feed?
KrISS feed is a simple, self-hosted RSS/Atom feed reader written in PHP. It requires no SQL database, storing all data in flat files within a data directory, and works with PHP 5.2 or newer. Installation is as simple as uploading a single index.php file to any PHP-enabled web server and setting a login and password. Features include OPML import/export, starred items, list and expanded views, keyboard shortcuts, auto-mark-as-read, feed favicons, public/protected/private visibility modes, manual/JavaScript/cron updates, and internationalization. The UI is responsive for mobile use and fully usable without JavaScript. Themes can be added by dropping a user.css file into the inc directory, and version 8 added a plugin system. It integrates with Shaarli for sharing articles. The project has been actively maintained since 2012 with the latest version 8.26.
Should you self-host kriss_feed?
kriss_feed scores 48/100 on selfhost.directory (how scoring works) and ranks #37 of 85 in Feed Reader. It has 292 GitHub stars.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is easy: most people get it running in one sitting. It is Copyleft-licensed and written mostly in PHP.
Its closest alternative on selfhost.directory is NewsBlur (68/100, 7 674 stars). It scores higher overall, so compare the two before you pick. See kriss_feed vs NewsBlur side by side.
Features
- Auto mark as read
- Customizable Themes
- Feed favicons
- Flexible update methods
- Internationalization
- Keyboard Shortcuts
- List and expanded views
- Multiple visibility modes
- No Database Required
- OPML Import/Export
- Plugin System
- Shaarli sharing integration
- Starred Items
- Works without JavaScript
kriss_feed README
FAQ
How is KrISS feed organized for developers?
Source code is in the src directory with class/ for PHP classes, tpl/ for templates, inc/ for includes, and a generateIndex script to compile the single-file index.php.
How to stay signed in?
Create plugins and sessions directories, then create a session.php file in plugins with session.gc_maxlifetime and session.save_path settings to extend session lifetime to 1 day (86400 seconds).
How to reset KrISS feed password?
You cannot reset the password; if forgotten, delete the data/config.php file and reload the page to set a new login and password.
Does it work on free.fr?
No, external accesses have been disabled on free.fr since December 1, 2008.
Why can I not add or update my feeds properly?
Check your feed validity at validator.w3.org/feed/ — KrISS feed uses libxml2 and will fail if the feed is not well-formed. Contact the feed owner to correct their feed.
What is KISS philosophy?
KrISS feed follows the KISS principle (Keep It Simple and Smart) — accessible to everyone with no SQL database to configure and a single file to copy, while keeping the source code easy to understand and well structured.
Why did I create KrISS feed?
The creator was using Google Reader and was unhappy when Google integrated Google+; existing alternatives like rssLounge and Tiny Tiny RSS didn't meet their needs, so they built their own.
More in Feed Reader
LeedLeed is a lightweight, open-source RSS/ATOM feed reader you host on your own server. Uses cron for background sync, supports OPML, responsive on all devices.
LetterFeedLetterFeed is a self-hosted, open-source app that converts email newsletters into RSS feeds by scanning an IMAP mailbox.
lurkerLurker is a self-hosted, open-source read-only Reddit client that renders well on mobile, respects system dark mode, and requires no Reddit account.
matchaMatcha is a self-hosted, open-source CLI tool that creates daily markdown digests from RSS feeds with optional LLM summaries, weather, and Instapaper bookmarking.
minifeed.railsMinimalist self-hosted RSS/Atom feed reader with native iOS app. Supports categories, bookmarks, OPML, multi-user, keyboard shortcuts, light/dark themes.
MinifluxSelf-hosted, open-source RSS/Atom feed reader in Go: one static binary plus PostgreSQL, full-text search, OPML import, and privacy-focused link cleaning.
miniflux-indexerSelf-hosted CLI tool that indexes Miniflux feed entries using sego for Chinese text segmentation, enabling better full-text search. Requires PostgreSQL 9.6+.
miniflux-phpMiniflux is a minimalist, self-hosted, open-source RSS reader with a clean web interface, multiple user support, themes, and API access for mobile apps.
mkfdSelf-hosted, open-source tool that builds RSS feeds from websites, email inboxes, APIs and other sources without native feeds. Runs in Docker or via Bun.
morssMorss is a self-hosted, open-source tool that expands truncated RSS feeds by fetching full articles from source websites.
MyTubeOpen-source and self-hosted: grab videos from yt-dlp's 1000+ sites (YouTube, Bilibili, Twitch included), build collections, watch in-browser, auto-download subscriptions.
nebulapickerA self-hosted RSS tool that collects feeds, applies custom filters, and outputs curated feeds. Offers Wallabag connection for saving full articles.
0 comments