wiki:WikiStart

Version 39 (modified by pierre-alain, 2 years ago) (diff)

--

Welcome to OpenWebReader

OpenWebReader is a Free and OpenSource multi-user feed aggregator.

/chrome/site/screenshots/0.2.1/main-home.jpg

Features

  • Support for ATOM, RSS 0.92, RSS 1 (RDF), RSS 2 formats
  • Import/export feeds in OPML format
  • Multi-lingual responsive interface, sober and fast, powered by AJAX
  • Feeds auto-discovery
  • Favicons support (requires Imagick if you want to validate the icon's integrity)
  • Mark some news easily into most spreaded services
  • Feeds tagging, with or without use of drag'n'drop
  • News tagging
  • Multi-users, two level of rights (user, administrator)
  • Full-text search
  • OpenSearch compatible
  • Documented source code
  • SSL support (HTTPS)
  • Caching system (both templates and SQL results)
  • E-tags support
  • 304 HTTP code status (not modified) support
  • Themes support
  • Plugins support

Languages

Actually only french and english are supported. If you want to add your language, feel free to have a look at source:OWR/locale/en_US/LC_MESSAGES/messages.po and contact me.

Code documentation

OpenWebReader code base documentation is available at docs.openwebreader.org.

License

OpenWebReader is released under GPL License.

Screenshots

You can see what it looks like on the screenshots page.

Demo

A demo is available at http://demo.openwebreader.org/. The login/password is demo/demo, and the user is not an administrator.

For security reason, I disabled uploading of OPML file. You still can import OPML, by giving to OpenWebReader the url of it.

The database will be resetted every day.

It is based on the Git version.

Pre-requisites

Server environment

  • UNIX-like (tested on Debian, Ubuntu, freeBSD, Arch Linux), maybe some others..
  • Web server (tested on Apache and nginx)
  • Database server (tested on MySQL and MariaDB)
  • PHP 5.3
  • PHP/cli
  • PHP/PDO
  • PHP/mbstring
  • PHP/XMLReader
  • PHP/libxml
  • PHP/gettext
  • PHP/date
  • PHP/Intl
  • PHP/SPL
  • PHP/JSON
  • PHP/PCRE
  • PHP/cURL (optionnal, but needed for servers that do not allow file_get_contents for external resources)
  • PHP/Imagick (optionnal, but recommended)
  • PHP/finfo (optionnal, but strongly recommended for security reasons)
  • PHP/memcache (optionnal)

Database

Database has to be created in utf8. The DB user must have the rights to read and write on all tables.

PHP/cli and cron

It is required to have an access to PHP cli interface and to webserver's user crontab. Also, for proper functioning of the application, you should disable open_basedir and safe_mode. So OpenWebReader may not work perfectly on shared hosting.

Supported browsers

The interface (XHTML/CSS/Javascript) has been developped for recents navigators. The Git version of OpenWebReader has been successfully tested on following navigators :

  • Firefox 3.5
  • Chromium 4.0
  • Opera 10 (some CSS properties are not yet supported by this navigator : box-shadow, text-shadow, border-radius)
  • Konqueror 4.2 (some CSS properties are not yet supported by this navigator : box-shadow)
  • Safari 4

Installation

  • Download the package
  • Uncompress the archive
  • Comment the line in the file /path/to/myOpenWebReader/install/.htaccess, comment the two lines about /install in /path/to/myOpenWebReader/.htacces and remove (or comment) the third line of file /path/to/myOpenWebReader/install/install.php (the one beginning by 'die(')
  • Point your browser to http://domain.tld/path/to/myOpenWebReader/install/install.php and follow each step. You may have a look at Configuration page for help on installing properly OpenWebReader.
  • Delete the directory /path/to/myOpenWebReader/install/ (or undo the third part of this how-to, for security reason)
  • Create the first user, which will be set as administrator automatically
  • Enjoy !

FAQs

A FAQs page is available. It will be completed over the time.

In practice

After having installed OpenWebReader on your web server, you just have to log-in and gives it the url of a website you like, it will look for presence of feed(s) (either atom, rss, or opml) and add them to your collection.

You also have the possibility to import a list of feeds from an OPML file.

You will then be able to sort your feeds by category using drag'n'drop.

You may have a look at the Tricks page.

Releases

All releases are available at the download page. You also can clone OpenWebReader with Git.

  • 2015-05-20 : 0.3a1
  • 2013-04-13 : 0.2.2
  • 2010-04-23 : 0.2.1
  • 2010-02-14 : 0.2
  • 2010-01-14 : 0.1
  • 2009-12-15 : 0.1b1
  • 2009-11-22 : 0.1a2
  • 2009-11-16 : 0.1a1

Help or questions

For every contact, send a mail at contact/no-spam/@/no-spam/openwebreader/no-spam/./no-spam/org or join the irc channel irc://irc.freenode.net/#openwebreader.

Don't have your own server ?

If you can't afford a server, or don't have the knowledge to administrate it, I can provide you an account on a instance of OpenWebReader for free. Feel free to contact me about that.

Alternatives

You may have a look at Gregarius, Tiny Tiny RSS, or Lilina.

Author

OpenWebReader is developped by Pierre-Alain Mignot. You can contact me at pierre-alain/no-spam/@/no-spam/openwebreader/no-spam/./no-spam/org.

See also Credits page.