Cinera, and Annotation Writing

Video annotations, at their heart, are very similar to chapter points in the DVD / Blu-ray releases of feature films. They give viewers a way to easily navigate to set points in a video.

Cinera, my annotation system, extends on this notion of ease of navigation by allowing additional information – e.g. references (externally linked, where possible), quotes, topic / medium categorisation – to be encoded in annotations, which viewers may use to navigate directly to websites referenced in the video, or even to filter out categories in which they are not interested or don't have time to watch.

Navigation is further eased across multiple videos through Cinera's search functionality, written by Asaf Gartner.

In essence, we capitalise on the fact that we are viewing the videos on a general purpose device connected to the internet – a fact on which DVD / Blu-ray authors cannot rely – coupled with the notion that the kinds of videos currently enjoying annotation treatment are not necessarily intended to be consumed in their entirety from beginning to end, but rather treated as reference material to dip in and out of, to create a context appropriate viewing experience.

Rather than read about it, however, you may prefer to watch Mio Iwakura's video How to Watch RISCY BUSINESS - The Annotated Episode Guide showcasing the system, and even try it all out for yourself since that very same video is itself annotated! How to Watch RISCY BUSINESS - The Annotated Episode Guide

Cinera is written in C99, runs on Linux servers and depends on libcurl. Its source is open and available here, although note that it is currently unlicensed and not yet packaged up for easy deployment (although, if we're honest, those installation and build instructions aren't much longer than this parenthetical remark).

Still to come:

  • configuration file parsing
  • support for multiple sets of videos (dubbed "projects" in Cinera parlance)
  • bookshelf, collating all references cited in a project
  • filterable search
  • FreeBSD port
  • more…

Acknowledgements

Huge thanks to Asaf Gartner for the original player design and programming; Alex Baines for writing the HMML parser and hosting the quotes; Casey Muratori for his constant inspiration through Handmade Hero and being the first person to receive the "annotation treatment"; Sean T. Barrett for writing the original HMML → Youtube converter, the first program to deal with a markup language of my creation, and for doing OBBG, the first project to receive Cinera-style annotations (still to go live, I'm thinking once the search and player are full-featured enough for Sean to only need run the generator once and have the final version of everything!); Mio Iwakura for the video showcasing Cinera; Abner Coimbre for running the first instance of Cinera in production, handling the videos at handmadedev.show; my fellow staffers and community members at Handmade Network; Dustin Specht for encouraging me to write annotations in the first place; and everyone who supports me, both financially and morally, in this extended play session of The Annotation Game.

Pledging

Pledging, now powered by SendOwl, is available again!

// NOTE(matt): Payment by card via Stripe incurs lower fees

£1 / month £12 / year £2 / month £24 / year £4 / month £8 / month £16 / month £32 / month Powered by

Until December 2017 we used a popular patronage platform to handle pledges. This worked well for us until a proposed change to their fee structure made it prohibitively expensive for some folks to continue to pledge, and in the process lost the trust of creators and supporters alike.

Switching to SendOwl negates those proposed fees – it's a paid service, so I pay a flat monthly fee for it – and also, if I don't offer any "rewards" for pledging, as I'm not, there is no need for me to collect VAT (more on this here). So this seems like it should provide what we'd like from a pledge platform in the most cost effective way. // NOTE(matt): A side effect of it being a paid service with a flat monthly fee is that, the more pledges I receive, the more cost effective it gets.

Thank you in advance if you enjoy what I do and are able to pledge!

Hiring

Coming Soon!

to a Cinera near you