miniflux-legacy/README.markdown

Miniflux - Minimalist News Reader
=================================

[![Build Status](https://travis-ci.org/miniflux/miniflux.svg?branch=master)](https://travis-ci.org/miniflux/miniflux)

[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/miniflux/miniflux/tree/master)

Miniflux is a minimalist and web-based RSS reader.

Features
--------

- Self-hosted
- Readability (CSS optimized for readability, responsive design, compatible with mobile and tablet devices)
- Easy setup => **copy and paste the source code and you are done!**
- Remove Feedburner Ads and analytic 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
- Translated in Arabic, English, French, German, Italian, Japanese, Czech, Spanish, Turkish, Portuguese, Russian, Serbian and Simplified Chinese
- RTL languages support
- Keyboard shortcuts
- Full article download for feeds that display only a summary
- Bookmarks
- Groups for categorization of feeds (like folders or tags)
- Send your favorite articles to Pinboard, Instapaper or Wallabag
- Enclosure support (videos and podcasts)
- Feed updates via a cronjob or with the user interface in one click
- Keeps history of read items
- Import/Export of OPML feeds
- Themes
- Multiple users
- Image proxy to avoid mixed content warnings with HTTPS

Documentation
-------------

- [ChangeLog](https://github.com/miniflux/miniflux/blob/master/ChangeLog)
- [Installation and Requirements](docs/installation.markdown)
- [Upgrade to a new version](docs/upgrade.markdown)
- [Cronjob](docs/cronjob.markdown)
- [Advanced configuration](docs/config.markdown)
- [Full article download](docs/full-article-download.markdown)
- [Translations](docs/translations.markdown)
- [Themes](docs/themes.markdown)
- [Json-RPC API](docs/json-rpc-api.markdown)
- [Fever API](docs/fever.markdown)
- [Run Miniflux with Docker](docs/docker.markdown)
- [FAQ](docs/faq.markdown)

License
-------

- AGPLv3: <http://www.gnu.org/licenses/agpl-3.0.txt>

Authors
-------

- Original author: [Frédéric Guillot](https://github.com/fguillot)
- [List of contributors](CONTRIBUTORS.md)

Related projects
----------------

External projects build around Miniflux:

- [Miniflux embedded](https://github.com/repat/miniflux-embedded-android) is an Android app for Miniflux. It's basically an embedded WebView that saves your Miniflux URL and cookies. [Download on the Play Store](https://play.google.com/store/apps/details?id=de.repat.embeddedminiflux).
- [munin-miniflux](https://github.com/dewey/munin-plugins/tree/master/munin-miniflux) is a munin wildcard plugin to draw graphs of your miniflux read and unread count.
- [List of themes](docs/themes.markdown)
Big update 2013-03-17 18:16:25 -04:00			`Miniflux - Minimalist News Reader`
first commit 2013-02-17 21:48:21 -05:00			`=================================`

Move get_ip_address() and get_user_agent() to Request namespace 2016-08-17 21:27:05 -04:00			`[![Build Status](https://travis-ci.org/miniflux/miniflux.svg?branch=master)](https://travis-ci.org/miniflux/miniflux)`

Add Heroku button 2017-01-02 18:34:11 -05:00			`[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/miniflux/miniflux/tree/master)`

Improve documentation 2014-04-06 12:02:45 -04:00			`Miniflux is a minimalist and web-based RSS reader.`
first commit 2013-02-17 21:48:21 -05:00
			`Features`
			`--------`

Update API documentation 2016-12-29 18:52:37 -05:00			`- Self-hosted`
Update README 2015-04-06 13:51:02 -04:00			`- Readability (CSS optimized for readability, responsive design, compatible with mobile and tablet devices)`
			`- Easy setup => copy and paste the source code and you are done!`
Update documentation 2015-12-07 21:05:31 -05:00			`- Remove Feedburner Ads and analytic trackers (1x1 pixels)`
Update readme 2013-02-24 14:09:16 -05:00			- Open external links inside a new tab with a `rel="noreferrer"` attribute
Improve documentation 2014-04-06 12:02:45 -04:00			`- Use secure HTTP headers (only external images and Youtube/Vimeo/Dailymotion videos are allowed)`
			`- Article content is filtered before being displayed`
Update readme 2016-03-08 22:18:47 -05:00			`- Translated in Arabic, English, French, German, Italian, Japanese, Czech, Spanish, Turkish, Portuguese, Russian, Serbian and Simplified Chinese`
Update of PicoFeed 2014-03-16 22:17:44 -04:00			`- RTL languages support`
Improve documentation 2014-04-06 12:02:45 -04:00			`- Keyboard shortcuts`
Improve content grabber 2014-04-15 18:15:31 -04:00			`- Full article download for feeds that display only a summary`
Update readme 2014-12-24 14:44:40 -05:00			`- Bookmarks`
Added group feature and link to original author to docs - Removed mention of unsupported groups feature for Fever API + Added groups feature to feature list + Linked to Frédéric’s personal GitHub profile + Added more clients to tested with Fever API o Fixed URL typo 2015-10-10 20:21:35 +02:00			`- Groups for categorization of feeds (like folders or tags)`
Update documentation 2016-12-26 18:01:46 -05:00			`- Send your favorite articles to Pinboard, Instapaper or Wallabag`
Improve content grabber 2014-04-15 18:15:31 -04:00			`- Enclosure support (videos and podcasts)`
Update API documentation 2016-12-29 18:52:37 -05:00			`- Feed updates via a cronjob or with the user interface in one click`
Improve documentation 2014-04-06 12:02:45 -04:00			`- Keeps history of read items`
			`- Import/Export of OPML feeds`
			`- Themes`
Remove automatic software update from the user interface - This process is not considered safe - This feature might leads to potential security flaws - Miniflux focus on minimalism 2016-12-26 10:16:04 -05:00			`- Multiple users`
Add image proxy to avoid https mixed content warnings 2014-12-24 15:58:24 -05:00			`- Image proxy to avoid mixed content warnings with HTTPS`
Improve documentation 2014-04-06 12:02:45 -04:00
			`Documentation`
			`-------------`

Update API documentation 2016-12-29 18:52:37 -05:00			`- [ChangeLog](https://github.com/miniflux/miniflux/blob/master/ChangeLog)`
Move requirements to installation documentation 2017-01-02 17:29:18 -05:00			`- [Installation and Requirements](docs/installation.markdown)`
Improve documentation 2014-10-30 22:10:59 -04:00			`- [Upgrade to a new version](docs/upgrade.markdown)`
Improve documentation 2014-04-06 12:02:45 -04:00			`- [Cronjob](docs/cronjob.markdown)`
			`- [Advanced configuration](docs/config.markdown)`
			`- [Full article download](docs/full-article-download.markdown)`
			`- [Translations](docs/translations.markdown)`
			`- [Themes](docs/themes.markdown)`
Improve documentation 2014-10-30 22:10:59 -04:00			`- [Json-RPC API](docs/json-rpc-api.markdown)`
Add Fever API support 2014-10-29 21:28:23 -04:00			`- [Fever API](docs/fever.markdown)`
Move Docker files 2014-11-01 12:14:33 -04:00			`- [Run Miniflux with Docker](docs/docker.markdown)`
Improve documentation 2014-04-06 12:02:45 -04:00			`- [FAQ](docs/faq.markdown)`

Add license 2013-03-17 18:30:07 -04:00			`License`
			`-------`

Update README and contributor list 2015-06-21 09:36:53 -04:00			`- AGPLv3: <http://www.gnu.org/licenses/agpl-3.0.txt>`
Add license 2013-03-17 18:30:07 -04:00
Add author section to the readme 2013-04-05 21:58:17 -04:00			`Authors`
			`-------`

Added group feature and link to original author to docs - Removed mention of unsupported groups feature for Fever API + Added groups feature to feature list + Linked to Frédéric’s personal GitHub profile + Added more clients to tested with Fever API o Fixed URL typo 2015-10-10 20:21:35 +02:00			`- Original author: [Frédéric Guillot](https://github.com/fguillot)`
Update README and contributor list 2015-06-21 09:36:53 -04:00			`- [List of contributors](CONTRIBUTORS.md)`
Add list of contributors to the readme 2013-07-08 18:31:25 -04:00
Update README and contributor list 2015-06-21 09:36:53 -04:00			`Related projects`
			`----------------`
Add list of contributors to the readme 2013-07-08 18:31:25 -04:00
Update README and contributor list 2015-06-21 09:36:53 -04:00			`External projects build around Miniflux:`
Add list of contributors to the readme 2013-07-08 18:31:25 -04:00
Update README and contributor list 2015-06-21 09:36:53 -04:00			`- [Miniflux embedded](https://github.com/repat/miniflux-embedded-android) is an Android app for Miniflux. It's basically an embedded WebView that saves your Miniflux URL and cookies. [Download on the Play Store](https://play.google.com/store/apps/details?id=de.repat.embeddedminiflux).`
			`- [munin-miniflux](https://github.com/dewey/munin-plugins/tree/master/munin-miniflux) is a munin wildcard plugin to draw graphs of your miniflux read and unread count.`
			`- [List of themes](docs/themes.markdown)`