Chapter 1. ELAN documents

1.1. Basic Information

1.1.1. Media Files and Annotation Files

Every ELAN project consists of at least two files: one (or more) media file(s), and one annotation file.

  1. One (or more) media file(s):

    • 0 or more video file(s) (*.mpg, *.mov etc.)

    • and/or one (or more) audio file(s) (*.wav)

    The video file allows you to view the video and listen to the sound. If you want to view the waveform as well, you need to create an additional *.wav file through a conversion program that converts the audio data from one *.mp(e)g file into a *.wav format. In the case of multiple video files, the audio of the first selected video file is played. The kind and number of supported video formats depend upon the media framework you are using. If your media framework supports a format, the same goes for ELAN.

    The following media frameworks are known to work:

    • Windows (in order of preference, DirectShow being the best solution):

      • JDS (Java Direct Show)

        • Java - Microsoft Media Foundation (.mp4, .m4a,. m4v (win 7 and higher), .wmv, .wma, .asf)

      • QuickTime

      • JMF (Java Media Framework)

    • MacOS (in order of preference):

      • QuickTime using the Cocoa Framework (QTKit)

      • QuickTime using QuickTime for Java

    • Linux (in order of preference):

      • JVLC (Java wrapper for VLC Player)

      • JMF (Java Media Framework)

    • For *.mov files (i.e., Cinepak-Quicktime-Movies) it is important that these are self-contained files, i.e., the video information needs to be contained within the *.mov file itself. If this is not the case, ELAN will not be able to display the file.

    • Unlike other media files, the playback rate of Windows Media Audio (WMA) files cannot be altered.

  2. One annotation file:

    • an annotation file created by ELAN ( *.eaf , “EUDICO Annotation Format”)

    • or an imported annotation file. See the Section 1.4.2 section for the supported formats.

    All information (e.g., the tier setup, the time alignment, the annotations) is saved to the annotation file only – never to the media file(s).


    Take care when editing a media file. Afterwards you probably will want to resynchronize its alignment with the corresponding the annotations, as described in (Section 1.2.4).

    Although it's not compulsory it is a good practice to use a common name for media files and the annotation file. So, it is recommended to use a.eaf next to a.mpg and a.wav.

    Imported files also do not need to have the same name as their media files, and they can be located in different directories. All imported files can ultimately be saved as ELAN files ( *.eaf ).

    All annotation files ( *.eaf ) can be exported as text, FLEx, Toolbox etc.

1.1.2. Special ELAN data folder

ELAN creates a special folder to store settings, preferences and configuration files and to cache content downloaded from internet. The name and location of this folder depends on the operating system:

  • on Windows: <user_home>\.elan_data

    where the <user_home> folder resolves to (depending on the Windows version) something like C:\Users\user_login_name

  • on Linux: <user_home>/.elan_data

    where <user_home> is just the user's home folder

  • on Mac OS X: <user_home>/Library/Preferences/ELAN

    where <user_home> resolves to /Users/user_login_name. To access the Library folder in the Finder you can hold down the Option (Alt) key when clicking the Go menu. Library will then be visible in the list.

Apart from that ELAN expects to find specific files and folders in its installation folder.