NOTE: Datastringer is still under heavy development. Please check out the releases and changelog
Works on Ubuntu-based OS only. See the issue for installing on Mac OS
Data stringer: the exact equivalent of wire agencies' (AFP/AP/Reuters) local journalists who feed the organisation with news (called wires). Except that here, that's a software living in a dataset, not in Iran, that's going to do the job.
Getting started with Datastringer is easy:
Just clone the repo and run the installation script located at its root. You only have to do this once.
$ git clone http://github.com/BBC-News-Labs/datastringer.git && cd datastringer
$ ./install.sh
install.sh will take care of installing the needed dependencies:
- node
- npm
- postifx (needed to be able to send mail)
It will then proceed to fetch node modules dependencies.
The install script has been written and tested on Linux Ubuntu 14.04.
A Dockerfile is also available to build a datastringer Docker image:
- Build with
docker build -t datastringer .(This will expose port 3000 which should be mapped when running a container) - Run with
docker run -d -p 3000:3000 datastringer - Visit
http://localhost:3000
node wizard.js will start a small web server. Point towards
localhost:3000 with your favourite web browser.
When you are done with the configuration, you can stop the server by CTRL-Cing it.
You just set up your first datastringers with two basic examples. You will be notified by email when alerts are triggered! Here is what these examples do.
Datastringer is built on Javascript and Node.js, and we make sure it won't be hard for you to extend it. Refer to the documentation to understand the architecture, rummage the examples and... build your own stringers!
Before submitting pull-requests, please refer to the road-map.
Datastringer is distributed under the MIT License, and developed by Basile Simon, Clément Geiger, for BBC News Labs. Read more about the MIT License.