Professional Documents
Culture Documents
You can specify multiple streams on the commandline. They will be enqueued in
the playlist.
The first item specified will be played first.
Options-styles:
--option A global option that is set for the duration of the program.
-option A single letter version of a global --option.
:option An option that only applies to the stream directly before it
and that overrides previous settings.
Many of the global --options can also be used as MRL specific :options.
Multiple :option=value pairs can be specified.
URL syntax:
[file://]filename Plain media file
http://ip:port/file HTTP URL
ftp://ip:port/file FTP URL
mms://ip:port/file MMS URL
screen:// Screen capture
[dvd://][device][@raw_device] DVD device
[vcd://][device] VCD device
[cdda://][device] Audio CD device
udp://[[<source address>]@[<bind address>][:<bind port>]]
UDP stream sent by a streaming server
vlc://pause:<seconds> Special item to pause the playlist for a
certain time
vlc://quit Special item to quit VLC
Audio
--audio, --no-audio Enable audio (default enabled)
--volume <integer [0 .. 1024]>
Default audio volume
--spdif, --no-spdif Use S/PDIF when available (default disabled)
--force-dolby-surround {0 (Auto), 1 (On), 2 (Off)}
Force detection of Dolby Surround
--audio-replay-gain-mode {none,track,album}
Replay gain mode
--audio-replay-gain-preamp <float>
Replay preamp
--audio-replay-gain-default <float>
Default replay gain
--audio-filter <string> Audio filters
--audio-visual <string> Audio visualizations
Video
-f, --fullscreen, --no-fullscreen
Fullscreen video output (default disabled)
--overlay, --no-overlay Overlay video output (default enabled)
--video-on-top, --no-video-on-top
Always on top (default disabled)
--video-title-show, --no-video-title-show
Show media title on video (default enabled)
--video-title-timeout <integer>
Show video title for x miliseconds
--video-title-position {0 (Center), 1 (Left), 2 (Right), 4 (Top), 8
(Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Position of video title
--mouse-hide-timeout <integer>
Hide cursor and fullscreen controller after x
miliseconds
Snapshot:
--snapshot-path <string> Video snapshot directory (or filename)
--snapshot-prefix <string> Video snapshot file prefix
--snapshot-format {png,jpg}
Video snapshot format
--snapshot-preview, --no-snapshot-preview
Display video snapshot preview (default
enabled)
--snapshot-sequential, --no-snapshot-sequential
Use sequential numbers instead of timestamps
(default disabled)
Window properties:
--crop <string> Video cropping
--custom-crop-ratios <string>
Custom crop ratios list
--aspect-ratio <string> Source aspect ratio
--custom-aspect-ratios <string>
Custom aspect ratios list
--video-filter <string> Video filter module
--vout-filter <string> Video output filter module
Subpictures
On Screen Display:
--osd, --no-osd On Screen Display (default enabled)
Subtitles:
--sub-file <string> Use subtitle file
--sub-autodetect-file, --no-sub-autodetect-file
Autodetect subtitle files (default enabled)
Overlays:
--sub-filter <string> Subpictures filter module
Track settings:
--audio-language <string> Audio language
--sub-language <string> Subtitle language
Playback control:
--input-repeat <integer> Input repetitions
Default devices:
--dvd <string> DVD device
--vcd <string> VCD device
--cd-audio <string> Audio CD device
Network settings:
--server-port <integer> UDP port
-6, --ipv6, --no-ipv6 Force IPv6 (default disabled)
-4, --ipv4, --no-ipv4 Force IPv4 (default disabled)
Input
Advanced:
--access-filter <string> Access filter module
--prefer-system-codecs, --no-prefer-system-codecs
Prefer system plugins over VLC (default
disabled)
Playlist
Performance options:
-Z, --random, --no-random Play files randomly forever (default disabled)
-L, --loop, --no-loop Repeat all (default disabled)
-R, --repeat, --no-repeat Repeat current item (default disabled)
--play-and-exit, --no-play-and-exit
Play and exit (default disabled)
--play-and-stop, --no-play-and-stop
Play and stop (default disabled)
--media-library, --no-media-library
Use media library (default enabled)
--playlist-tree, --no-playlist-tree
Display playlist tree (default disabled)
--open <string> Default stream
--auto-preparse, --no-auto-preparse
Automatically preparse files (default enabled)
--album-art {0 (Manual download only), 1 (When track starts playing), 2
(As soon as track is added)}
Album art policy
-S, --services-discovery <string>
Services discovery modules
-v, --verbose <integer> Verbosity (0,1,2)
--pidfile <string> Write process id to file
--advanced, --no-advanced Show advanced options (default disabled)
--interact, --no-interact Interface interaction (default enabled)
--show-intf, --no-show-intf
Show interface with mouse (default disabled)
-I, --intf <string> Interface module
--extraintf <string> Extra interface modules
--control <string> Control interfaces
Hot keys
--key-toggle-fullscreen <integer>
Fullscreen
--key-leave-fullscreen <integer>
Leave fullscreen
--key-play-pause <integer> Play/Pause
--key-faster <integer> Faster
--key-slower <integer> Slower
--key-next <integer> Next
--key-prev <integer> Previous
--key-stop <integer> Stop
--key-jump-extrashort <integer>
Very short backwards jump
--key-jump+extrashort <integer>
Very short forward jump
--key-jump-short <integer> Short backwards jump
--key-jump+short <integer> Short forward jump
--key-jump-medium <integer>
Medium backwards jump
--key-jump+medium <integer>
Medium forward jump
--key-jump-long <integer> Long backwards jump
--key-jump+long <integer> Long forward jump
--key-quit <integer> Quit
--key-vol-up <integer> Volume up
--key-vol-down <integer> Volume down
--key-vol-mute <integer> Mute
--key-audio-track <integer>
Cycle audio track
--key-audiodevice-cycle <integer>
Cycle through audio devices
--key-subtitle-track <integer>
Cycle subtitle track
--key-aspect-ratio <integer>
Cycle source aspect ratio
--key-crop <integer> Cycle video crop
--key-deinterlace <integer>
Cycle deinterlace modes
--key-wallpaper <integer> Toggle wallpaper mode in video output
--key-random <integer> Random
--key-loop <integer> Normal/Repeat/Loop
Zoom:
--key-zoom-quarter <integer>
1:4 Quarter
--key-zoom-half <integer> 1:2 Half
--key-zoom-original <integer>
1:1 Original
--key-zoom-double <integer>
2:1 Double
Jump sizes:
--extrashort-jump-size <integer>
Very short jump length
--short-jump-size <integer>
Short jump length
--medium-jump-size <integer>
Medium jump length
--long-jump-size <integer> Long jump length
--bookmark1 <string> Playlist bookmark 1
--bookmark2 <string> Playlist bookmark 2
--bookmark3 <string> Playlist bookmark 3
--bookmark4 <string> Playlist bookmark 4
--bookmark5 <string> Playlist bookmark 5
--bookmark6 <string> Playlist bookmark 6
--bookmark7 <string> Playlist bookmark 7
--bookmark8 <string> Playlist bookmark 8
--bookmark9 <string> Playlist bookmark 9
--bookmark10 <string> Playlist bookmark 10
-h, --help, --no-help print help for VLC (can be combined with --
advanced and --help-verbose) (default disabled)
-H, --full-help, --no-full-help
Exhaustive help for VLC and its modules
(default disabled)
--longhelp, --no-longhelp print help for VLC and all its modules (can be
combined with --advanced and --help-verbose) (default enabled)
--help-verbose, --no-help-verbose
ask for extra verbosity when displaying help
(default disabled)
-l, --list, --no-list print a list of available modules (default
disabled)
-l, --list-verbose, --no-list-verbose
print a list of available modules with extra
detail (default disabled)
-p, --module <string> print help on a specific module (can be
combined with --advanced and --help-verbose)
--ignore-config, --no-ignore-config
no configuration option will be loaded nor
saved to config file (default disabled)
--save-config, --no-save-config
save the current command line options in the
config (default disabled)
--reset-config, --no-reset-config
reset the current config to the default values
(default disabled)
--reset-plugins-cache, --no-reset-plugins-cache
resets the current plugins cache (default
disabled)
--version, --no-version print version information (default disabled)
--config <string> use alternate config file
--version, --no-version print version information (default disabled)
HTTP input
--http-proxy <string> HTTP proxy
--http-proxy-pwd <string> HTTP proxy password
Video4Linux input
--v4l-vdev <string> Video device name
--v4l-adev <string> Audio device name
--v4l-norm {3 (Automatic), 2 (SECAM), 0 (PAL), 1 (NTSC)}
Norm
--v4l-frequency <integer> Frequency
Video4Linux2 input
Video input:
--v4l2-dev <string> Device name
--v4l2-standard {0 (Default), 16711680 (SECAM), 255 (PAL), 45056 (NTSC)}
Standard
Audio input:
--v4l2-adev <string> Audio device name
DVDnav Input
--dvdnav-angle <integer> DVD angle
--dvdnav-menu, --no-dvdnav-menu
Start directly in menu (default enabled)
FTP input
--ftp-user <string> FTP user name
--ftp-pwd <string> FTP password
--ftp-account <string> FTP account
Timeshift
--timeshift-dir <string> Timeshift directory
--timeshift-force, --no-timeshift-force
Force use of the timeshift module (default
disabled)
Bandwidth limiter
--access-bandwidth <integer>
Bandwidth limit (bytes/s)
Dump
--dump-force, --no-dump-force
Force use of dump module (default disabled)
--dump-margin <integer> Maximum size of temporary file (Mb)
File logging
--logfile <string> Log filename
--logmode {text,html,syslog}
Log format
Snapshot module
--snapshot-width <integer> Snapshot width
--snapshot-height <integer>
Snapshot height
Podcasts
--podcast-urls <string> Podcast URLs list
Visualizer filter
General:
--effect-width <integer> Video width
--effect-height <integer> Video height
Marquee display
--marq-marquee <string> Text
Position:
--marq-position {0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5
(Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Marquee position
Font:
--marq-opacity <integer [0 .. 255]>
Opacity
--marq-color {-268435456 (Default), 0 (Black), 8421504 (Gray), 12632256
(Silver), 16777215 (White), 8388608 (Maroon), 16711680 (Red), 16711935
(Fuchsia), 16776960 (Yellow), 8421376 (Olive), 32768 (Green), 32896 (Teal),
65280 (Lime), 8388736 (Purple), 128 (Navy), 255 (Blue), 65535 (Aqua)}
Color
--marq-size <integer> Font size, pixels
Misc:
--marq-timeout <integer> Timeout
--marq-refresh <integer> Refresh period in ms
AtmoLight Filter
This module allows to control an so called AtmoLight device connected to your
computer.
AtmoLight is the homegrown version of what Philips calls AmbiLight.
If you need further information feel free to visit us at
http://www.vdr-wiki.de/wiki/index.php/Atmo-plugin
http://www.vdr-wiki.de/wiki/index.php/AtmoWin
You can find there detailed descriptions on how to build it for yourself and
where to get the required parts.
You can also have a look at pictures and some movies showing such a device in
live action.
Enter the connection of your AtmoLight hardware:
--atmo-serialdev <string> Serial Port/Device
Illuminate the room with this color on pause:
--atmo-usepausecolor, --no-atmo-usepausecolor
Color when paused (default disabled)
--atmo-pcolor-red <integer [0 .. 255]>
Pause-Red
--atmo-pcolor-green <integer [0 .. 255]>
Pause-Green
--atmo-pcolor-blue <integer [0 .. 255]>
Pause-Blue
--atmo-fadesteps <integer [1 .. 250]>
Pause-Fadesteps
Illuminate the room with this color on shutdown:
--atmo-ecolor-red <integer [0 .. 255]>
End-Red
--atmo-ecolor-green <integer [0 .. 255]>
End-Green
--atmo-ecolor-blue <integer [0 .. 255]>
End-Blue
--atmo-efadesteps <integer [1 .. 250]>
End-Fadesteps
Settings for the built-in Live Video Processor only:
--atmo-EdgeWeightning <integer [1 .. 30]>
Edge Weightning
--atmo-Brightness <integer [50 .. 300]>
Brightness
--atmo-DarknessLimit <integer [0 .. 10]>
Darkness Limit
--atmo-HueWinSize <integer [0 .. 5]>
Hue windowing
--atmo-SatWinSize <integer [0 .. 5]>
Sat windowing
--atmo-filtermode {0 (No Filtering), 1 (Combined), 2 (Percent)}
Filter mode
--atmo-MeanLength <integer [300 .. 5000]>
Filter length (ms)
--atmo-MeanThreshold <integer [1 .. 100]>
Filter threshold
--atmo-PercentNew <integer [1 .. 100]>
Filter Smoothness (in %)
--atmo-FrameDelay <integer [0 .. 35]>
Frame delay
Change channel assignment (fixes wrong wiring):
--atmo-channel_0 {-1 (disabled), 0 (summary), 1 (left), 2 (right), 3
(top), 4 (bottom)}
Channel summary
--atmo-channel_1 {-1 (disabled), 0 (summary), 1 (left), 2 (right), 3
(top), 4 (bottom)}
Channel left
--atmo-channel_2 {-1 (disabled), 0 (summary), 1 (left), 2 (right), 3
(top), 4 (bottom)}
Channel right
--atmo-channel_3 {-1 (disabled), 0 (summary), 1 (left), 2 (right), 3
(top), 4 (bottom)}
Channel top
--atmo-channel_4 {-1 (disabled), 0 (summary), 1 (left), 2 (right), 3
(top), 4 (bottom)}
Channel bottom
Adjust the white light to your LED stripes:
--atmo-whiteadj, --no-atmo-whiteadj
Use Software White adjust (default enabled)
--atmo-white-red <integer [0 .. 255]>
White Red
--atmo-white-green <integer [0 .. 255]>
White Green
--atmo-white-blue <integer [0 .. 255]>
White Blue
Parametric Equalizer
--param-eq-lowf <float> Low freq (Hz)
--param-eq-lowgain <float [-20,000000 .. 20,000000]>
Low freq gain (dB)
--param-eq-highf <float> High freq (Hz)
--param-eq-highgain <float [-20,000000 .. 20,000000]>
High freq gain (dB)
--param-eq-f1 <float> Freq 1 (Hz)
--param-eq-gain1 <float [-20,000000 .. 20,000000]>
Freq 1 gain (dB)
--param-eq-q1 <float [0,100000 .. 100,000000]>
Freq 1 Q
--param-eq-f2 <float> Freq 2 (Hz)
--param-eq-gain2 <float [-20,000000 .. 20,000000]>
Freq 2 gain (dB)
--param-eq-q2 <float [0,100000 .. 100,000000]>
Freq 2 Q
--param-eq-f3 <float> Freq 3 (Hz)
--param-eq-gain3 <float [-20,000000 .. 20,000000]>
Freq 3 gain (dB)
--param-eq-q3 <float [0,100000 .. 100,000000]>
Freq 3 Q
Skinnable Interface
--skinned-playlist, --no-skinned-playlist
Use a skinned playlist (default enabled)
Qt interface
--qt-display-mode {0 (Classic look), 1 (Complete look with information
area), 2 (Minimal look with no menus)}
Selection of the starting mode and look
--qt-notification, --no-qt-notification
Show notification popup on track change
(default enabled)
--qt-opacity <float [0,100000 .. 1,000000]>
Windows opacity between 0.1 and 1.
--qt-blingbling, --no-qt-blingbling
Use non native buttons and volume slider
(default enabled)
--qt-system-tray, --no-qt-system-tray
Systray icon (default enabled)
--qt-name-in-title, --no-qt-name-in-title
Show playing item name in window title (default
enabled)
--qt-fs-controller, --no-qt-fs-controller
Show a controller in fullscreen mode (default
enabled)
--qt-advanced-pref, --no-qt-advanced-pref
Show advanced preferences over simple ones
(default disabled)
--qt-error-dialogs, --no-qt-error-dialogs
Show unimportant error and warnings dialogs
(default enabled)
--qt-slider-colours <string>
Define the colors of the volume slider
--qt-privacy-ask, --no-qt-privacy-ask
Ask for network policy at start (default
enabled)
Ncurses interface
--browse-dir <string> Filebrowser starting point
AVI demuxer
--avi-index {0 (Ask), 1 (Always fix), 2 (Never fix)}
Force index creation
File dumper
--demuxdump-file <string> Dump filename
--demuxdump-append, --no-demuxdump-append
Append to existing file (default disabled)
Playlist
--playlist-autostart, --no-playlist-autostart
Auto start (default enabled)
--playlist-skip-ads, --no-playlist-skip-ads
Skip ads (default enabled)
--shoutcast-show-adult, --no-shoutcast-show-adult
Show shoutcast adult content (default disabled)