Screening using Fedora

Using Gnome's embedded screencast tool

Gnome3 has already a screen recording functionality. Pressing Alt+Ctrl+Shift+R recording will start. There should be a red icon on the right-bottom corner of your screen. Pressing it again will stop the recording. The video is saved in the Video directory on your home directory on webm format.

Istanbul

This howto is here to provide instructions on how to use the Istanbul application in order to make Theora videos of your desktop sessions. This can be useful to create video howtos to support help documentation or it can be helpful for testers who need to show developers unexpected desktop application behavior.

Istanbul relies on new x display screen capturing support in gstreamer-plugins package. The ximagesrc gstreamer element is under active development upstream. As newer versions of gstreamer-plugins becomes available in Fedora development, the recommended settings in this howto will be updated to take advantage of performance enhancements

Recommended Settings

Set your ["Xorg"] server display to use 800x600. You can't just set this resolution via gnome's support for xrandr yet. To make sure you get a proper screen capture you need to make sure that the X server itself is set to 800x600 (with system-config-display for instance) and that the gnome desktop is configured to use the default X resolution and refresh rate. If you attempt to lower your desktop resolution using xrandr for your desktop you will most likely see artifacts in the videos.

Set istanbul framerate to 1.0 frames per second. This should be fast enough to record most human interactions with the desktop and will be slow enough to prevent egregious problems with frames being dropped. Upstream is currently working on fixing the performance issues with capturing the x display image. The recommended framerate will be adjusted as performance improvements to gstreamer's display capture plugin are made available.

Set the istanbul encode image size to be 240x192 for a web friendly video size. This is 1/4 the area of the desktop and text should still be legible. If you shrink the image too much as part of the encoding process small text can become obscured.

Installing Istanbul

Istanbul is available in Fedora. Just install it with the following command:

yum install istanbul

Using Istanbul on Gnome Desktop

Istanbul will be located in the Sound and Video menu. Once you run Istanbul from the menu you will see a new icon appear in the gnome notification area applet. You can also run the command istanbul from a terminal.

When Istanbul is not recording or encoding the icon will be a red record button.

Istanbul settings are accessed via a right-click menu when Istanbul is idle and the red record button is displayed. Here you configure the encoded video width and height, the framerate and the file location for the resulting video. You can also choose whether you want instabul to encode after video recording is complete. This option may help you avoid bad frame dropping on slower cpus. I've personally had this option cause unexpected segfaults so I've opted not to use this feature for now. This howto does not cover use istanbul's support for network streaming of the video, but you are free to experiment.

Clicking on the red button will place Istanbul in record mode and will start the recording of the desktop. Perform normal desktop tasks, keeping in mind that you are recording a display image about once per second. You will want to make sure you do important operations slow enough to be caught by the recording process.

When Istanbul is recording the icon will become a square stop button. Clicking the stop button will cause Istanbul to stop recording. If Istanbul is configured to encode after recording is done , the square stop button will change to an encoding icon. You are able to record a new session when you see the red button graphic again.

Once encoding is done, you should be able to use the totem media player to view the video you produced.

Advanced Topics: Adding Audio

You must have audacity (or other audio recorder) installed

Record your audio track, taking care to synchronize it with events in your recording (I believe this may be easier to record the audio track first, then go back and play the audio while recording video)

Advanced Topics: Adding a video timestamp

For further editing needs, one can overlay the time over the original video. This may help in the production of additional audio tracks. Here is a small script to produce a video with video timestamp visible File:ScreenCasting fedora-video-timestamp.sh

Byzanz

Byzanz is available in Fedora. It is similar to Istanbul, but can also produce: