Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
This is a Kodi addon that's designed to make it easy to set up and manage VPN connections from within Kodi.
- Connect to VPN when Kodi starts; or before Kodi starts (LibreELEC only)
- Vary the level of privacy required by automatically switching between different VPN connections (or disconnect) based on add-on or Kodi window being used.
- Integration with TV Guide Fullscreen to change the VPN connections with the channels being used.
- Native support for ~30 VPN providers, plus a wizard to add additional unsupported providers / user managed VPN servers.
- Monitor VPN connection and reconnect when necessary
- Supports both UDP and TCP connections where available, using the default or user defined port
- Easy display and manual switching of VPN connections from a single button/remote key
- User API and third party add-on APIs
- Display screen overlay of current system information from a single button/remote key
- (And randomly a local unetwork speed test utility and system reboot timer)
Risks in using a VPN
If you think you need a VPN then it's likely you appreciate the benefits, but you should also understand that by introducing a VPN tunnel from your Kodi box to the outside world you bypass your firewall and the protection that gives you from external connections and attacks.
Some VPN providers appear to provide some rudimentary form of filtering/blocking and some do not. If your provider does not provide filtering then SSH access to your Kodi box as well as access to the web interface by entities outside of your network may be possible. For Kodi builds like LibreELEC this is especially bad as they use a default user ID and password.
After you have installed the add-on and connected to the outside world, you will be told which IP address the Kodi box is using. You should try and SSH to this address from another computer. You should also enter the IP address into a web browser and see if the web interface is displayed. If either of these things work, you are not protected. You should consider if you can make changes to your firewall, use an up/down script, using an SSH key rather than a password and disabling the web interface. Alternatively, determine whether using a VPN is right for you.
- LibreELEC (7.x onwards)
- OpenELEC (5 onwards)
- Other Linux based installs (e.g. OSMC)
- Windows (Windows 7 tested)
- Android is not supported
Supported VPN providers
- PIA / Private Internet Access
- Invisible Browsing VPN
- Hide My Ass!
- Perfect Privacy
- BTGuard VPN
- Celo VPN.ht
- Windscribe (Pro accounts)
- VPN Unlimited
The following providers have been added, but have not been verified as working yet.
- Smart DNS Proxy
- Hide.me (might have been fixed now, otherwise see here)