Skip to content
This repository has been archived by the owner. It is now read-only.


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.

This repository has been set to archived (read-only) as I no longer use Kodi, so development of this plugin has stopped.

OpenVPN for Kodi

A script that allows you to control OpenVPN from within Kodi.


  • Start and stop OpenVPN from with Kodi.
  • Setup multiple VPN connections.
  • Display current geo-location.


Select OpenVPN configuration dialog

Geo-location notifications


Download the latest zip file and install the addon. See for more details on installing addons from zip file.


The SimilarTracks script can be accessed from the Programs menu or called using the RunScript builtin function (RunScript(script.openvpn)). The script can be passed the following arguments; e.g. RunScript(script.openvpn, Los Angeles).

import: Run the import configuration dialog.

delete: Run the delete configuration dialog.

location: Display the current geo-location. Uses IPInfoDB API.

disconnect: Disconnect the current OpenVPN connection.

<openvpn configuration>: Run the specified OpenVPN configuration.


The following settings are available.

Import OpenVPN Configuration File: Selecting this setting invokes the import configuration dialog.

Delete OpenVPN Configuration File: Selecting the option invokes the delete configuration dialog.

OpenVPN: Set this to the OpenVPN binary. Default: /usr/bin/openvp

Management IP Address: Use this option to change the IP address used by OpenVPN management interface. Default:

Management Port: Use this option to change the port used by the OpenVPN management interface. Default: 1337

Additional Arguments: Use this option to specify any extra command line arguments to be supplied to OpenVPN.

Use sudo when running OpenVPN: Set this option to true if you require OpenVPN to be run using sudo. Default: false

Password is required: Set to true if a password is required when using sudo. Default: true


Is this plugin available in a Kodi addons repository? No

I can't get the OpenVPN plugin to work on Raspberry Pi? Before asking me for help I suggest reading the following guide.


OpenVPN for Kodi is licensed under the GPL 3.0 license.