2013-03-17 23:16:25 +01:00
|
|
|
Miniflux - Minimalist News Reader
|
2013-02-18 03:48:21 +01:00
|
|
|
=================================
|
|
|
|
|
|
|
|
|
|
Miniflux is a minimalist web-based news reader.
|
|
|
|
|
|
|
|
|
|
Features
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
- Host anywhere (shared hosting, vps or localhost)
|
|
|
|
|
- Easy setup => copy and paste and you are done!
|
|
|
|
|
- CSS optimized for readability
|
|
|
|
|
- Keep an history of read items
|
|
|
|
|
- Remove Feedburner Ads and analytics trackers
|
|
|
|
|
- Import/Export OPML feeds
|
|
|
|
|
- Feeds update by a cronjob or with the user interface in one click
|
|
|
|
|
- Protected by a login/password (only one possible user)
|
|
|
|
|
- Use secure headers (only external images are allowed)
|
2013-02-24 20:09:16 +01:00
|
|
|
- Open external links inside a new tab with a `rel="noreferrer"` attribute
|
2013-03-17 23:16:25 +01:00
|
|
|
- Mobile CSS (responsive design)
|
2013-02-18 03:48:21 +01:00
|
|
|
|
|
|
|
|
Todo
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
- Remove older items from the database
|
|
|
|
|
|
2013-03-17 23:30:07 +01:00
|
|
|
License
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
- AGPL: <http://www.gnu.org/licenses/agpl-3.0.txt>
|
|
|
|
|
|
2013-02-18 03:48:21 +01:00
|
|
|
Requirements
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
- PHP >= 5.3
|
2013-03-17 23:16:25 +01:00
|
|
|
- PHP XML extensions (SimpleXML, DOM...)
|
|
|
|
|
- PHP Sqlite extensions
|
2013-02-18 03:48:21 +01:00
|
|
|
|
2013-03-17 23:16:25 +01:00
|
|
|
Libraries used
|
|
|
|
|
--------------
|
2013-02-18 03:48:21 +01:00
|
|
|
|
|
|
|
|
- [PicoFeed](https://github.com/fguillot/picoFeed)
|
|
|
|
|
- [PicoFarad](https://github.com/fguillot/picoFarad)
|
|
|
|
|
- [PicoTools](https://github.com/fguillot/picoTools)
|
|
|
|
|
- [PicoDb](https://github.com/fguillot/picoDb)
|
|
|
|
|
- [SimpleValidator](https://github.com/fguillot/simpleValidator)
|
|
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
2013-03-17 23:16:25 +01:00
|
|
|
1. You must have a web server with PHP installed (version 5.3 minimum) with the Sqlite and XML extensions
|
|
|
|
|
2. Download the source code and copy the directory miniflux where you want
|
|
|
|
|
3. Check if the directory data is writeable (Miniflux store everything inside a Sqlite database)
|
|
|
|
|
4. With your browser go to <http://yourpersonalserver/miniflux>
|
|
|
|
|
5. The default login and password is admin/admin
|
|
|
|
|
6. Start to use the software
|
|
|
|
|
|
|
|
|
|
FAQ
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
### How to update your feeds with a cronjob?
|
|
|
|
|
|
|
|
|
|
You just need to be inside the directory `miniflux` and run the script `cronjob.php`.
|
|
|
|
|
|
|
|
|
|
By example:
|
|
|
|
|
|
|
|
|
|
crontab -e
|
|
|
|
|
|
|
|
|
|
0 */4 * * * cd /path/to/miniflux && php cronjob.php >/dev/null 2>&1
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### How Miniflux update my feeds from the user interface?
|
|
|
|
|
|
|
|
|
|
Miniflux use an Ajax request to refresh each subscription.
|
|
|
|
|
By default, there is only 5 feeds updated in parallel.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### I have 600 subscriptions, how Miniflux handle that?
|
|
|
|
|
|
|
|
|
|
Your life is cluttered.
|
