Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Liferea Official Development
C Python Other
Failed to load latest commit information.
css Fixes #49: incorrect path in help
doc Fixes Github #195: Out-dated documentation on enclose download (repor…
dtd *** empty log message ***
glade Simplied external browser handling. Now Liferea only supports the gtk…
man Updated my mail address everywhere.
opml Fixes Github #134: Broken default news feed (reported by pvdl)
pixmaps Add symbolic icon suitable for HighContrast.
plugins German translation for .plugin files.
po Update ru.po
src Fixes Github #78: Shaky text in feed list (reported by GreenLunar)
xslt Proper text direction for error box.
.gitignore Ignore tests binaries
.travis.yml Fix webkit dependency for Travis
AUTHORS Merge changes from #153 to master
COPYING Fixes SF #1041: Some GPLv2 license headers were outdated (reported by…
ChangeLog Fixes Github #78: Shaky text in feed list (reported by GreenLunar)
INSTALL get rid of missing, depcomp, and install-sh because they are auto-gen…
Makefile.am Add missing libnotify plugin from release tarballs #39
README.md Use header for important part of the README
autogen.sh check for libtool in autogen.sh
configure.ac Pre-release version bump.
liferea.appdata.xml.in Extend appdata to reflect 1.11
liferea.convert Simplied external browser handling. Now Liferea only supports the gtk…
liferea.desktop.in Github #193: Added x-scheme-handler/feed to desktop file (suggested b…
net.sf.liferea.gschema.xml.in Simplied external browser handling. Now Liferea only supports the gtk…

README.md

build status git master Coverity Scan Build Status

Introduction

Liferea is a desktop feed reader/news aggregator that brings together all of the content from your favorite subscriptions into a simple interface that makes it easy to organize and browse feeds. Its GUI is similar to a desktop mail/newsclient, with an embedded graphical browser.

screenshot

Installation from Package

We do not provide packages, but others do. Detailed instructions on how to get Liferea packages installed on the different distributions can be found at http://lzone.de/liferea/install.htm

Building Liferea Yourself

This section describes how to compile Liferea yourself. If you have any problems compiling the packages or from GIT don't hesitate to contact us in IRC (see Support section) to help you with it!

Dependencies

Liferea 1.11+ is to be built against GTK+ 3. If you need to build for GTK+ 2 please use the most recent 1.8 release.

The compilation and runtime dependencies are:

Mandatory:

gtk3 libxml2 libxslt sqlite3 libwebkit3 libjson-glib libgirepository1.0 libpeas gsettings-desktop-schemas

Optional:

  • For the keyring support
    • Python >= 2
  • For the media player plugin
    • Python >= 2
    • GStreamer 0.10+ library and codecs

Ensure that you have installed the libraries and their headers. If you use distribution packages then you usually need to install a package named like the library and one with a suffix "-dev" or "-devel". You need both to compile Liferea.

Compiling from Tarball

Download a tarball from https://github.com/lwindolf/liferea/releases and extract and compile with

tar jxvf liferea-1.11.0.tar.bz2 
./configure
make
make install
Compiling from Git

Check out the code:

git clone https://github.com/lwindolf/liferea.git

Then build it with:

./autogen.sh
make
make install

Contributing

This section describes how you can contribute to Liferea. We currently try to provide additional help on contributing via OpenHatch.org which provides help and easy tasks to start contributing.

http://openhatch.org/+projects/Liferea

As the project is hosted at Github pull requests and tickets via Github are the best way to contribute to Liferea.

Translating

Before starting to translate you need a translation editor. We suggest to use poedit or gtranslator. Please edit the translation using such a translation editor and send us the resulting file. Once you have finished your work please send us the resulting file.

Please do not send translation patches. Those are a lot of work to merge and the bandwidth saving is not that huge!

New Translations

To create a new translation you must load the translation template, which you can find in the release tarball as "po/liferea.pot", into the translation editor. After editing it save it under a new name (usually your locales name with the extension ".po").

Updating Translations

When updating an existing translation please ensure to respect earlier translators work. If the latest translation is only a few months old please contact the latest translator first asking him to review your changes especially if you change already translated literals.

Localizing Feed Lists

When Liferea starts for the first time it installs a localized feed list if available. If this is not the case for your locale you might want to provide one. To check if there is one for your country have a look into the "opml" subdirectory in the latest release tarball or GIT.

If you want to provide/update a localized feed list please follow these rules:

  • Keep the English part of the default feed list
  • Only add neutral content feeds (no sex, no ideologic politics, no illegal stuff)
  • Provide good and short feed titles
  • Provide HTML URLs for each feed.

Once finished post the result OPML file in the mailing list or the SF patch tracker.

Creating Plugins

Liferea 1.10+ support GObject Introspection based plugins using libpeas. The Liferea distribution comes with a set of Python plugin e.g. the media player, GNOME keyring support, a tray icon plugin and maybe others.

Why We Use Plugins?

The idea behind plugins is to extend Liferea without changing compile time requirements. With the plugin only activating if all its bindings are available Liferea uses plugins to automatically enable features where possible.

How Plugins Interact With Liferea

You can develop plugins for your private use or contribute them upstream. In any case it makes sense to start by cloning one of the existing plugins and to think about how to hook into Liferea. There are two common ways:

  • using interfaces,
  • or by listening to events on Liferea objects,
  • or not at all by just controlling Liferea from the outside.

The media player is an example for 1.) while the tray icon is an example for 3.) If you find you need a new plugin interface (called Activatables) in the code feel free to contact us on the mailing list. In general such a tight coupling should be avoided.

About the exposed GIR API: At the moment there is no stable API. Its just some header files fed into g-ir-scanner. Despite this method names of the core functionality in Liferea has proven to be stable during release branches. And if you contribute your plugin upstream it will be updated to match renamed functionality.

Testing Plugins

To test your new plugin you can use ~/.local/share/liferea/plugins. Create the directory and put the plugin script and the .plugin file there and restart Liferea.

Watch out for initialization exceptions on the command line as they will permanently disable the plugin. Each time this happens you need to reenable the plugin from within the plugin tab in the preferences dialog!

How to Help With Testing
Bug Reports

If you want to help with testing grab the latest tarball or follow GIT master and write bug reports for any functional problem you experience. If you have time help with bug triaging the SF tracker. Check if you see any of the open bugs on your setup.

Debugging Crashes

In case of crashes create gdb backtraces and post them in the bug tracker. To create a backtrace start Liferea using "gdb liferea". At the gdb prompt type "run" to start the execution and "bt" after the crash. Send us the "bt" output!

Note: Often people confuses assertions with crashes. Assertions do halt the program because of a totally unexpected situation. Creating a backtrace in this situation will only point to the assertion line, which doesn't help much. In case of an assertion simply post a bug report with the assertion message.

Debugging Memory Leaks

If you see memory leakage please take the time to do a run

valgrind --leak-check=full liferea

to identify leaks and send in the output.

Browser Integration

Liferea allows subscribing directly from Firefox 2.0+ and Epiphany.

Ephiphany

Epiphany provides a standard plugin that allows adding subscription directly to Liferea. Ensure you have installed the Epiphany plugins (often a separate package in the distribution) and enabled the plugin in the Epiphany settings.

Firefox 2.0+

If you want to subscribe from within Firefox 2.0 you can configure Firefox 2.0 to add subscriptions to Liferea directly. To do so click the feed icon in the location entry. Firefox will then present a menu where you can configure a manual command instead of the Live Bookmarks to add subscriptions. Liferea supplies a script named "liferea-add-feed" that you can tell Firefox to use.

If this doesn't work for you please try to run "liferea-add-feed" from the command line and look for error messages. Often DBUS problems cause the script to fail.

How to Get Support

When using distribution packages:

Do not post bug reports in the Liferea bug tracker, use the bug reporting system of your distribution instead. We (upstream) cannot fix distribution packages!

Before getting support for stable releases:

Install the latest stable release and check if the problem is solved already. Please do not ask for help for older releases!

Now there are three major support channels:

Hopefully we can help with your problem.

Something went wrong with that request. Please try again.