Contents:

# What is Livius?¶

Livius is a small framework for making videos out of talks/presentations. It uses as input a video stream containing all the relevant informations: slides, speaker, sounds… and applies corrections to it:

• slide contrast and aspect is corrected automatically
• speaker is tracked (in progress)
• title/epilog/credit pages may be added
• the talk duration is cropped and pauses can be added as well (in progress)

# Getting started¶

Livius defines workflow and jobs: those are convenient tools for being able to process the videos.

• A job is a small processing unit that takes input and produces outputs, and maintains a state so that outputs are not being reprocessed if the inputs have not changed.
• A workflow is a set of jobs with their dependencies (which defines a Directed Acyclic Graph)

Livius already contains many different jobs as well as some workflows.

# Running Livius¶

Once you know more about the workflow you want to use, you may run the processing of this workflow over a bunch of videos simply by running

fc-cache -fv


# Meta information associated to the videos¶

The metadata associated to the video files describe the following:

• the title of the talk
• the speaker
• the date
• optionally an image used as introduction
• optionally the pauses and begin/end of the video

The meta data is loaded by the Job Metadata. If your metadata is stored in a way that differs with the expectation of Metadata, it is easy to adapt this class to your needs (such an example if given in the file containing Metadata).

# Relocatable files¶

The design of Livius attempts to have relocatable files, which means that the some root folder (eg. videos, metadata, cached values) might be specified and changed at runtime (command line invocation) without recomputing the intermediate or final results.

With this design, it is also possible to compute the results with different machines, from the same sources, and having different mount points.

# Available ressources¶

The repository contains images that can be used out of the box for running Livius on videos. Those images are more or less related to the /Machine Learning Summer School/ (2013, 2015), but may be adapted easily.

• livius/ressources/background_mlss2015.png the background image during the talk, containing visual cues (grey area on which the slides and the speaker are overlayed), mainly for visual sanity check
• livius/ressources/background_no_grey_mlss2015.png, same as background_mlss2015 without grey areas (if one of the stream is smaller than the target one).
• livius/ressources/Lato2OFL.zip is an archive containing the Lato fonts that are used by Livius (for overlaying the title etc.). This font was downloaded from this web site. It is licensed under the SIL Open Font License (OFL) v1.1 (“/The fonts can be used with­out any lim­i­ta­tions for com­mer­cial and non-​​commercial pur­poses/”).