VideoLAN Wiki - User contributions [en]

Documentation:Modules/http intf

2016-10-31T14:07:07Z

Computergeoffrey:

{{Module|name=http|type=Control interface|description=Allows control of VLC over a http connection}}
The '''http''' lua module makes it possible to [[Control VLC via a browser]] interface which can be enabled by going to Settings > Add Interface > Web Interface.

== How to use ==
To use this interface as the primary interface, launch VLC with the parameter "-I http" or set http to be the primary interface via the preferences (see below for instructions). To launch it as a secondary interface you should launch VLC with the parameter "--extraintf=http" or set http as an extra-interface in the Preferences area mentioned above.

Now, when you start VLC, a web interface will be created and running on your computer on port 8080 (by default, but you can change this yourself). For your information, you can connect to a web server listening on an arbitrary port using http://server:port syntax, so you can test the VLC web interface using this URL: http://127.0.0.1:8080.

If you get a ''401 Unauthorized'' error message and you have set a password on the interface as described in [[#Access_control|Access control]] below, leave the username field blank and enter the password that you have set.

VLC 2.0 and below: If you try to access the web interface from another computer or by using your computer's IP address and you get a ''403 Access Denied'' error message, you have to allow access for the IP or IP range first: see [[#Access_control|Access control]] below.

The following options can be used to specify an IP and a different port on which you want to run the interface.
===VLC 2.0.0 and later===
--http-host host
--http-port port

or on Windows platforms:
--http-host'''='''host
--http-port'''='''port

To enable the HTTP control interface as a primary or extra interface, go to Tools -> Preferences (select "All" radio-button) -> Interface -> Main interfaces -> check "Web":
[[File:VLC_2.0_Activate_HTTP.png‎|450px|center|Activating VLC 2.0's HTTP interface]]

===VLC before 2.0.0===
--http-host host:port

or on Windows platforms:
--http-host'''='''host:port

To enable the http interface as a primary or extra interface, go to Tools > Preferences > Interface > General > Interface module: http remote control interface. In later versions it might be Tools -> Preferences (select All radiobutton) -> All radio button -> Interface -> Main interfaces -> check HTTP remote control)

== Configure ==

=== Access control ===
==== VLC 2.1.0 and later ====
Access control has been simplified in VLC 2.1.0. You can restrict access to the web interface by using a simple password that can be set under Tools → Preferences (all) → Interfaces → Main interfaces → Lua → Lua HTTP → Password.

It can also be set from the command line as the option 'http-password', like so:

--http-password <your password here>

When logging in, '''leave the username field blank'''.

==== VLC before 2.1.0 ====
Access control for specific IP addresses or ranges of IP addresses to the http interface can be done globally by editing "/usr/share/vlc/lua/http/.hosts" in Linux, "%PROGRAMFILES%\VideoLAN\VLC\lua\http\.hosts" on Windows and "/Applications/VLC.app/Contents/MacOS/share/lua/http/.hosts" on Mac OS X.

The existing .hosts file contains examples and can easily customized to meet your needs. On [[Windows]], note that you might need administrator rights to edit this file.

Note that the global file gets overwritten when/if you reinstall/upgrade VLC.
This is solved by some Linux distributions by symlinking the file to /etc.
If your distribution does not do this; execute the following as root:
mkdir /etc/vlc && cd /usr/share/vlc/lua/http/ && mv .hosts /etc/vlc && ln -s /etc/vlc/.hosts .hosts

=== Customization ===
It is now also possible to customize the Web interface. See the html pages in share/html (within the VLC directory for Windows, within the VLC.app package on Mac OS X and somewhere in /usr/local for Linux). This can be a very cool interface if you spent some time developing nice UI elements. If you would like to contribute a new 'Default' html interface, you are also very welcome (keep it small).

An additional theme has been created (by Lucas Steigmeyer a.k.a. Plezops) specifically for PDA's or PSP's in mind. This additonal theme has a grey theme and will fit nicely on most portable versions of web browsers. The theme has the layout reordered to fit the screen better. You may download this theme from [http://www.orrentdesign.com/outsideResources/VLC_Graphite.zip OrrentDesign.com]. A readme file is included. View for install instructions and other info.

== Notes ==
* On versions of VLC (windows) that are greater than .8 (possibly previous versions, though not confirmed) the HTTP interface index file is stored in the "http" folder in the VLC folder. There are no help files bundled with the download however you may find help files in the online Wiki and how-to, or readme's.
* A new http interface is available since 0.8.5. However this new interface does not work on handheld PDA's running the Windows Mobile OS, it also does not work with JavaScript turned off in your browser. This old interface was available at <nowiki>http://<ip>:<port>/old/</nowiki> for releases prior to 1.0.0.
* Since 2.0.0, the HTTP interface has been rewritten from the ground up as a lua plugin with AJAX, and the oldhttp interface no longer exists.
* Since 2.1.0, the HTTP interface no longer uses the hosts file, but instead a password.

For more information about the HTTP interface, see the document "VLC Play-Howto", the paragraph [http://web.archive.org/web/20050912064324/http://www.videolan.org/doc/play-howto/en/ch04.html#id295619 "The HTTP interface"] in chapter 4 ("Advanced use of VLC") and [[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|"Building pages for the HTTP interface"]]. ([http://web.archive.org/web/20050901191213/http://videolan.org/doc/play-howto/en/apb.html "See also old/outdated appendix B"]).

==See also==
* [[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|Building Pages for the HTTP Interface]] (may be obsolete)
* [[Interfaces]]

[[Category:Interfaces]]

{{Documentation footer}}

Documentation:Modules/http intf

2016-10-31T14:06:11Z

Computergeoffrey: Fix dead link

{{Module|name=http|type=Control interface|description=Allows control of VLC over a http connection}}
The '''http''' lua module makes it possible to [[Control VLC via a browser]] interface which can be enabled by going to Settings > Add Interface > Web Interface.

== How to use ==
To use this interface as the primary interface, launch VLC with the parameter "-I http" or set http to be the primary interface via the preferences (see below for instructions). To launch it as a secondary interface you should launch VLC with the parameter "--extraintf=http" or set http as an extra-interface in the Preferences area mentioned above.

Now, when you start VLC, a web interface will be created and running on your computer on port 8080 (by default, but you can change this yourself). For your information, you can connect to a web server listening on an arbitrary port using http://server:port syntax, so you can test the VLC web interface using this URL: http://127.0.0.1:8080.

If you get a ''401 Unauthorized'' error message and you have set a password on the interface as described in [[#Access_control|Access control]] below, leave the username field blank and enter the password that you have set.

VLC 2.0 and below: If you try to access the web interface from another computer or by using your computer's IP address and you get a ''403 Access Denied'' error message, you have to allow access for the IP or IP range first: see [[#Access_control|Access control]] below.

The following options can be used to specify an IP and a different port on which you want to run the interface.
===VLC 2.0.0 and later===
--http-host host
--http-port port

or on Windows platforms:
--http-host'''='''host
--http-port'''='''port

To enable the HTTP control interface as a primary or extra interface, go to Tools -> Preferences (select "All" radio-button) -> Interface -> Main interfaces -> check "Web":
[[File:VLC_2.0_Activate_HTTP.png‎|450px|center|Activating VLC 2.0's HTTP interface]]

===VLC before 2.0.0===
--http-host host:port

or on Windows platforms:
--http-host'''='''host:port

To enable the http interface as a primary or extra interface, go to Tools > Preferences > Interface > General > Interface module: http remote control interface. In later versions it might be Tools -> Preferences (select All radiobutton) -> All radio button -> Interface -> Main interfaces -> check HTTP remote control)

== Configure ==

=== Access control ===
==== VLC 2.1.0 and later ====
Access control has been simplified in VLC 2.1.0. You can restrict access to the web interface by using a simple password that can be set under Tools → Preferences (all) → Interfaces → Main interfaces → Lua → Lua HTTP → Password.

It can also be set from the command line as the option 'http-password', like so:

--http-password <your password here>

When logging in, '''leave the username field blank'''.

==== VLC before 2.1.0 ====
Access control for specific IP addresses or ranges of IP addresses to the http interface can be done globally by editing "/usr/share/vlc/lua/http/.hosts" in Linux, "%PROGRAMFILES%\VideoLAN\VLC\lua\http\.hosts" on Windows and "/Applications/VLC.app/Contents/MacOS/share/lua/http/.hosts" on Mac OS X.

The existing .hosts file contains examples and can easily customized to meet your needs. On [[Windows]], note that you might need administrator rights to edit this file.

Note that the global file gets overwritten when/if you reinstall/upgrade VLC.
This is solved by some Linux distributions by symlinking the file to /etc.
If your distribution does not do this; execute the following as root:
mkdir /etc/vlc && cd /usr/share/vlc/lua/http/ && mv .hosts /etc/vlc && ln -s /etc/vlc/.hosts .hosts

=== Customization ===
It is now also possible to customize the Web interface. See the html pages in share/html (within the VLC directory for Windows, within the VLC.app package on Mac OS X and somewhere in /usr/local for Linux). This can be a very cool interface if you spent some time developing nice UI elements. If you would like to contribute a new 'Default' html interface, you are also very welcome (keep it small).

An additional theme has been created (by Lucas Steigmeyer a.k.a. Plezops) specifically for PDA's or PSP's in mind. This additonal theme has a grey theme and will fit nicely on most portable versions of web browsers. The theme has the layout reordered to fit the screen better. You may download this theme from [http://www.orrentdesign.com/outsideResources/VLC_Graphite.zip OrrentDesign.com]. A readme file is included. View for install instructions and other info.

== Notes ==
* On versions of VLC (windows) that are greater than .8 (possibly previous versions, though not confirmed) the HTTP interface index file is stored in the "http" folder in the VLC folder. There are no help files bundled with the download however you may find help files in the online Wiki and how-to, or readme's.
* A new http interface is available since 0.8.5. However this new interface does not work on handheld PDA's running the Windows Mobile OS, it also does not work with JavaScript turned off in your browser. This old interface was available at <nowiki>http://<ip>:<port>/old/</nowiki> for releases prior to 1.0.0.
* Since 2.0.0, the HTTP interface has been rewritten from the ground up as a lua plugin with AJAX, and the oldhttp interface no longer exists.
* Since 2.1.0, the HTTP interface no longer uses the hosts file, but instead a password.

For more information about the HTTP interface, see the document "VLC Play-Howto", the paragraph [http://videolan.org/doc/play-howto/en/ch04.html#id295619"The HTTP interface"] in chapter 4 ("Advanced use of VLC") and [[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|"Building pages for the HTTP interface"]]. ([http://web.archive.org/web/20050901191213/http://videolan.org/doc/play-howto/en/apb.html "See also old/outdated appendix B"]).

==See also==
* [[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|Building Pages for the HTTP Interface]] (may be obsolete)
* [[Interfaces]]

[[Category:Interfaces]]

{{Documentation footer}}

Template:Documentation TOC

2015-06-11T09:44:11Z

Computergeoffrey:

{| border="0" cellspacing="0" cellpadding="1"
!<big>[[Documentation:User Guide|VLC User Guide]]</big> 
|-
! 
|-
|[[Documentation:Quick Start Guide|Quick Start Guide]]
|-
|[[Documentation:Installing VLC|Installing VLC]]
|-
|[[Documentation:History|History]]
|-
!Usage
|-
|[[Documentation:Interface|Interface]]
|-
|[[Documentation:Open Media|Open Media]]
|-
|[[Documentation:Audio|Audio]]
|-
|[[Documentation:Video|Video]]
|-
|[[Documentation:Playback|Playback]]
|-
|[[Documentation:Playlist|Playlist]]
|-
|[[Documentation:Subtitles|Subtitles]]
|-
|[[Documentation:Video and Audio Filters|Video and Audio Filters]]
|-
|[[Documentation:Snapshots|Snapshots]]
|-
|[[Documentation:Hotkeys|Hotkeys]]
|-
|[[Documentation:Uninstalling VLC|Uninstalling VLC]]
|-
|[[VSG:Main|Troubleshooting]]
|-
!Advanced usage
|-
|[[Documentation:WebPlugin|Using VLC inside a webpage]]
|-
|[[Documentation:Command_line|Command line]]
|-
|[[Documentation:Alternative_Interfaces|Alternative Interfaces]]
|-
|[[Documentation:Misc|Misc]]
|-
! Appendix
|-
|[[Documentation:Building Pages for the HTTP Interface|Building Pages for the HTTP Interface]]
|-
|[[Documentation:Format String|Format String]]
|-
|[[Documentation:Building Lua Playlist Scripts|Building Lua Playlist Scripts]]
|-
|
|-
|align="left"|[[Template:Documentation_TOC|View this alone]]
|}

VSG:Usage:Controller

2015-06-11T08:27:13Z

Computergeoffrey:

== Disable fullscreen controller ==

You can use '''Tools -> Preferences -> Interface''' and untick '''Show controls in full screen mode''' option.

[[Image:VLCShot1.png]]

{{VSG}}

Players

2015-06-11T08:25:31Z

Computergeoffrey: Spelling fix

This page outlines lists some other media players and describes their compatibility with [[VLC media player]]. You might also like to look at the compatibility of your [[Set Top Box]], if you have one.

:''See also: '''[[:Category:Player]]'''.''
===Open Source Players===
* [[Helix]]
* [[Media Player Classic]]
* [[MPlayer]]
* [[Noatun]]
* [[Ogle]]
* [[Songbird]]
* [[Xine]]
* [[XMMS]]

===Proprietary Media Players===
* [[Apple DVD Player]] (by [[Apple]])
* [[Cisco IP/TV Viewer]] (by [[Cisco]])
* [[Elecard MPEG2 decoder]] (by [[Elecard]])
* [[FVC I-TV Viewer]]
* [[iTunes]] (by [[Apple]])
* [[LSX MPEG Player]]
* [[MacTV]]
* [[QuickTime Player]] (by [[Apple]])
* [[RealOne Player]] (by [[RealNetworks]])
* [[VideoCharger Player]] (by [[IBM]])
* [[WinAMP]] (by [[Nullsoft]])
* [[Windows Media Player]] (by [[Microsoft]])

===Links===
A list of available freeware MPEG-4 players with [[RTSP]] capabilities can be found at [http://www.audiocoding.com/modules/wiki/?page=MPEG-4+players audiocoding.com]

[[Category:Player]]