Add-on manager: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
Line 90: Line 90:
For this example a skin is being installed, the same method is used for other add-ons.
For this example a skin is being installed, the same method is used for other add-ons.
;{{highlight| Select ''Install from repository'' -> Select the repository {{small|(if no other repositories are installed it will automatically open the Kodi Add-on repository)}} -> Select the add-on category -> Select the add-on -> Select ''Install''|bordered=yes}}
;{{highlight| Select ''Install from repository'' -> Select the repository {{small|(if no other repositories are installed it will automatically open the Kodi Add-on repository)}} -> Select the add-on category -> Select the add-on -> Select ''Install''|bordered=yes}}
See: [[Add-on_manager#How_to_access_the_Add-on_browser]]
See: [[Add-on_manager#How_to_access_the_Add-on_browser|How to access the Add-on browser]]
<gallery widths=500px heights=313px>
<gallery widths=500px heights=313px>
File:Installaddon1.png|'''Step 1:''' Select '''Install from repository'''.  If no other repositories are installed then this will open directly into the '''Kodi Add-on Repository'''.  If other repositories then a different window will open allowing you the choice of which repository you want to use.
File:Installaddon1.png|'''Step 1:''' Select '''Install from repository'''.  If no other repositories are installed then this will open directly into the '''Kodi Add-on Repository'''.  If other repositories then a different window will open allowing you the choice of which repository you want to use.

Revision as of 18:01, 16 April 2017

Home icon grey.png   ▶ Settings
▶ Add-ons
▶ Add-on manager

The Add-on manager's purpose is to manage the various add-ons to the Kodi application. It can be browsed like any other section and the various installed/uninstalled, enabled/disabled add-ons. In the Add-on manager you can also change the settings for auto update, notifications and search for installed add-ons by bringing up the slide in submenu (press left to show/hide). The Add-on manager is not where you go to run add-ons, but only to install and configure them.

How to access the Add-on browser

Note: You may also enter into the Add-on manager (see below) by just selecting Add-ons as show in Step 1

How to access the Add-on manager


Add-on manager options

My add-ons
All installed add-ons, disabled or not, can be found in "My add-ons". This includes both a per-category listing as well as a single unified list of all installed add-ons.
Available updates
When an update to an add-on is available it will show up here. By default, add-ons are set to update automatically, so this should normally be empty unless you have changed your preferences to prevent automatic update installs.
Recently updated
Shows as list of recently updated add-ons.
Install from repository
Allows you to install new add-ons from the installed repositories. Kodi.tv add-on repository is the official add-on repository that is already included in Kodi, but other add-on repository sources can also be installed. (see How to install additional add-on repositories for more info)
Install from ZIP file
Allows the installation of an add-on or repository from a ZIP file, either from the hard drive or LAN.
Search
Allows you to search add-ons in the installed repositories and your installed add-ons.

Lefthand sidebar menu

Add-on manager sidebar menu.png

View options
View
The view mode that items are displayed as. Similar to other areas of the interface, such as the video and audio libraries. Common view modes include lists, icons, and variations on those.
Order
This allows you to order add-ons/repositories by Ascending or Descending.
Sort by
This will allow you to sort add-ons by Name or Last used.
Search
Allows you to search add-ons in the installed repositories and your installed add-ons.
Check for updates
This will search for updates for all add-ons.
Settings
This will take you Add-ons settings page in Settings/System (see below).
Get more
This will allow you to download and install other add-ons from a particular category.

Note: Not all options will appear depending on what part of the Add-ons section you are in.


Settings/System/Add-ons settings
Updates
Choose how updates are handled. Options are as follows:
  • Install updates automatically At least once a day, add-ons that are listed in a repo will automatically be updated if an update is available. If the "Notifications" option is also enabled, then the user will receive an on-screen notification about the available update and install.
  • Notify, but don't install updates The same as above, but the update itself will not automatically install. The user will get a notification of available updates, and an "Available updates" folder will appear in the add-on manager list, allowing the user to manually apply updates either for all add-ons or per-add-on.
  • Never check for updates Kodi will not check for updates nor will it install any known pending updates. The user will also not get any notifications, because Kodi won't know about any pending updates.
Show notifications
If "Install updates automatically" or "Notify, but don't install updates" are selected for Updates, then selecting this will also show a notification in the Kodi GUI if add-on updates are found.
Manage dependencies
This will all you to individually update dependencies which are need by other add-ons.
Running
This will allow you to what add-ons are running.
Unknown sources
This will allow you to install or block add-ons from unknown sources. You will need to enable this for installing any add-on/repository not in the Kodi Add-on repository.
Reset above settings to default
This will reset all the Add-on settings to their defaults.


How to install add-ons from a repository

For this example a skin is being installed, the same method is used for other add-ons.

Select Install from repository -> Select the repository (if no other repositories are installed it will automatically open the Kodi Add-on repository) -> Select the add-on category -> Select the add-on -> Select Install

See: How to access the Add-on browser

When the add-on has finished downloading Kodi will enable it and depending on the add-on ask if you want to start using it. Add-ons will then appear in their appropriate section (e.g. skins in the appearance section of settings, movie scrapers in the options of scrapers when adding a new movie source)


How to install from a ZIP file

In this example the hybrid repository is being installed, but the method is the same for add-ons. First download the ZIP file, then:

Settings → Add-ons → Install from zip file -> Navigate to the ZIP file


Repositories

Repositories are storage locations from where add-ons can be retrieved from. They allow the user to browse for more add-ons of all types, as well as allowing Kodi to check them for updates to add-ons, so they don't have to be manually installed. Kodi comes with one official add-on repositories installed by default, Kodi.tv add-on repository. However others can be added.


To install a new repository you must first find the ZIP file to install the repository, a list of 3rd party add-on repositories is semi-maintained on the wiki - other repositories may exist. Then follow the instructions at How to install from a ZIP file.

Updating

Slide in submenu, with Add-on manager settings. Editor note: needs updated screenshot
A notification that an add-on has been installed and enabled.Editor note: needs updated screenshot

To manually update add-ons or change update settings, from the home screen go to the add-on manager and bring up the lefthand sidebar menu.

By default Auto update is enabled and all installed add-ons will be automatically updated when new versions are available from the repositories.

If you want to enable/disable auto-updates, while in the add-on manager bring up the slide in submenu (press right to show/hide) and enable/disable Auto update. You can still select to be notified of updates being available, allowing you to choose to apply the updates or not on a per-add-on basis, or not check for updates at all.

If auto update is turned off you should see a folder in the add-on manager that says Available updates, where you can go in and one-by-one and update add-ons.

Installing an add-on from a ZIP file can lead to it not having a repository associated with it. Automatic or manual (using Available Updates folder) update will then not be available. You can of course manually update the add-on by downloading a ZIP file with the new version. If you later install the associated repository the add-on will be able to get automatically or manually updated.

Update options

Full update options are seen in the Lefthand sidebar menu:


Updates
Choose how updates are handled. Options are as follows:
  • Install updates automatically At least once a day, add-ons that are listed in a repo will automatically be updated if an update is available. If the "Notifications" option is also enabled, then the user will receive an on-screen notification about the available update and install.
  • Notify, but don't install updates The same as above, but the update itself will not automatically install. The user will get a notification of available updates, and an "Available updates" folder will appear in the add-on manager list, allowing the user to manually apply updates either for all add-ons or per-add-on.
  • Never check for updates Kodi will not check for updates nor will it install any known pending updates. The user will also not get any notifications, because Kodi won't know about any pending updates.


Notifications

Update/install notifications, which can be toggled on/off in the submenu, will show up in the right bottom corner and will notify you that:

  • a new version of an add-on is available, if you have Auto update disabled.
  • an add-on has been updated, if you have Auto update enabled.
  • an add-on has been enabled (only when installing a new add-on or when doing rollbacks).
  • an installation has failed.

Note: Notification windows only show up for a few seconds and then disappear.

Rollback

Rollback is a function to reinstall a previous version of an add-on. The reason to do this can be that you don't like the new version (e.g changed features) or that the new version introduced a bug.

Rollback is only available if you've had a previous version installed before getting the add-on manually or automatically updated. I.e. if you install a new add-on only the latest version will be installed, thus you can't rollback to any other version.

If you rollback from version B to A and version C is added to its repository the add-on will automatically get updated (if you have Auto update enabled) to version C and you'll have to rollback again to version A. To stop this from happening disable Auto update or uninstall the associated repository. The latter is not always practical or even possible, e.g. the official repositories.

To do a rollback, from the home screen go to the Add-on manager

System -> Add-ons

then

Select Enabled Add-ons -> Select the category -> Select the add-on -> Select Rollback -> Select a previous version to reinstall

See also

Development: