# Multifeeder

Multifeeding RSS streams into an API.

This is the Multifeeder API :---), an Aggregated Publishing Interface supporting any kinds of publishing experiments. Currently the API is used to feed [Varia's TeleVex](https://televex.vvvvvvaria.org).

## Live

Multifeeder runs here: <https://multi.vvvvvvaria.org/>

Commits to this git repository will automagically update the live version!

(Multifeeder runs as a `supervisor` service, see `/etc/supervisor/conf.d/multifeeder.conf`.)

The API is updated every 10 minutes.

## API

**/API/latest/[num]**

For example: https://multi.vvvvvvaria.org/API/latest/5

(for the latest 5 posts in all feeds)

Format: `JSON`

**/API/today/**

For example: https://multi.vvvvvvaria.org/API/today/

(for the posts published today)

Format: `JSON`

**/API/past/[days]**

For example: https://multi.vvvvvvaria.org/API/past/30

(for all the posts published in the last 30 days)

Format: `JSON`

## Add a feed

Feeds can be added here in the git, by editing the file `feeds.txt`.

Leave a feed link on a new line, commit your change, and the feed will be included in the Multifeeder.

Removing a feed can be done by taking a feed link out of this list.

## Using the multifeeder locally

To install: make a virtual environment + install the dependencies.

`make setup`

To use: run the Flask application.

`make`

Open `localhost:5678` in a browser and there we go!