Frequently asked questions (FAQ)

General Questions

While hypertext systems like the World-Wide-Web evolved out of a certain community, the origins of hypervideo systems are difficult to name and depend on incoherent definitions. As a result, particularly web-based implementations are entitled “hypervideos” because they consist of some kind of interactive film. Even though some existing applications fit partly into the different hypervideo definitions, most of them do not go beyond transferring the simplified concept of web hypertext to film. With FrameTrail, we aim to create a hypervideo environment that provides a filmic answer to functional intertextuality in the form of hyperlinked, non-linear video fragments. We are not there yet, but by using the term, we want to explicitly set foot on that path.
Read more on the History and Definition of the hypervideo concept.
There are many great applications and frameworks which enable you to do similar or even more sophisticated things (PopcornJS, Popcorn Editor and the discontinued Popcorn Maker application, Korsakov or Klynt, just to name a few).
We do very much respect their efforts and encourage you to use these tools, but FrameTrail was built around a different set of goals and principles. We thoroughly thought about using the PopcornJS Library and some of its plugins at least as a basis for synchronization, but decided to go with a custom implementation which incorporates the simple module, type and state architecture of FrameTrail.
"Frames" are the most basic components of film (moving images). A "Trail" is in this context the path these frames take when composed to a film sequence (a "trail of single frames" if you wish). The term stems from Vannevar Bushs groundbreaking essay "As We May Think" (1945) and his description of associative trails in the "memex" concept (which laid the foundation for all future hypertext systems, including the World-Wide-Web).
By choosing this name, we want to pay tribute to the original hypertext ideas (which contained many great concepts from which only the simplest made it into the WWW) and set the longterm goal to re-invent some of them for film-based hypermedia.

Using FrameTrail

FrameTrail has been developed as a simple tool requiring only little knowledge and effort to set up and extend. On the contrary, you as a user have to take care of web-ready data formats and a suitable technical environment (i.e. small images, correctly encoded video files and a modern browser). If you think you did everything right and still experience problems, please inform us of bugs or any other issues you have.
You most likely added many webpage resources. While there is generally no limit, please keep in mind that every webpage you add as annotation or overlay needs to be fully loaded in the browser. So if you add 30 webpage resources to your hypervideo, this is similar to opening 30 websites at once in one browser window.
Some websites need more browser performance than others. Under extreme circumstances, a single website can be enough to crash the entire application. As we obviously don't have control over external webpages, just check if it get's better when you remove certain webpage resources from the hypervideo.
Converting your video file into the required format is fortunately very easy. Just get Miro Video Converter, drag your files into the application and covert them to "MP4". If you are using another tool, the recommended export settings for your video file are MP4-H264 with 720p, 25fps and 3mbit Bitrate.
In the FrameTrail upload interface you will also see a size limitation (depending on the server you are using). If your converted files are still too big, just play with the settings in Miro to try and get them smaller.
You can use files with the ending: "jpg", "jpeg", "gif" and "png". In order to make your images "web-ready" (small filesize), please check out this great tutorial: HOW TO - Make Your Images Web-Ready.
For the subtitles, you have to use files in the "WebVTT" (.vtt) format. We might integrate parsers for other formats (like SRT) in the future, but for the moment you have to use this format or convert your existing SRT files to WebVTT.
There are a number of simple converters:
https://github.com/woollybogger/srt-to-vtt-converter
https://atelier.u-sub.net/srt2vtt/
http://www.webvtt.org/
FrameTrail is a web application. This means you can only work with files which are "web-ready" / can be displayed in a browser. Please stick with the formats offered within the upload interface.
Did you login with the right credentials, but a warning message says: "User is not active. Please contact an admin!"?
This means that you have successfully been registered, but a security setting requires that your account is activated by an administrator before you can actually login.
Hypervideos are managed by their authors, thus a normal user can only "annotate" them but cannot change Overlays or Video Links. By forking a hypervideo, you create a copy for yourself that you completely own and are fully able to edit. As a reference is still kept to the "origin", forking is more than just copying or cloning. The term stems from open source software development.
We are working on this functionality. The plan is to provide you with the means to export a standalone version of a single Hypervideo or even an entire project, which doesn't require a server to be accessed and can be imported again at any time into the application.
For the moment, you can export / share FrameTrail projects by just copying the "/_data" folder and pasting it into another FrameTrail instance. Everything, including the user accounts and settings will be included in that folder.

Technical Questions

FrameTrail has been built with the aim to include users with very basic programming skills in the process of extending and remixing the application. Setting up tools like "Grunt", "bower" etc. is not just hard for some beginners, using them also results in two different code bases (source and build), which, even if you don't minify any code, introduces the concept of code compilation to web applications. We know these concepts are very useful for large scale web development, but think they are an unnecessary overkill for a tool like FrameTrail.
We are however thinking of integrating a CSS pre-processor to make style adjustments more easy.
To keep down the server requirements and administrative knowledge required to install FrameTrail. But we are thinking of integrating respective tools and libraries as extra modules, which you may or may not use based on your skills.

What if my question is not answered here?

Ping us on Twitter (@FrameTrail).