Liferea is an abbreviation for Linux Feed Reader. It is a news
aggregator for online news feeds. It supports a number of different
feed formats including RSS/RDF, CDF, Atom, OCS, and OPML. There are
many other news readers available, but these others are not available
for Linux or require many extra libraries to be installed. Liferea
tries to fill this gap by creating a fast, easy to use, easy to
install news aggregator for GTK/GNOME.

This documentation was last updated for Liferea version 0.6.1.

Installation
============

To install Liferea you can either get a package for your 
Linux distribution or try to compile and install Liferea
from the Source Tarball. In the following you will find
short hints for several platforms. See below to find
how to compile the tarball.

Debian:		Beginning with version 0.4.3 there are officially
		build packages maintained by Christophe Barbe. With
		0.6.1 David Moreno Garza is the new Debian maintainer.

RedHat/		Please ensure you have a libxml2 version
Fedora:		at least 2.5.10 or you will experience nasty
		segfaults. 

		Fedora Core 1 packages for 0.4.7 and 0.4.8 are available from
		http://download.fedora.us/fedora/fedora/1/i386/RPMS.testing/.
		
		Dag Wieers provides packages for both Fedora Core 1 and 2 
		which can be found at http://dag.wieers.com/packages/liferea/.
		
SuSE:		Until 0.6.0 Harry Auschner built SuSE RPMs available at the 
                SourceForge project page. For newer releases please visit this 
		package repository maintained by Pascal Bleser. There you will 
		find packages for SuSE 9.2, 9.1, 9.0 and 8.2. It is also 
		available via APT. The packages can be found at:
		
		http://ftp.gwdg.de/pub/linux/misc/suser-guru/rpm/packages/Network/liferea/
		

Gentoo:		There is an ebuild available at:

		http://www.breakmygentoo.net/ebuilds/

FreeBSD:	There are Liferea packages (built by Hye-Shik Chang) at
		
		http://www.freshports.org/net/liferea/

Fink		The Fink project also supports Liferea:

		http://fink.sourceforge.net/pdb/package.php/liferea
		
Slackware	Since 0.4.7 Dario Conigliaro builds Slackwares
		tarballs. These are available from the SourceForge
		project page.
	

Compiling from Source
=====================
		
If you want you can compile Liferea. Download the tarball from 
the SourcForge project page and extract with: 

   tar zxvf liferea-0.6.1.tar.gz 

Of course you should adjust the filename. After unpacking 
run the standard autotools commands: 

   ./configure
   make
   make install		


Upgrading to newer versions
===========================

When upgrading to 0.4.8 the cache directory structure and the save 
mechanism of the feed list will be changed. After the automatic
conversion older versions of Liferea cannot read the cache anymore
and the won't see the converted feed list anymore. To be prepared
for problems please export the feed list using the older version
of Liferea! In case of problems you can reinstall the older version
and import the backup feed list.

When upgrading to 0.5.1 the favicon format and location changes. When
downgrading you will loose all icons.

When upgrading to 0.5.2 the feed cache format was changed. When you
downgrade you will loose metadata information (the stuff displayed
in the footer).

Dependencies
============

The library dependencies for gtk2, gconf2, gtkhtml2, libxml2 and 
others are all set to 2.0.0. Maybe they could be more specific...

There is a special issue with RedHat based distributions: you 
have to install at least libxml2 2.5.10 or you will occur 
random segfaults.

If you want to use the Mozilla browser module you need a Mozilla
installation containing libgtkembedmoz.so. Every up-to-date Firefox
should bring it.

Help Wanted
===========

If you want to help please subscribe to the liferea-devel mailing 
list available on the SourceForge project page. After each release
we discuss new tasks to be done. Just join the discussion!

If you want to do a translation write a mail to the mailing list
or just upload the translation as a patch to SourceForge.

Known Problems
==============

Please check the bug list on SourceForge for known problems! If you 
don't find your problem please make a report (forum, bugs...) on 
the SourceForge project page (http://liferea.sf.net) or send emails 
to the project mailing list (liferea-devel@lists.sourceforge.net).
