• About
  • Klingon New Feed
  • Links
  • Contact
  • How to Annotate Video

    Note: These instructions are based on using Windows only. ELAN and CuPED both seem to have different quirks on Macs. We may get a section up on that at some point.

    Step 1: Using ELAN

    1. Download ELAN, if you don't have it already. On their download page, they have some example ELAN files, if you'd like to see how a completed ELAN file works and looks.
    2. Open ELAN. It will look blank until you either load a existing ELAN (.eaf) file or create a new one. To create a new file, go to the "File" drop down menu and select "New..." Once clicking this, you will be prompted to add a media file, such as a video (.mp4, .wmv, .mpg, .mov, etc... Does not take .flv videos) or audio (.mp4, .wav, etc...). Click the ">>" button, to load the file and click "Ok." Once you upload your media, it takes ELAN a moment to "initialize" the file. Don't be alarmed that nothing happens for a moment!
    3. Once the initializing is complete, you media file should be in the upper left corner of ELAN. The lower half of the window is where your annotations will go, but for now it is blank. You will see a row called "default [0]," this will be the first tier where your first annotations will go. Change the name of the tier if you'd like by going to the "Tier" drop down menu and selecting "Change Tier Attributes." Let's say this tier is now named "klingon."
    4. Creating annotations is simple. You'll notice that if you drag your mouse in the bottom annotation area, you can select a section that will be highlighted light blue. Your current position is marked in red. If you have a selection highlighted, you can listen to just that section by clicking "Play S." This is how you can figure out the boundaries of an utterance.
    5. Once you have have found the boundaries of an utterance, you can right click within your selection on the row with your "klingon" tier. Select "New Annotation." A white box will appear, which you can type the utterance into. In our case, this would be the klingon lyrics to a song. To finish the annotation, hit "ctrl" and "enter" at the same time. This annotation is done! If you click the annotation, it will highlight and you will be able to listen to it with the "Play S" button.
    6. If you notice that you made a mistake in the timing of your annotation, you can move the sides of the annotation. To do this, click the annotation so that it becomes blue. Hold "alt" and then click the boundary you'd like to move forward or back. This boundary will turn green until you're finished moving it. Sometimes the whole annotation will turn purple and this means that you can move the whole thing. It's doesn't always give you the option to either move the whole annotation or just a boundary. You just have to fiddle with it until you get what you want.
    7. Once you annotate the whole video to the extent that you want it to tbe annotated, you can create a tier that is part of your first tier. In our case, we would want a child of "klingon," like "english." To begin, first go to the "Type" menu and select "Add New Linguistic Type." Name the type whatever you want, like "translation." For the Stereotype, select "Included In."
    8. Creating the new type allows you to create the child tier. Go to the "Tier" Menu and select "Add New Tier." Name the tier whatever you'd like, such as "english," and then in the Parent Tier dropdown menu, select your first tier with your annotations. You'll notice that as soon as you select the parent tier, the Linguistic Type drop down menu will automatically select the "Linguistic Type" that you just added.
    9. Now you have a second tier that you can add annotations to! You have a couple options of putting in a translation or whatever it is may need on that line. If it's a translation, you'll want the annotations to line up with the parent's annotations. You can copy annotations from the parent tier and paste them into your new child tier. By double clicking on the pasted annotation, you can go in and put your new annotation, such as an English translation. You can change the boundaries of the annotation if need be.
    10. Once you've finished both annotations, save your file!

    Step 2: Using CuPED to Get an html Output

    1. Download CuPED, if you have not already done so. A newer version was just released on 12/10/09, version 0.3.14. This version makes the process much easier, so if you have a previous version of CuPED, it would be a good idea to try this newer version.
    2. The first page will prompt you to pick a template. Just choose the "CuPED - Flowplayer Template," while will output html for you.
    3. Once you have picked the template, you go to the next section which customizes your template. There are 4 template settings that you need to work with.
      • Transcript File: This is where you pick the ELAN (.eaf) file to be converted. Find your file and add it.
      • Primary Tier: This is where you select the tier that you want to show up on the html page. CuPED only takes one tier for the html file. This is where it becomes important that the tiers have parents and children, because even though you can only select one tier, if that tier (ie. the "klingon" tier from above) has a child tier (ie. "english" tier from above), then both tiers will show. If they were separate tiers though, then you could only select one. Once you have selected your tier, "Options" will appear and you can go in and choose the font, font size, etc.
      • Convert Media: Selecting "Yes" in this section will convert the media associated with your ELAN file (.eaf) into .flv format. This function was recently fixed with the new version 0.3.14 of CuPED, so it's much easier to use now. Or, perhaps you converted your media to .flv format on your own. In that case, you do not need to convert media. There will be more on this below and the steps you would have to take...
      • Title of Page: Under current settings, select what's already there, "CuPED Flowplayer template." Once you select it, you can edit the title to whatever you want to call it.
    4. When you have finished with the above sections, click "Next" at the bottom. This shows you a preview, which isn't always acturate to what the page will actually display like on the web. What's important here is that you pick an output directory. Just to be on the safe side, create a new folder just for this file. The reason for this is that CuPED will create 4 folders in addition to the output html. These folders are "data," "img," "swf," and "js." The output html file will come out called "index.html." You can change this file name to whatever you want (ie. "klingon.html"). Once you have selected and/or created a folder, select "Process Template."
    5. The processing of the template will start. There will be a progress bar and a box that explains what is happening. Once it reaches 100%, nothing will happen, but it is in fact finished. You now have a html file that should work just fine!

    Recommendations for Putting These Files on the Web