Multifeeding RSS streams into points of access.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

62 lines
1.4 KiB

4 years ago
# 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!