Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/defcon-007/personal-naarad

A personal naarad instance
https://github.com/defcon-007/personal-naarad

Last synced: 17 days ago
JSON representation

A personal naarad instance

Awesome Lists containing this project

README

        

Naarad
======

Naarad aggregates all your KGP related news from facebook pages to one place.Go to http://naarad.metakgp.org to see it working.

## How does it work?

Naarad gets the content from the specified pages using Facebook's graph API. We
use [facepy](https://github.com/hargup/facepy) as the python frontend for the
api.

## How to use Naarad

* Get a Facebook API token and save it in file name `ACCESS_TOKEN`. See this [StackOverflow Answer](http://stackoverflow.com/a/16054555/1780891).
* Naarad runs exclusively on Python 3, you can [conda](http://conda.pydata.org/miniconda.html) to easily switch between Python 2 and Python 3 environments.
* Install `facepy`. As of now you'll have to use `hargup`'s fork of `facepy` as
the code in the original repository doesn't handle downloading of image
files well. Pull Request is in process.
* Clone https://github.com/hargup/facepy
* Change into the directory and do `pip install -e .`
* Run `deploy.sh` to push the changes to `master`. The website is generated
through the `docs/` directory. `deploy.sh` runs
`fbscrapper.py` which creates json files containing feeds, and then runs
`frontend.py` which converts the json feed into into nice html according to
a template specified in `feed.tmpl`.

## License

AGPL