Difference between revisions of "Documentation:Modules/http intf"

From VideoLAN Wiki
Jump to navigation Jump to search
(→‎How to use: document the host/port split)
(update)
Line 1: Line 1:
 
{{Module|name=http|type=Control interface|description=Allows control of VLC over a http connection}}
 
{{Module|name=http|type=Control interface|description=Allows control of VLC over a http connection}}
−
It is possible to [[Control VLC via a browser]] via an extra interface which can be enabled by going to Settings > Add Interface > Web Interface.
+
The '''http''' lua module allows makes it possible to [[Control VLC via a browser]] via an extra interface which can be enabled by going to Settings > Add Interface > Web Interface.
  
 
== How to use ==
 
== 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.
  
−
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 (in versions .8+ you go to Preferences > Interface > General > Interface module: http remote control interface. In later versions it might be preferences -> All radio button -> Interface -> Main interfaces -> check HTTP remote control). 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.
−
 
 
−
Now when you start VLC, a web interface will be created and running on your computer on port 8080.  
 
  
 
The following option can be used to specify an IP and a different port on which you want to run the interface.
 
The following option 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===
  
−
VLC < 1.2.x
 
−
  --http-host host:port
 
−
 
−
  or on Windows platforms:
 
−
  --http-host'''='''host:port
 
−
VLC > 1.2.x
 
 
   --http-host host
 
   --http-host host
 
   --http-port port
 
   --http-port port
Line 23: Line 17:
 
   --http-port'''='''port
 
   --http-port'''='''port
  
−
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.
+
To enable the http interface as a primary or extra interface, go to Tools -> Preferences (select "All" radiobutton) -> Interface -> Main interfaces -> check "Lua interpreter" -> expand "Main interfaces" -> Select lua -> Type in "http" in "Lua interface field".
 +
 
 +
===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 ==
 
== Configure ==
  
 
=== Access control ===
 
=== Access control ===
−
 
 
Access control - specific IPs or ranges of IP addresses - to the http interface can be done globally by editing "/usr/share/vlc/http/.hosts" (or "%PROGRAMFILES%\VideoLAN\VLC\http\.hosts" for Windows).
 
Access control - specific IPs or ranges of IP addresses - to the http interface can be done globally by editing "/usr/share/vlc/http/.hosts" (or "%PROGRAMFILES%\VideoLAN\VLC\http\.hosts" for Windows).
 
  Note that the global file gets overwritten when/if you reinstall/upgrade VLC.
 
  Note that the global file gets overwritten when/if you reinstall/upgrade VLC.
Line 36: Line 37:
  
 
=== Customization ===
 
=== 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).
 
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).
  
Line 42: Line 42:
  
 
== Notes ==
 
== 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.
−
''Note:'' 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 handhelp 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.
−
 
 
−
''Note:'' A new http interface is available since 0.8.5. However this new interface does not work on handhelp 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.
 
−
 
 
  
 
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://videolan.org/doc/play-howto/en/apb.html"See also old/outdated appendix B"].
 
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://videolan.org/doc/play-howto/en/apb.html"See also old/outdated appendix B"].
  
−
=== Related topic ===
+
==See also==
−
[[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|Building Pages for the HTTP Interface]]
+
* [[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|Building Pages for the HTTP Interface]] (may be obsolete)
−
 
+
* [[Interfaces]]
−
[[Interfaces]]
 
  
 
[[Category:Interfaces]]
 
[[Category:Interfaces]]
  
 
{{Documentation}}
 
{{Documentation}}

Revision as of 03:48, 6 February 2012

Module: http
Type Control interface
First VLC version -
Last VLC version -
Operating system(s) all
Description Allows control of VLC over a http connection
Shortcut(s) -

The http lua module allows makes it possible to Control VLC via a browser via an extra 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.

The following option 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 interface as a primary or extra interface, go to Tools -> Preferences (select "All" radiobutton) -> Interface -> Main interfaces -> check "Lua interpreter" -> expand "Main interfaces" -> Select lua -> Type in "http" in "Lua interface field".

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

Access control - specific IPs or ranges of IP addresses - to the http interface can be done globally by editing "/usr/share/vlc/http/.hosts" (or "%PROGRAMFILES%\VideoLAN\VLC\http\.hosts" for Windows). 

Note that the global file gets overwritten when/if you reinstall/upgrade VLC.
This is solved by some 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/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 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 handhelp 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 http://<ip>:<port>/old/ 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.

For more information about the HTTP interface, see the document "VLC Play-Howto", the paragraph "The HTTP interface" in chapter 4 ("Advanced use of VLC") and "Building pages for the HTTP interface". "See also old/outdated appendix B".

See also

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.
Retrieved from "https://wiki.videolan.org/index.php?title=Documentation:Modules/http_intf&oldid=21618"