JARR (which stands for Just Another RSS Reader) is a web-based news aggregator and reader.

JARR is under ongoing developments and functionnalities are regularly added. For past and futur updates see the milestones. However JARR is stable and can function as easily on a light installation with the python SimpleHTTP server and a SQLite database or on a more heavy setup with nginx or apache running against a PostGreSQL database.

It's recommended to install JARR inside a virtualenv. Python3.4 is required.

virtualenv venv
source venv/bin/activate

If you want to connect JARR to your PostgreSQL you'll have to have PostgreSQL install:

# for debian stable
sudo apt install postgresql-server-dev-9.4

And to create your database:

sudo -u postgres createuser <your user> --no-superuser --createdb --no-createrole
sudo -u postgres createdb jarr --no-password

ALTER USER <your user> WITH ENCRYPTED PASSWORD '<your password>';
GRANT ALL PRIVILEGES ON DATABASE jarr TO '<your user>';

You'll then have to specify as database URI postgres://<your user>:<your password>@127.0.0.1:5432/jarr. Otherwise you can use the default sqlite db plug.

Once it's done, execute the script install.py, it will prompt you various configuration values that you'll be able to edit later on in src/conf.py or by running that script again. If you do so, you may want to run it with the option --no-db to avoid erasing your already created database (more option are available with --help).

NOTE: If you don't have npm installed, the install script won't be able to build the JS file and will propose you to use the one I host on my server. npm not being available in standard debian installation, I advise you to STFW if you want the JS to be available locally.

NOTE: Various OAuth providers are available as authentication provider for JARR. If you want to use those, you can register your JARR application as an app in google console, facebook applications or twitter applications. Once it's done, you'll have the possibility to set it for JARR through the install process or by editing the conf.py file.

You must then set the crawler to be run once every few minutes with a limited number of feed or once every few hour with all the feeds. I use crontab for that :

*/2 * * * * cd {root};source venv/bin/activate;./manager.py fetch --limit 20 -r

The master branch should always be working and it is recommended you install the project using this one. Partial or unstable change maybe present in the develop branch even if it'll be avoided as much as we can. So if you're planning on using the project from the source, you should be using the master branch only, but, if you're proposing patches, please make your pull request against the develop branch.

If you have already installed JARR and want to upgrade to a later version, you may encounter some problem if some change have appeared in the model. To fix this, upgrade your database with the following commaned :

./manager.py db upgrade

JARR is under the GNU Affero General Public License version 3.