Mods repositories

OvGME allow you to configure distant mods repositories to check for mods download or update. This chapter will deals only with the client side repositories feature. If you want to host and manage a repository, please see the Repository management chapter.
Mods repositories are distant web servers that provide mods for download or update. These web servers must be OvGME compliant to be recognized during the repositories query.
Note: the repositories are provided by a third-party, OvGME does not provide default repository (see Repository management).

#### Configuring repositories

To configure distant repositories for the current configuration, go to the "Mods" menu, select "Repositories" then "Configure...". It will opens you a new dialog to manage repositories URL.
Note: The repositories list is not global, each configuration has its own repositories list. If you configured repositories for a config, this list is only valid for the current selected config.

##### Adding or removing URL

To add a new repository URL into the list, fill the URL entry and click the "Add" button.The URL must be a valid URL to an HTTP server. Here is some examples of valid URL format:

> "http://www.example.com/repos"
> "www.example.com:8080/repository/dcs"
> "http://192.168.0.1:80/mods"

To remove a repository URL from the list, select the desired URL in the list, then click on the "Remove" button.

##### Enabling or disabling URL

Repositories can be enabled or disabled for querying. A disabled repository will not be checked during repositories query, but will still available in the list for future usage.
To enable or disable repository URL simply check or uncheck the checkbox corresponding to the URL in the list.

#### Querying repositories

By querying repositories, OvGME will interrogate each enabled configured repository URL to create the list of available mods for update or download. To query repositories, go to the "Mods" menu, select "Repositories" then "Query...". It will opens you a new dialog.
OvGME will automatically starts the interrogation process. Once the querying is finished, and if it succeed, some mods should appear in the list. Each entry is identified by an icon which describes its status relative to your local mods folder for this configuration.

> : Means that the mod is not present in your local mods folder and can be downloaded.
> : Means that the mod is already present in your local mods folder and has the same version.
> : Means that the mod is already present in your local mods folder but has a lower version than the one available in the repositories (you can upgrade the mod).
> : Means that the mod is already present in your local mods folder but has a greater version than the one available in the repositories (if you download this mod, it will downgrade your local mod).

##### Downloading Mods

To download mods from repositories, you can simply doube-click on the desired mod in the list. You also can select several mods, then click the "Download selected" button. Finally, you can synchronize all your local mods folder by clicking on the "Download all" button.
Downloading mods has several status depending the installation stage.

> Pending... : Means that the mod is in the download list, and pending to be processed.
> Disabling old... : Means that the current local mod is in uninstalling process. Indeed, a mod must be disabled in order to be upgraded or downgraded.
> Downloading... : Means that the mod is currently being downloaded.

There are also several possible error status:

> Host not found : Means that download failed due host resolution error.
> Connection error : Means that download failed due to a connection error to the server.
> HTTP encode error : Means that download failed due to an unsupported HTTP transfer encoding (see below for details).
> HTTP error ### : Means that download failed due to an HTTP server error response (usually 404: not found).
> Connection lost : Means that download failed due to connection lost.
> I/O Open error : Means that download failed due to error on creating file to write on local hard drive.
> I/O Write error : Means that download failed due to error on writing data to file on local hard drive.