woodwind/README.md
Kyle Mahan c8f7213b39 fix the woefully outdated requirements and installation instructions
fixes #53
fixes #54

Thanks for the heads up @Jeena (I guess I hadn't looked at the readme in
about a year...) and sorry it was a pain to get running!
2016-05-21 08:00:09 -07:00

46 lines
1.1 KiB
Markdown

Woodwind
========
[![Requirements Status](https://requires.io/github/kylewm/woodwind/requirements.svg?branch=master)](https://requires.io/github/kylewm/woodwind/requirements/?branch=master)
A minimum viable stream-style feed reader.
Supports mf2 h-feed and xml feeds (thanks to Universal Feed Parser).
Installation
----------
How to run your own instance of Woodwind. You'll first need to make
sure you have *Postgres* and *Redis* installed and running.
```bash
git clone https://github.com/kylewm/woodwind.git
cd woodwind
```
Set up the virtualenv and install dependencies.
```bash
virtualenv --python=/usr/bin/python3 venv
source venv/bin/activate
pip install -r requirements.txt
```
Copy woodwind.cfg.template to woodwind.cfg and edit it to check the
Postgres connection string.
Then create database tables and run Woodwind.
```bash
# create the postgres database
createdb woodwind
# copy and edit the configuration file
cp woodwind.cfg.template woodwind.cfg
nano woodwind.cfg
# create the database tables
python init_db.py
# finally run the application
uwsgi woodwind-dev.ini
```
Now visit localhost:3000, and you should see the login screen!