In general, linux users have to install the particularly needed tools themselves. Ubuntu users can use their package manager to include ''universe'', ''multiverse'' and ''partner'' repositories and do a
sudo apt-get install openjdk-11-jre
The TTT installer carries everything it needs within its installer file.
On Windows platforms
Download the installer here. It already includes all necessary prerequisites.
Install the TTT by executing the installer.
Start the TTT via the start menu.
On Linux platforms
For recording, postprocessing, and publishing lectures you must first install all necessary prerequisites listed above.
Extract the archive what produces a couple of jar files.
Start the TTT by typing
java -Xmx1024M-jar ttt.jar
If You plan to record a video while recording the lecture, start the TTT by typing
Alternatively you can checkout and compile the recent version of the TTT from the repository, following the following [wiki:CompileTTT instructions].
3. Replaying lectures
You can download lectures form the lecture archive of your university as zip files. The lecture archive of the TUM can be found here. After unpacking the zip file you can start playing the lecture with the TTT by choosing the recording file '.ttt' under Student'->'open...':
A recording usually consists of following files:
.ttt'-file: contains the actual recording information like slides, annotations, etc.
.wav'-file: contains the uncompressed audio stream
.bjpg'-file: contains the raw video recording data of the lecturer himself ( optional )
Older recordings can also contain:
.mp3'-file: contains the mp3 encoded audio stream
.vnc'-file: aquivalent to '.ttt'
.mov'-file: contains the refined video of the lecturer himself ( optional )
Before recording, ensure that a VNC server is running on the machine you want to do the recording on. You can follow the links under [wiki:UsingTTT Prerequisites] if you still have to install a VNC server.
Click 'Teacher' -> 'present & record' to open the 'present & record' dialog.
Enter or select the name of the lecture.
Enter or select the name of the teacher.
Select the folder for storing the recording data.
Enter the address of the VNC server.
Set options for video and audio recording.
Finish the recording configuration by clicking the 'ok' button. After authentication, the connection will be established to the VNC server.
Being connected to the VNC server, the TTT recorder window with the VNC server desktop will appear:
Controlling the TTT
In detail, the TTT is controlled mainly via the following toolbar:
From the time when the red recording button is pressed, everything in the TTT viewer window is recorded by the time the stop button is pressed again, or the TTT viewer window is closed.
The lecturer can operate in 3 different modes when working with the TTT:
The checkbox on the left is used to switch the ''VNC mode'' on or off. If it is unchecked, the VNC mode is activated and every mouse and keyboard event is performed on the VNC server desktop. In all other cases, the annotation mode is are activated. In order to control the desktop via mouse again, the painting mode must be deactivated by clicking the checkbox on the left.
In ''annotation mode'', choose one of the colors listed in the toolbar as well as your preferred painting tool and draw on the desktop area. Annotation tools allow you to add annotations as overlay on the currently displayed desktop contents. Annotations can be removed by using the delete tool or klicking the 'delete all' button in the toolbar. Slide transitions via (page down)-key also remove all annotations.
Furthermore, one can switch to the ''whiteboard mode'', which consists of a plain white desktop to draw on with the ordinary annotation tools. In case, You run out of space on one whiteboard, You can open another one via the > button in the toolbar, even better, You can navigate through Your former whiteboards via the < and > buttons. Klicking the whiteboard button again switches back to desktop annotation mode.
TTT enables teachers to offer a feedback channel for their students. Menuitem "Extras/Messaging Server" or pressing "CTRL-M" starts the Messenger Addon for the Teleteaching Tool. You can find more detailed information about this feature here.
Some features of the TTT viewer window can be controlled via the keyboard:
'''F12''': Activates/deactivates the painting mode.
'''F11''': Opens the task manager of the operating system if possible.
'''F10''': Switches between painting tools (and activates the painting mode if necessary).
'''F9''': Switches between colors (and activates the painting mode if necessary).
5. Postprocessing of lectures
The postprocessing dialog can be opened by clicking 'Post Processing' -> 'open...' and choosing the recording's '.ttt' file. The dialog displays information about the recording, allows creating additional recording files, doing full text search, publishing the data on a http server, and looks as follows:
Thumbs, Script and Flash
The TTT enables you to offer lectures in different formats being generated from the raw recording data:
Thumbnails : Small pictures displaying screenshots of desktop events, e.g. different slides, for an easier navigation when playing the lecture.
HTML : HTML script with all screenshots including an overview and navigation possibilities.
PDF' : Portable document format with several screenshots per page to give students an overview of a lecture using a platform independent format.
Tesseract/OCR : performs an automatic optical character recognation on the slides and creates a fulltext search base
MP3 : Converting a audio file in WAV format, which is now used as the default format for audio recording, to a MP3 file in order to reduce the audio stream's size. Generating a MP3 file requires the MP3 encoder lame being installed on the system.
Flash/SWF ( deprecated ): Adobe's shockwave flash format which is often used to show multimedia contents on webpages. Generating a SWF movie triggers the generation of an '.mp3' audio file. Note that the generation of the flash movie may take several minutes and consumes a lot of memory (up to 1000 MByte and more). So adjust your Java Heap memory size accordingly (java option: -Xmx1024m). For some recordings it is necessary to convert the audio track, which also may take up to several minutes. Warning : Especially lectures, recorded on Windows machines tend to create very large Flash files, oftentimes too large files.
MP4 podcast : MPEG4 encoded movie which allows students to review lectures on an iPod or other multimedia players. The generation is done via the tools ffmpeg and MP4Box which must be installed on the system. Note that the generation of the podcast's video and audio stream may take several minutes.
Dozentenvideo : Converts the movie record of the lecturer into the more common video format Quicktime, yielding a '''mov''' file. Generating the movie requires a '.bjpg' file which is generated if video recording is activated during lecture recording.
Full text search
The TTT offers the possibility to perfom a full text search on the content of lectures without annotations. For this, a searchbase must be generated by an external optical character recognition software depending on the recording's screenshots. These screenshots can be created by the post processing feature of the TTT with the help of tesseract OCR.
By pressing the publish button the TTT generates a zip archive of the current lecture and copies every lecture related files (archives, scripts, flash, etc.) to the specified file server. Copying is done via ssh/sftp whereby the TTT supports the private/public key feature of ssh to loggin without specifying a password. SSH options can be set via menu 'Post Processing' -> 'ssh options'.
User: the user name for the account on the file server.
Server: the host name of the file server.
Path: the base path under which all lectures are stored (a subfolder will be created for each lecture). For TUM, this is
6. Error messages
This error message appears when there is not enough memory available, e.g. for creating a SWF/Flash file. More memory can be allocated when starting the TTT with java by the following parameter, whereas stands for the memory size in MB.
java -Xmx<i>M -jar ttt.jar
If you have installed the TTT on a windows system using the NSIS installer, you can modify java parameters of the start file 'TeleTeachingTool ' in the start menu like this: open the property page of the file 'TeleTeachingTool ' by clicking 'Properties' in the context menu and append the according parameter to the end of the field 'target'.
Errors when playing a lecture
File not found. Please specify a correct filename.
The TTT could not find the selected recording file.
Corrupted or unsuitable file. Files for this version of TTT end with ".ttt".
The selected file is damaged, e.g. due to a failed download, or the format is not supported by the TTT.
Unknown Input/Output-Error. ...
An error occurred while reading or writing a file.