miniflux-legacy/README.markdown

95 lines
2.7 KiB
Markdown
Raw Normal View History

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.7
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)
- [PHP 5.5 password backport](https://github.com/ircmaxell/password_compat)
2013-02-18 03:48:21 +01:00
Installation
------------
1. You must have a web server with PHP installed (version 5.3.7 minimum) with the Sqlite and XML extensions
2013-03-17 23:16:25 +01:00
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>
2013-03-22 00:57:47 +01:00
5. The default login and password is **admin/admin**
2013-03-17 23:16:25 +01:00
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.
### Why there is no categories? Why the feature X is missing?
Miniflux is a minimalist software. Less is more.
### I found a bug, what next?
2013-03-22 00:57:47 +01:00
Report the bug to the [issues tracker](https://github.com/fguillot/miniflux/issues) and I will fix it.
You can report feeds that doesn't works properly too.
### Which browser is compatible with Miniflux?
Miniflux is tested with the last version of Mozilla Firefox, Google Chrome and Safari.
I don't use Microsoft products, then I have no idea if Miniflux works correctly with Internet Explorer.