cd13efeabf
Only the unread counter is updated right know. The AutoUpdate Feature is designed on the premise of don't wasting resources. A distinction is made between updates when Miniflux is visible or hidden. To determine the visibility status, the Page Visibility API is used. The API is available starting with Chrome 33, Firefox 18 and IE10. [https://developer.mozilla.org/en-US/docs/Web/Guide/User_experience/Using_the_Page_Visibility_API] As IE9 returns an undefined, it doesn't break the compatibility at least. If Miniflux is visible, the unread counter on the web page is updated as soon as a mismatch between the counter and the number of unread articles in the database is found. If Miniflux is hidden, the timestamp of the most recent article from each feed is compared with the value from the last run. We have an update If the timestamp of the latest article is greater than the stored one and the latest article is unread. The web page title is updated with a ? symbol to notify the user and the update check pauses till Miniflux gets visible again. If Miniflux gets visible again, the number of unread articles is queried from the database, the unread counter on the web page is updated and finally the ? symbol is removed from the web page title. This way I can use my fever API client to read new articles (or at least the latest article) while Miniflux is hidden and as I've seen the new articles already a new articles notification is prevented. It's intentionally that the page does not reload automatically as long as articles are visible. If I'm in hurry, I only scroll through the articles to spot something interesting. Most of the time I don't reach the last article. If the page is reloaded while I'm away, I would have to scan from the top again. If we're on a nothing_to_read page and have unread articles in the database, a redirect to the unread page will be done. The default update check interval is 10 minutes and can be changed on the settings page. A zero value disables the update check entirely. fixes #213 |
||
|---|---|---|
| assets | ||
| controllers | ||
| data | ||
| docs | ||
| fever | ||
| lib | ||
| locales | ||
| models | ||
| scripts | ||
| templates | ||
| tests/integration | ||
| themes | ||
| vendor | ||
| .gitattributes | ||
| .gitignore | ||
| .htaccess_ovh | ||
| Dockerfile | ||
| LICENSE | ||
| README.markdown | ||
| check_setup.php | ||
| common.php | ||
| composer.json | ||
| config.default.php | ||
| cronjob.php | ||
| favicon.ico | ||
| index.php | ||
| jsonrpc.php | ||
| phpunit.xml | ||
| robots.txt | ||
README.markdown
Miniflux - Minimalist News Reader
Miniflux is a minimalist and web-based RSS reader.
Features
Host almost anywhere
- Your Raspberry Pi, a shared web-hosting, a virtual machine or localhost
- Easy setup => copy and paste the source code and you are done!
- Use a lightweight Sqlite database instead of Mysql or Postgresql
Readability
- CSS optimized for readability
- Responsive design
Privacy and security
- Remove Feedburner Ads and analytics trackers (1x1 pixels)
- Open external links inside a new tab with a
rel="noreferrer"attribute - Use secure HTTP headers (only external images and Youtube/Vimeo/Dailymotion videos are allowed)
- Article content is filtered before being displayed
Polyglot
- Translated in English, French, German, Italian, Czech, Spanish, Portuguese and Simplified Chinese
- RTL languages support
Awesome features
- Keyboard shortcuts
- Full article download for feeds that display only a summary
- Bookmarks
- Send your favorite articles to Pinboard and Instapaper
- Enclosure support (videos and podcasts)
- Feed updates via a cronjob or with the user interface with one click
More
- Keeps history of read items
- Import/Export of OPML feeds
- Themes
- Auto-update from the user interface
- Multiple databases (each user has his own database)
- Image proxy to avoid mixed content warnings with HTTPS
Requirements
- Recent version of libxml2 >= 2.7.x (version 2.6.32 on Debian Lenny is not supported anymore)
- PHP >= 5.3.3
- PHP XML extensions (SimpleXML and DOM)
- PHP Sqlite extension
- cURL extension for PHP or Stream Context with
allow_url_fopen=On
Documentation
- Installation
- Upgrade to a new version
- Cronjob
- Advanced configuration
- Full article download
- Multiple users
- Translations
- Themes
- Json-RPC API
- Fever API
- Run Miniflux with Docker
- FAQ
- Tests
Related projects
External projects build around Miniflux:
- Miniflux embedded is an Android app for Miniflux. It's basically an embedded WebView that saves your Miniflux URL and cookies. Download on the Play Store.
- munin-miniflux is a munin wildcard plugin to draw graphs of your miniflux read and unread count.
- Hello Theme Theme for Miniflux.
Todo and known bugs
- See Issues: https://github.com/fguillot/miniflux/issues
License
Authors
Original author: Frédéric Guillot
Contributors
People who sent a pull-request, report a bug, make a new theme or share a super cool idea:
- André Kelpe
- Augustin Lacour
- Ayodio
- Bjauy
- Bohwaz
- Chase Arnold
- Chris Lemonier
- Delehef
- Derjus
- Eauland
- Félix
- Geriel Castro
- Hika0
- Horsely
- Ing. Jan Kaláb
- Itoine
- Kordian Bruck
- James Scott-Brown
- James Barwell
- Julian Oster
- Jarek
- Kaminary Shadows
- Luca Marra
- Martin Simon
- Mathias Kresin
- Maxime
- Meradoou
- MonsieurPaulLeBoulanger
- Necku
- Nicolas Dewaele
- Pcwalden
- Pitel
- Silvus
- Skasi7
- Thiriot Christophe
- Tobi
- Vincent Ozanam
- Ygbillet
Many people also sent bug reports and feature requests.