Documentation:Modules/marq

Module: marq
Type	Video sub-filter
First VLC version	-
Last VLC version	-
Operating system(s)	all
Description	Overlays text on the video
Shortcut(s)	-

The marq subfilter can be used to display text on a video.

Options

• marq-marquee <string> : Marquee text to display. Since VLC version 0.9.0 you can use format strings to display meta data and time information default value: VLC

• marq-x <integer> : X offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive) default value: 0 (0.8.6d and prior: -1)

• marq-y <integer> : Y offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive) default value: 0

• marq-position <integer> : Marquee position: 0=center, 1=left, 2=right, 4=top, 8=bottom, you can also use combinations of these values, eg 6 = top-right. (0.8.6d and prior: This is only used if marq-x or marq-y are negative) default value: 5

• marq-opacity <integer> : Marquee opacity. 0 is transparent, 255 is fully opaque. default value: 255

• marq-color <integer> : Marquee color. Use the decimal value of the HTML color code. default value: 16777215 (0xFFFFFF, white)

• marq-size <integer> : Font size in pixels. -1 uses the default font size default value: -1

• marq-timeout <integer> : Number of millitseconds the marquee must remain displayed. 0 means forever. default value: 0

• marq-refresh <integer> : Number of milliseconds between string updates. This is mainly useful when using meta data or time format string sequences. default value: 1000

Avalabile Format Variables

• Time related:
  • %Y = year
  • %m = month
  • %d = day
  • %H = hour
  • %M = minute
  • %S = second

• Meta data related:
  • $a = artist
  • $b = album
  • $c = copyright
  • $d = description
  • $e = encoded by
  • $g = genre
  • $l = language
  • $n = track num
  • $p = now playing
  • $r = rating
  • $s = subtitles language
  • $t = title
  • $u = url
  • $A = date
  • $B = audio bitrate (in kb/s)
  • $C = chapter
  • $D = duration
  • $F = full name with path
  • $I = title
  • $L = time left
  • $N = name
  • $O = audio language
  • $P = position (in %)
  • $R = rate
  • $S = audio sample rate (in kHz)
  • $T = time
  • $U = publisher
  • $V = volume
  • $_ = new line

Examples

Example command line use (VLC 2.0.0 and newer):

% vlc --sub-source="marq{marquee=test,color=16776960} somevideo.avi

This example displays yellow test text in the top left corner of video

Example command line use (VLC 0.9.0 - 1.1.13):

% vlc --sub-filter "marq{marquee=\$t (\$P%%),color=16776960}:marq{marquee=%H:%M:%S,position=6}" somevideo.avi
% vlc --sub-filter 'marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%M:%S,position=6}' somevideo.avi

This command line will show the stream's title ($t) and current position ($P) in the upper left corner and the current time in the upper right corner. Note that we have to escape $ characters when running this from command line in UNIX shells (this is why we use \$ instead of $). The second line uses single quotes to delimit the string so we don't need to escape the $ character.

On windows the command line would be:

C:\Program Files\VideoLAN\VLC\>vlc.exe --sub-filter=marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%m%s,position=6} somevideo.avi

Example command line (All versions including VLC 0.8.6d and prior):

% vlc --sub-filter=marq --marq-marquee="Obvious Watermark" --marq-position=0 --marq-size=50 --marq-opacity=25 --marq-color=32768 somevideo.avi

This command will show centered transparent green text. Text sized too large to fit the video window will not appear, and may crash VLC.

See also

• Documentation:Modules/rss

This page is part of official VLC media player Documentation (User Guide • Streaming HowTo • Hacker Guide • Modules)
Please read the Documentation Editing Guidelines before you edit the documentation

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.