Librem Tunnel iOS app is a fork of [PIA VPN for iOS](https://github.com/pia-foss/vpn-ios) customized for [Librem One](https://librem.one) services.
Private Internet Access is the world's leading consumer VPN service. At Private Internet Access we believe in unfettered access for all, and as a firm supporter of the open source ecosystem we have made the decision to open source our VPN clients. For more information about the PIA service, please visit our website [privateinternetaccess.com][pia-url] or check out the [Wiki][pia-wiki].
## Features
* Protect your privacy with secure connection to a VPN tunnel
* Encrypt your network traffic
* Enable optional Safari Content Blocker to stop ads and trackers while browsing with Safari
* High speeds, unlimited bandwidth, up to 5 devices
# PIA VPN for iOS
With the Private Internet Access VPN app for iOS, you can access our network of VPN servers across the world from your iPhone, iPad or iPod touch (64-bit only). Choose among many available countries and connect to them easily. Features include kill switch, multiple VPN protocols, DNS/IPv6 leak protection and Safari Content Blocker for ad-blocking while browsing with Safari.
## Branch setup
*`master` represents the latest release that is currently in the Apple App Store
*`develop` represents the bleeding edge; send your PR's to this branch
*`release/*` represents branches in bug fix cycle with no new features allowed
*`issue/#_*` represets a specific issue being worked on
Assuming you have a [working CocoaPods environment][dep-cocoapods], setting up the app workspace only requires installing the pod dependencies:
$ pod install
After that, open `PIA VPN.xcworkspace` in Xcode and run the `PIA VPN` target.
For the VPN to work properly, the app requires:
- _App Groups_ and _Keychain Sharing_ capabilities
- App IDs with _Packet Tunnel_ entitlements
both in the main app and the tunnel extension target.
### Hotspot Helper API
We use a special entitlement to participate in the process of joining Wi-Fi/hotspot networks (https://developer.apple.com/documentation/networkextension/nehotspothelper)
You need to request this entitlement to Apple or remove the call to `configureHotspotHelper()` in `AppDelegate.swift` and adapt the entitlements file to your needs.
## Contributing
By contributing to this project you are agreeing to the terms stated in the Contributor License Agreement (CLA) [here](/CLA.rst).
For more details please see [CONTRIBUTING](/CONTRIBUTING.md).
Issues and Pull Requests should use these templates: [ISSUE](/.github/ISSUE_TEMPLATE.md) and [PULL REQUEST](/.github/PULL_REQUEST_TEMPLATE.md).
## Authors
- Jose Blaya - [ueshiba](https://github.com/ueshiba)
- Davide De Rosa
- Amir Malik (before 2016)
## License
This project is licensed under the [MIT (Expat) license](https://choosealicense.com/licenses/mit/), which can be found [here](/LICENSE).
