Difference between revisions of "Interfaces"

From VideoLAN Wiki
Jump to navigation Jump to search
(→‎Main interfaces: default is QT4 now. wx belongs to the past)
m (Tweaks)
 
(14 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Interfaces are the way you interact with {{VLC}}. Like anything else in VLC, they are modules, which allows for their interchangeability (see below).
+
{{See also|Category:Interfaces|Category:Control VLC}}
 +
 
 +
Interfaces are the way you interact with {{VLC}}. Like anything else in VLC, they are modules, which allows for their interchangeability ([[#Using|see below]]).
  
 
== Main interfaces ==
 
== Main interfaces ==
Line 6: Line 8:
 
: Used to be [[wxWidgets Interface]] (wx) before.
 
: Used to be [[wxWidgets Interface]] (wx) before.
 
* The [[Skins|skins2 Interface]] is an interface where you can customize VLC's look (works on Linux and Windows).
 
* The [[Skins|skins2 Interface]] is an interface where you can customize VLC's look (works on Linux and Windows).
* The [[Mac OS X Interface]] is the default (and only) graphical interface on Mac OS X.
+
* The [[macOS Interface]] is the default (and only) graphical interface on [[macOS]].
* The [[BeOS Interface]] is the default (and only) graphical interface on BeOS.
+
* The [[BeOS Interface]] is the default (and only) graphical interface on [[BeOS]].
  
 
== Full list ==
 
== Full list ==
Line 13: Line 15:
 
{|
 
{|
 
|'''qt'''
 
|'''qt'''
| Current (>0.9.0) default [http://www.trolltech.com/qt Qt4] interface on [[Linux]] and [[Windows]].
+
| Current (>=0.9.0) default [https://www.qt.io/ Qt4] interface on [[Linux]] and [[Windows]].
 
|-
 
|-
 
|'''wx'''
 
|'''wx'''
Line 19: Line 21:
 
|-
 
|-
 
|'''skins2'''
 
|'''skins2'''
| Load VLC with a [[Skins|skin]]. (Linux and Windows only)
+
| Load VLC with a [[skin]]. (Linux and Windows only)
 
|-
 
|-
 
|'''macosx'''
 
|'''macosx'''
 
| Default [[Mac OS X]] interface.
 
| Default [[Mac OS X]] interface.
 +
|-
 +
|'''minimal_macosx'''
 +
| Minimal [[Mac OS X]] interface.
 
|-
 
|-
 
|'''beos'''
 
|'''beos'''
Line 40: Line 45:
 
|-
 
|-
 
| '''hotkeys''' and '''joystick'''
 
| '''hotkeys''' and '''joystick'''
| Control VLC with the keyboard/joystick.
+
| Control VLC with the keyboard/joystick (see [[HotKeys]]).
 
|-
 
|-
 
| '''dummy'''
 
| '''dummy'''
| Don't use an interface.
+
| Don't use an interface ([[HotKeys]] still available).
 
|}
 
|}
  
 
== Listing the available interfaces ==
 
== Listing the available interfaces ==
  
To get a list of available interfaces, running VLC with the -l option:
+
To get a list of available interfaces, running VLC with the <code>-l</code> option:
  vlc -l
+
  {{%}} vlc -l
This also displays the [[muxers]] and [[encoders]]/[[decoders]] and puts it in a file called "vlc-help.txt". On Linux, run
+
This also displays the [[muxers]] and [[encoders]]/[[decoders]] and puts it in a file called <code>vlc-help.txt</code>. On Linux, run
  vlc -l | grep -i interface
+
  {{%}} vlc -l | grep -iF interface
 
to display the interfaces.
 
to display the interfaces.
  
== Using an interface ==
+
== <span id="Using"></span> Using an interface ==
  
 
To run VLC with a different primary interface, use the following command:
 
To run VLC with a different primary interface, use the following command:
  vlc --intf ''name''
+
  {{%}} vlc --intf ''name''
 
You can also use
 
You can also use
  vlc -I ''name''
+
  {{%}} vlc -I ''name''
 
You can also change the default in the [[Preferences]].
 
You can also change the default in the [[Preferences]].
  
 
However, you can also launch more than one interface:
 
However, you can also launch more than one interface:
  vlc --intf qt --extraintf sap,telnet,http
+
  {{%}} vlc --intf qt --extraintf sap,telnet,http
This will launch VLC with the default QT interface, but will also launch the sap, telnet and web interface in addition to the QT one. The default for this can also be changed in the preferences.
+
This will launch VLC with the default Qt interface, but will also launch the [[SAP]], [[telnet]] and [[web interface]] in addition to the Qt one. The default for this can also be changed in the preferences.
 
 
Note that if you only use the dummy interface, you won't be able to tell vlc to quit - you may have to break it manually with Ctrl+C; or use vlc:quit as the last item on the playlist.
 
  
== See also ==
+
Note that if you only use the [[dummy]] interface, you won't be able to tell vlc to quit (except watching a video). You may have to break it manually with <kbd>Ctrl+C</kbd>; or use <code>vlc://quit</code> as the last item on the playlist.
* '''See also [[:Category:Interfaces]]'''
 
  
[[Category:Interfaces]]
+
[[Category:Control VLC|*]]
 +
[[Category:Interfaces|*]]

Latest revision as of 18:15, 6 March 2019

Interfaces are the way you interact with VLC media player. Like anything else in VLC, they are modules, which allows for their interchangeability (see below).

Main interfaces

VLC has four main graphical interfaces:

Used to be wxWidgets Interface (wx) before.

Full list

Besides the above main interfaces, VLC contains many more:

qt Current (>=0.9.0) default Qt4 interface on Linux and Windows.
wx Previous (<0.9.0) default wxWidgets interface on Linux and Windows.
skins2 Load VLC with a skin. (Linux and Windows only)
macosx Default Mac OS X interface.
minimal_macosx Minimal Mac OS X interface.
beos Default BeOS interface.
http Web Interface, used for controlling VLC from over a network.
gestures Mouse Gestures, where you can control VLC by moving the mouse
rc, ncurses, telnet Console Interfaces, non-graphical interfaces.
showintf Show interfaces module.
hotkeys and joystick Control VLC with the keyboard/joystick (see HotKeys).
dummy Don't use an interface (HotKeys still available).

Listing the available interfaces

To get a list of available interfaces, running VLC with the -l option:

% vlc -l

This also displays the muxers and encoders/decoders and puts it in a file called vlc-help.txt. On Linux, run

% vlc -l | grep -iF interface

to display the interfaces.

Using an interface

To run VLC with a different primary interface, use the following command:

% vlc --intf name

You can also use

% vlc -I name

You can also change the default in the Preferences.

However, you can also launch more than one interface:

% vlc --intf qt --extraintf sap,telnet,http

This will launch VLC with the default Qt interface, but will also launch the SAP, telnet and web interface in addition to the Qt one. The default for this can also be changed in the preferences.

Note that if you only use the dummy interface, you won't be able to tell vlc to quit (except watching a video). You may have to break it manually with Ctrl+C; or use vlc://quit as the last item on the playlist.