Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  DV2SUB (1)


dv2sub - extract info or subtitles from DV stream



dv2sub {-i | -s} [dv-file]
dv2sub --subtitles-out sub-file [dv-file]


Utility dv2sub reads raw DV stream from file argument dv-file or standard input if absent. It can generate a parametr log about every input DV frame or create MicroDVD subtitles with the recording date & time.

Memory mapped I/O is used for seekable input when available. It is faster than sequential access.

dv2sub uses GPL codec for DV video LibDV, see


-i, --info

Generate a simple information about every input DV frame. Reported are: frame number (counting from 0), video norm PAL/NTSC, aspect ratio normal (4:3) or wide (16:9), interlaced or progressive material, number of audio channels, audio sampling frequency, number of audio samples, timestamp, recording date & time.


Dump SSYB packets in hexadecimal form. (implies -i)


Dump VAUX packets in hexadecimal form. (implies -i)

--info-out info-file

Generate info (like with option -i, --info) and write output into file info-file.

-s, --subtitles

Generate MicroDVD subtitles with the recording date & time.

--subtitles-out sub-file

Generate subtitles (like -s, --subtitles) and write output into file sub-file.

-f, --time-format fmt

Use the format specification fmt by strftime() to output a subtitle line. The default format value is ‘%F|%T’.

-b, --boundary time

Don’t output subtitles with time above a boundary. The option argument syntax is YYYY[-mm[-dd [HH:MM[:SS]]]]. Default values for missing parts are the minimal ones. E.g. 2007 sets boundary to 2007-01-01 00:00:00.

Suppose you recorded a video. You grabbed video into a computer and edit it with non-linear editor like kino latter. Video transitions between scenes have date and time set to time of editing. You can use this option to filter out date and time subtitles of edited parts.

-n, --max-frames num

Don’t process more than num frames.

-d, --date1

Output one line with the recording date & time from the 3rd frame.


Don’t use mmap().

-p, --pass-through

Pass an input DV stream to stdout (implies --no-mmap). This option is usable mainly if you need to extract subtitles and encode the DV in one pass. You can avoid reading huge DV file twice by passing stdout through pipe to an encoder (ffmpeg, mpeg2enc,...).

-h, --help

Output a brief help message.

-V, --version

Output a version number.


Miguel Sahagun

Vaclav Ovsik


Search for    or go to Top of page |  Section 1 |  Main Index

DV2SUB (1) 01/13/2008

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.