vbiutil

vbiutil is a set of utilities originally written by Hui Zhou for analysing mpeg files and extracting VBI data it's primary purpose is to grab the subtitle information.

streamparser parses an mpeg file and writes index.bin file and index.log file. The index.bin contains binary data of the structure of the mpeg and index.log file provides a description of the structure of the mpeg file.

getvbi reads the mpeg file and index.bin and extracts the closed captions or the teletext subtitle data into vbi.txt.

rawvbi and analysevbi help in debugging the vbi stream.

alarm is a test program to check the alarm signal.

mpegcheck is a program to analyse the mpeg data stream and display the packet types in the stream. It has been written to run from a cron job in order to determine if the audio stream is still available. There is a bug in the IVTV driver that after some hours or days the audio stream is no longer available and so recording also have no audio. This program is not a fix but a workaround to detect when the audio is lost and then some action can be taken to restore the audio. This can include rebooting the machine or resetting the firmware.

MPlayer uses the mpeg timestamps to determine when to display the subtitles. A useful program to remove unwanted segments from mpeg recording is gopchop but unfortunately it does not calculate the timestamps correctly and so the subtitles are displayed incorrectly. Included in the latest version of vbiutil is a patched version of gop_fixup that corrects mpeg timestamps for PAL recordings. This program could be inproved to determine the frame rate from the mpeg stream.

Usage

streamparser <mpeg file>
getvbi <mpeg file> <page number>

mpegcheck -i <video device> -o <output mpeg file> -b <number of 128K blocks to read>

Example Usage

streamparser video.mpeg
getvbi video.mpeg 888

mpegcheck -b4

Downloads

vbiutil-0.1.4.tar.bz2 Added mpegcheck, which prints a decoding of packets in a mpeg stream.
vbiutil-0.1.3.tar.bz2 Changed file names and added GOP timestamp.
vbiutil-0.1.2.tar.bz2 Changes to Hui Zhou original vbiutil program to work with teletext.