passepartout-apple/README.md

176 lines
6.0 KiB
Markdown
Raw Normal View History

2018-10-19 00:13:20 +00:00
<p style="text-align: center; padding: 2em"><img src="res/logo.png" /></p>
2018-10-19 00:16:10 +00:00
# [Passepartout][about-website]
2018-10-11 07:13:19 +00:00
Passepartout is a non-official, user-friendly [OpenVPN®][openvpn] client for iOS.
Passepartout relies on [TunnelKit][dep-tunnelkit] for most VPN functionality.
## Beta
Passepartout is in public beta. You can get early versions of the app via [TestFlight][about-testflight].
2018-10-18 23:46:22 +00:00
<a href="https://www.patreon.com/keeshux"><img src="https://c5.patreon.com/external/logo/become_a_patron_button@2x.png" width="160"></a>
2018-10-11 07:13:19 +00:00
By using a beta version of the app, you understand that the software might be unstable, unreliable or plain broken from time to time.
2018-10-18 23:29:11 +00:00
## Support
Subscribe to the [/r/passepartout][about-reddit] subreddit for issues, feature requests and general discussion.
There is also a public group on [Telegram][about-telegram].
2018-10-11 07:13:19 +00:00
## Overview
### All profiles in one place
Passepartout lets you handle multiple profiles in one single place and quickly switch between them.
2018-10-14 23:29:30 +00:00
[<img src="res/snap-home.png" width="300">](res/snap-home.png)
2018-10-11 07:13:19 +00:00
### Ease of use
With its native look & feel, Passepartout focuses on ease of use. It does so by stripping the .ovpn flags that are today obsolete or rarely used. With good approximation, it mimics the most relevant features you will find in OpenVPN 2.4.x.
2018-10-14 23:29:30 +00:00
[<img src="res/snap-profile.png" width="300">](res/snap-profile.png)
2018-10-11 07:13:19 +00:00
### Trusted networks
Trust cellular or Wi-Fi networks to fine-grain your connectivity. You can then choose to retain a VPN connection when entering a trusted network, or prevent it completely.
2018-10-14 23:29:30 +00:00
[<img src="res/snap-trusted.png" width="300">](res/snap-trusted.png)
2018-10-11 07:13:19 +00:00
### See your connection parameters
Passepartout strives for transparency, by showing a fairly detailed yet understandable resume of your connection parameters.
2018-10-14 23:29:30 +00:00
[<img src="res/snap-parameters.png" width="300">](res/snap-parameters.png)
2018-10-11 07:13:19 +00:00
### Disconnect on sleep
Keeping the VPN active in the background provides smoother operation, but may be tough for the battery. You might want to use this feature if you're concerned about battery life. When the device goes to sleep, the VPN will disconnect to then reconnect on device wake-up.
### No unrequested activity
Passepartout is a VPN client and does absolutely nothing else without your consent. The providers infrastructures are obtained via a [static GitHub API][app-api] only and only if you manually refresh them.
2018-10-11 07:13:19 +00:00
### Presets for major providers
Passepartout can connect to a few well-known VPN providers with an existing account:
- [Private Internet Access][app-net-pia]
2018-10-11 07:13:19 +00:00
- ...more soon!
In preset mode, you can pick pre-resolved IPv4 endpoints when DNS is problematic.
### Import .ovpn profiles
Passepartout can import .ovpn configuration files. This way you can fine-tune encryption without tweaking and reimporting a new configuration. Below are a few limitations worth mentioning.
Unsupported (yet):
- TLS wrapping
- `--tls-auth`
- `--tls-crypt`
- UDP fragmentation, i.e. `--fragment`
Unsupported (probably ever):
- Compression
- `--comp-lzo` other than `no`
- `--compress` other than empty
- External file references (inline `<block>` only)
Ignored:
- MTU overrides
- `--*-mtu` and variants
- `--mssfix`
- Multiple `--remote` (first wins)
Other flags are ignored too but planned to be implemented.
## Installation
### Requirements
- iOS 11.0+
- Xcode 10+ (Swift 4.2)
- Git (preinstalled with Xcode Command Line Tools)
- Ruby (preinstalled with macOS)
- [CocoaPods 1.4.0][dep-cocoapods]
It's highly recommended to use the Git and Ruby packages provided by [Homebrew][dep-brew].
### Testing
Download the app codebase locally:
$ git clone https://github.com/keeshux/passepartout-ios.git
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 `Passepartout.xcworkspace` in Xcode and run the `Passepartout-iOS` 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.
## License
This project is licensed under the [GPLv3][license-content].
### Contributing
By contributing to this project you are agreeing to the terms stated in the [Contributor License Agreement (CLA)][contrib-cla]. For more details please see [CONTRIBUTING][contrib-readme].
## Credits
The logo is taken from the awesome Circle Icons set by Nick Roach.
2018-10-11 07:47:40 +00:00
- SwiftyBeaver - © 2015 Sebastian Kreutzberger
- MBProgressHUD - © 2009-2016 Matej Bukovinski
2018-10-11 07:13:19 +00:00
© 2002-2018 OpenVPN Inc. - OpenVPN is a registered trademark of OpenVPN Inc.
## Disclaimer
2018-10-11 07:20:17 +00:00
Passepartout is a VPN client based on independent work. As such, the developer -while making his best efforts to avoid it- takes no responsibility about any damage caused by the use of this software.
2018-10-11 07:13:19 +00:00
Additionally, the developer takes no responsibility about data usage, monitoring, logging etc. by the servers you connect to. Passepartout is not even involved in the above choices, as they're part of server-side policies.
For more information about data usage by third parties, please review the privacy policy of your VPN provider.
## Contacts
Twitter: [@keeshux][about-twitter]
Website: [passepartoutvpn.app][about-website]
[openvpn]: https://openvpn.net/index.php/open-source/overview.html
[app-api]: https://github.com/keeshux/passepartout-api
[app-net-pia]: https://www.privateinternetaccess.com
2018-10-11 07:13:19 +00:00
[dep-cocoapods]: https://guides.cocoapods.org/using/getting-started.html
[dep-jazzy]: https://github.com/realm/jazzy
[dep-brew]: https://brew.sh/
[dep-tunnelkit]: https://github.com/keeshux/tunnelkit
[dep-openssl]: https://www.openssl.org/
[license-content]: LICENSE
[contrib-cla]: CLA.rst
[contrib-readme]: CONTRIBUTING.md
[about-twitter]: https://twitter.com/keeshux
[about-website]: https://passepartoutvpn.app
2018-10-13 13:28:19 +00:00
[about-patreon]: https://www.patreon.com/keeshux
2018-10-11 07:13:19 +00:00
[about-testflight]: https://testflight.apple.com/join/XHzgXj6m
2018-10-18 23:29:11 +00:00
[about-reddit]: https://www.reddit.com/r/passepartout
[about-telegram]: https://t.me/passepartoutvpn