VideoLAN Wiki - User contributions [en]

Documentation:Modules/http intf

2009-11-03T15:29:46Z

Marinmo:

{{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.

== 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 (in versions .8+ you go to Preferences > Interface > General > Interface module: http remote control interface. 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 on port 8080. The option --http-host host:port (--http-host=host:port on Windows) can be used to specify an IP and the port on which you want to run the interface.

For you information, you can connect to a web-server listening on an arbitrary port using http://server:port syntax, so you can test VLC web interface using this URL: http://127.0.0.1:8080.

== 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 [http://www.orrentdesign.com/outsideResources/VLC_Graphite.zip OrrentDesign.com]. A readme file is included. View for install instructions and other info.

== Notes ==

''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.

''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 appendix B [http://videolan.org/doc/play-howto/en/apb.html"Building pages for the HTTP interface"]. See also [[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|the updated version of that appendix on the wiki]].

=== Related topic ===
[[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|Building Pages for the HTTP Interface]]

[[Interfaces]]

[[Category:Interfaces]]

{{Documentation}}

Documentation:Modules/http intf

2009-11-02T16:45:02Z

Marinmo: submitted changes due to xdg spec not being followed / updated for correctness

{{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.

== 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 (in versions .8+ you go to Preferences > Interface > General > Interface module: http remote control interface. 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 on port 8080. The option --http-host host:port (--http-host=host:port on Windows) can be used to specify an IP and the port on which you want to run the interface.

For you information, you can connect to a web-server listening on an arbitrary port using http://server:port syntax, so you can test VLC web interface using this URL: http://127.0.0.1:8080.

== 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).  Do note that the global file gets overwritten when/if you reinstall/upgrade VLC.

=== 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 ==

''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.

''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 appendix B [http://videolan.org/doc/play-howto/en/apb.html"Building pages for the HTTP interface"]. See also [[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|the updated version of that appendix on the wiki]].

=== Related topic ===
[[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|Building Pages for the HTTP Interface]]

[[Interfaces]]

[[Category:Interfaces]]

{{Documentation}}

Documentation:Modules/http intf

2009-11-02T16:23:38Z

Marinmo:

{{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.

== 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 (in versions .8+ you go to Preferences > Interface > General > Interface module: http remote control interface. 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 on port 8080. The option --http-host host:port (--http-host=host:port on Windows) can be used to specify an IP and the port on which you want to run the interface.

For you information, you can connect to a web-server listening on an arbitrary port using http://server:port syntax, so you can test VLC web interface using this URL: http://127.0.0.1:8080.

== 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).  Do note that the global file gets overwritten when/if you reinstall/upgrade VLC.

=== 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 ==

''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.

''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 appendix B [http://videolan.org/doc/play-howto/en/apb.html"Building pages for the HTTP interface"]. See also [[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|the updated version of that appendix on the wiki]].

=== Related topic ===
[[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|Building Pages for the HTTP Interface]]

[[Interfaces]]

[[Category:Interfaces]]

{{Documentation}}

Documentation:Modules/http intf

2009-10-31T13:21:31Z

Marinmo: added info about access control. only linux atm though as that's what I use.

{{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.

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. 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 on port 8080. The option --http-host host:port (--http-host=host:port on Windows) can be used to specify an IP and the port on which you want to run the interface.

Access control - specific IPs or ranges of IP addresses - to the http interface can be done globally by editing "/usr/share/vlc/http/.hosts". For a single user the corresponding file is "~/.local/share/vlc/http/.hosts". Do note that the global file gets overwritten when/if you reinstall/upgrade VLC.

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.

''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.

''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 appendix B [http://videolan.org/doc/play-howto/en/apb.html"Building pages for the HTTP interface"]. See also [[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|the updated version of that appendix on the wiki]].

===Related topic===
[[Documentation:Play_HowTo/Building_Pages_for_the_HTTP_Interface|Building Pages for the HTTP Interface]]

[[Interfaces]]

[[Category:Interfaces]]

{{Documentation}}