A simple CMS to prototype creating "annotated text articles" from live tv subtitles/captions.
Inspired by SRCCON'17 workshop 'Hands on: Live fact checking TV speeches in your google docs!' And originally developed for Buenos Aires Media Party Hacks/Hackers workshop.
Builds on from the Opened Captions Annotated article system a rig to make an annotated article leveraging live tv captions, like NPR, Vox and the FT, using google docs.
This version uses an open source editor to remove the google doc dependency.
True or false?: Major political events are regularly covered on live TV, and all of them feature speakers with an agenda.
When the lens of public attention shines on politicians it is important for journalists to be able to contextualise their messages as quickly and effectively as possible.
During this session we will teach participants about open source tools that are being used today by live fact checkers to create annotated transcripts.
They will learn about how Vox, NPR, and the Financial Times deal with this process. As well as a brand new tool that can be used to annotate and generate these article ready for publication and without having to write a single line of code.
This is an hands on session, drawing on experience from SRCCON '17.
stack - optional How to build and run the code/app
clone, cd, npm install.
npm start
visit http://localhost:8001/index.html
Otherwise navigate to the working demo page
Note that only US channels coming from openedcaptions.com will be working in that page, eg C-Span. For BBC channels you need to deploy on a server, as it has a slightly different setup under the hood.
if you add an image, it is encoded in base64 and stored inside the document HTML code, so need for server side extra storage.
Videos are added as links, so you need to host them somewhere else
Use together Js.
High level overview of system architecture
The server uses the BBC MQTT Captions and converts it to a socket connection. As mqtt are not available client side unless they are served through socket.
Socket connection is running on port http://localhost:8002
Client uses quilljs as text editor and when clicking start button starts adding text from live tv subtitles into it.
How to run the development environment Coding style convention ref optional, eg which linter to use Linting, github pre-push hook - optional
- node
- npm
How to run build
No build steps needed.
How to carry out tests
NA
How to deploy the code/app into test/staging/production
Because of the presence of the server 'backend' you'll need to deploy on a server eg EC2 instance.