VLC Help
VLC Help
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)