Web interface: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(7 intermediate revisions by 4 users not shown)
Line 3: Line 3:
== Turning on the web interface ==
== Turning on the web interface ==


The webserver is disabled by default and has to be manually enabled by the user. This can be done in {{highlight|bordered=yes|[[Settings/Services#Webserver|Settings  → Services → Webserver → Allow control of {{Kodi}} via HTTP]]}}. The settings allow to specify a custom port number and an optional username and password for HTTP's [http://en.wikipedia.org/wiki/Basic_access_authentication Basic Access Authentication]. Furthermore a [[Web interface]] can be chosen which will be used when accessing the webserver without any specific path.
The webserver is disabled by default and has to be manually enabled by the user. This can be done in {{highlight|bordered=yes| Settings  → Services → Control → Allow remote control via HTTP}}. The settings allow to specify a custom port number and an optional username and password for HTTP's [http://en.wikipedia.org/wiki/Basic_access_authentication Basic Access Authentication]. Furthermore a Web interface can be chosen which will be used when accessing the webserver without any specific path.


== Using the web interface ==
== Using the web interface ==
Line 10: Line 10:
=== Default web interface ===
=== Default web interface ===


To set a web interface add-on as the default web UI, go to {{highlight|bordered=yes| [[Settings/Services#Webserver|System -> Services -> Webserver]] }} and select that add-on for the '''Default''' value. Then go to the hostname (or IP address) of that HTPC+Port number.
To set a web interface add-on as the default web UI, go to {{highlight|bordered=yes| System -> Services -> Control }} and select that add-on for the '''Default''' value. Then go to the hostname (or IP address) of that HTPC+Port number.


{{note|Some platforms use port 80, which is the assumed port if no port is given in the address.}}
{{note|Some platforms use port 80, which is the assumed port if no port is given in the address.}}
Line 20: Line 20:
[[File:WebUI.png|400px|border|right|A listing of all add-ons with web interfaces.]]
[[File:WebUI.png|400px|border|right|A listing of all add-ons with web interfaces.]]


Let's say <code><nowiki>http://123.4.5.6:8080</nowiki></code> is your local IP for accessing your default web interface add-on. You can access the other [[:Category:Web interface add-ons|web interface add-ons]] you have installed by going to <code><nowiki>http://123.4.5.6:8080</nowiki>/addons/</code> where you will see a directory listing.
Let's say <code><nowiki>http://123.4.5.6:8080</nowiki></code> is your local IP for accessing your default web interface add-on. You can access the other web interface add-ons you have installed by going to <code><nowiki>http://123.4.5.6:8080</nowiki>/addons/</code> where you will see a directory listing.


For example, <code><nowiki>http://10.0.0.3:8080/addons/</nowiki></code> or <code><nowiki>http://192.168.1.7/addons/</nowiki></code>
For example, <code><nowiki>http://10.0.0.3:8080/addons/</nowiki></code> or <code><nowiki>http://192.168.1.7/addons/</nowiki></code>
{{-}}


== Manually enabling remote control ==
== Manually enabling remote control ==
Line 33: Line 35:
{{bigger|'''guisettings.xml -'''}}
{{bigger|'''guisettings.xml -'''}}
:Normally you do not want to manually edit the guisettings.xml file. In this case it should be "safe", but only change these settings from <code>false</code> to <code>true</code>, and don't edit other things.
:Normally you do not want to manually edit the guisettings.xml file. In this case it should be "safe", but only change these settings from <code>false</code> to <code>true</code>, and don't edit other things.
:# Edit the guisettings.xml file in the [[userdata folder]] and look for the following settings under "<code><services></code>", and make sure they are set to "true". You'll have to look for them a little bit, because there among several other settings. Assuming you have not set a password or changed other default settings, this should work:
:# Edit the guisettings.xml file in the [[Userdata|userdata folder]] and look for the following settings under "<code><services></code>", and make sure they are set to "true". You'll have to look for them a little bit, because there among several other settings. Assuming you have not set a password or changed other default settings, this should work:
:#:* <esallinterfaces> - '''true'''
:#:* <esallinterfaces> - '''true'''
:#:* <webserver> - '''true'''
:#:* <webserver> - '''true'''
Line 45: Line 47:
:# Create a '''plain text file''' (no rich text formatting, don't use .doc, etc) and save it as '''advancedsettings.xml'''. Make sure that the file extension is ".xml" and {{color|red|'''not'''}} ".txt" or ".xml.txt".
:# Create a '''plain text file''' (no rich text formatting, don't use .doc, etc) and save it as '''advancedsettings.xml'''. Make sure that the file extension is ".xml" and {{color|red|'''not'''}} ".txt" or ".xml.txt".
:# Cut and paste this into your new plain text file:
:# Cut and paste this into your new plain text file:
:#: <syntaxhighlight lang="xml" enclose="div">
:#: <syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<advancedsettings>
     <services>
     <services>
Line 54: Line 56:
</advancedsettings>
</advancedsettings>
</syntaxhighlight>
</syntaxhighlight>
:# Save this file in your [[userdata folder]]
:# Save this file in your [[Userdata|userdata folder]]
:#: {{note|If you have an existing advancedsettings.xml file, make sure the tags are between the main <code><advancedsettings></advancedsettings></code> tags.}}
:#: {{note|If you have an existing advancedsettings.xml file, make sure the tags are between the main <code><advancedsettings></advancedsettings></code> tags.}}
:# Restart Kodi.
:# Restart Kodi.
Line 60: Line 62:




{{hidden|1=[[userdata folder]] location:|2={{#lst:userdata|location all}} }}
{{hidden|1=[[Userdata|userdata folder]] location:|2={{#lst:userdata|location all}} }}
<section end="manual" />
<section end="manual" />


== See also ==
 
* [[Remote controls]]
* [[Add-on:Default web interface]]
* [[:Category:Web interface add-ons]]
* [[:Category:Standalone web interfaces]]
* [[Webserver]]


{{Isengard updated}}
{{Isengard updated}}
Line 75: Line 72:
[[Category:Remotes]]
[[Category:Remotes]]
[[Category:Add-ons]]
[[Category:Add-ons]]
[[Category:Web interface add-ons|*]]
[https://kodi.tv/article/new-webinterface-called-chorus2 Chorus2]

Latest revision as of 02:50, 23 July 2020

Web interfaces allow users to control and interact with their Kodi installation through a web browser. This can be used for a remote control, library management, visual feedback, and many other things.

Turning on the web interface

The webserver is disabled by default and has to be manually enabled by the user. This can be done in Settings → Services → Control → Allow remote control via HTTP. The settings allow to specify a custom port number and an optional username and password for HTTP's Basic Access Authentication. Furthermore a Web interface can be chosen which will be used when accessing the webserver without any specific path.

Using the web interface

There are two options to use any given web interface:

Default web interface

To set a web interface add-on as the default web UI, go to System -> Services -> Control and select that add-on for the Default value. Then go to the hostname (or IP address) of that HTPC+Port number.

Note: Some platforms use port 80, which is the assumed port if no port is given in the address.

For example, http://10.0.0.3:8080 or http://192.168.1.7


Using multiple web interfaces at once

A listing of all add-ons with web interfaces.

Let's say http://123.4.5.6:8080 is your local IP for accessing your default web interface add-on. You can access the other web interface add-ons you have installed by going to http://123.4.5.6:8080/addons/ where you will see a directory listing.

For example, http://10.0.0.3:8080/addons/ or http://192.168.1.7/addons/


Manually enabling remote control

If you have installed Kodi on a device and it has started up in Kodi, and you either have SSH access or other access to the Kodi userdata folder, you can manually enable remote control. This is helpful in a few situations, for example: If you have a networked device but no physical remote control (left it at home, can't find the dang remote, etc), you can still use the web interface or a smartphone/tablet app to control Kodi.

There are two basic ways to do this:


guisettings.xml -

Normally you do not want to manually edit the guisettings.xml file. In this case it should be "safe", but only change these settings from false to true, and don't edit other things.
  1. Edit the guisettings.xml file in the userdata folder and look for the following settings under "<services>", and make sure they are set to "true". You'll have to look for them a little bit, because there among several other settings. Assuming you have not set a password or changed other default settings, this should work:
    • <esallinterfaces> - true
    • <webserver> - true
    • <zeroconf> - true
  2. Save the file and restart Kodi.


advancedsettings.xml -

While using an advancedsettings.xml file might be easier to enable these services, doing so will hide them from the normal Kodi GUI. You will have to remove or edit the advancedsettings.xml file to turn these settings back off, which can be confusing later on if you forgot you have an advancedsettings.xml file.
  1. Create a plain text file (no rich text formatting, don't use .doc, etc) and save it as advancedsettings.xml. Make sure that the file extension is ".xml" and not ".txt" or ".xml.txt".
  2. Cut and paste this into your new plain text file:
    <advancedsettings>
        <services>
            <esallinterfaces>true</esallinterfaces>
            <webserver>true</webserver>
            <zeroconf>true</zeroconf>
        </services>
    </advancedsettings>
  3. Save this file in your userdata folder
    Note: If you have an existing advancedsettings.xml file, make sure the tags are between the main <advancedsettings></advancedsettings> tags.
  4. Restart Kodi.




Chorus2