django-feedme 1.0

Django Feed Me
==============

[](https://travis-ci.org/dstegelman/django-feedme)
[](https://crate.io/packages/django-feedme/)



Django Feed Me is a replacement for Google Reader. It keeps track of your feeds, fetches the RSS feeds
and parses them in an easy to read interface. This is currently in development. The app works as POC using the Django
Admin. A separate interface for adding feeds is coming down in the pipeline.


Installation
------------

To install FeedMe simply:

pip install django-feedme

Add ``feedme`` to your installed apps. Add route a url to ``feedme.urls``

Make sure to syncdb or migrate the app:

python manage.py syncdb
python manage.py migrate


If you want to use Celery for fetching (Recommended) then add:

FEED_UPDATE_CELERY = True

to your settings file. Make sure you've installed and configured Celery properly. The syntax used should be good
for both Celery 2 and 3.

This app bundles static and works out of the box with django static files. If you aren't collecting static
you'll need to copy the static directory to where ever you serve static from.

Dependencies
------------

As of FeedMe 1.0 feedme requires Django 1.5 and above.

Feedme also requires the use of the django-bootstrap-static library for some static files. It is bundled in setup.py so by installing this package
it should already be downloaded to your machine. In order to have the bootstrap files picked up by your static files hanlder, you'll need to add
```bootstrap``` to installed apps. This will alow Django's static files to pick up the boostrap files.


Celery Beat
-----------

To make use of the Celery beat schedule to automatically update feeds at given intervals, open your settings file and
enter something like the following:

import datetime


CELERYBEAT_SCHEDULE = {
"feed-updates": {
"task": "update_all_feeds",
"schedule": datetime.timedelta(hours=1),
},
}

More documentation for Celery can be found at the CeleryProject.

Contributions
-------------

Please place all bug reports in Github Issues. Pull requests are welcome and encouraged!!


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

This document and more formal documentation at http://django-feedme.readthedocs.org/en/latest/


Additional Planned Features
---------------------------

* Import feeds from Google Reader
* Add and manage feeds from the front end (rather than Django Admin)
* Mark all or some feeds as read/unread
* Look and Feel updates
* Tests

Questions/Comments/Hate Mail?
-----------------------------

Drop an issue in Github and I'll be sure to find it.