VPN client for Apple platforms.
Go to file
Davide De Rosa 4b075bcc95 Improve alerts on configuration import error
Issue reporting is currently disabled because un unparsed .ovpn
may contain sensitive data.
2018-10-27 09:43:57 +02:00
Passepartout Improve alerts on configuration import error 2018-10-27 09:43:57 +02:00
Passepartout-iOS Improve alerts on configuration import error 2018-10-27 09:43:57 +02:00
Passepartout-iOS-Tunnel Find out version/build statically 2018-10-18 14:02:35 +02:00
Passepartout.xcodeproj Refactor configurations in service extension 2018-10-27 09:42:41 +02:00
Passepartout.xcworkspace Initial commit 2018-10-11 09:13:19 +02:00
PassepartoutTests-iOS Strip configuration file before attaching 2018-10-27 09:42:41 +02:00
ci Do not autotag alpha builds 2018-10-19 18:00:00 +02:00
fastlane Fix TestFlight app description 2018-10-23 19:21:47 +02:00
res Add logo on top 2018-10-19 02:22:32 +02:00
.env Fix TestFlight app description 2018-10-23 19:21:47 +02:00
.env.beta-archive Initial commit 2018-10-11 09:13:19 +02:00
.env.beta-deploy Initial commit 2018-10-11 09:13:19 +02:00
.env.dev-archive Initial commit 2018-10-11 09:13:19 +02:00
.env.dev-deploy Initial commit 2018-10-11 09:13:19 +02:00
.gitignore Fix TestFlight app description 2018-10-23 19:21:47 +02:00
CHANGELOG.md Set beta release 2018-10-26 19:10:03 +02:00
CLA.rst Initial commit 2018-10-11 09:13:19 +02:00
CONTRIBUTING.md Initial commit 2018-10-11 09:13:19 +02:00
Gemfile Initial commit 2018-10-11 09:13:19 +02:00
LICENSE Initial commit 2018-10-11 09:13:19 +02:00
Podfile Update TunnelKit and remove unused code 2018-10-26 19:05:25 +02:00
Podfile.lock Update TunnelKit and remove unused code 2018-10-26 19:05:25 +02:00
README.md Add a note about encrypted cert key 2018-10-27 09:07:45 +02:00
swiftgen.yml Initial commit 2018-10-11 09:13:19 +02:00

README.md

Passepartout

iOS 11+ TunnelKit 1.1.x License GPLv3 Join TestFlight Join Reddit Join Telegram Tweet

Passepartout is a non-official, user-friendly OpenVPN® client for iOS.

Beta

Passepartout is in public beta on TestFlight.

By using a beta version of the app, you understand that the software might be unstable, unreliable or plain broken from time to time.

Overview

All profiles in one place

Passepartout lets you handle multiple profiles in one single place and quickly switch between them.

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.

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.

See your connection parameters

Passepartout strives for transparency, by showing a fairly detailed yet understandable resume of your connection parameters.

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 only and only if you manually refresh them.

Presets for major providers

Passepartout can connect to a few well-known VPN providers with an existing account:

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:

  • UDP fragmentation, i.e. --fragment
  • Compression
    • --comp-lzo other than no
    • --compress other than empty
  • Proxy
  • External file references (inline <block> only)
  • Encrypted certificate private key (will raise error TunnelKitNative Code=205)

Ignored:

  • MTU overrides
    • --*-mtu and variants
    • --mssfix
  • Multiple --remote with different host values (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

It's highly recommended to use the Git and Ruby packages provided by Homebrew.

Testing

Download the app codebase locally:

$ git clone https://github.com/keeshux/passepartout-ios.git

Assuming you have a working CocoaPods environment, 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.

Contributing

By contributing to this project you are agreeing to the terms stated in the Contributor License Agreement (CLA). For more details please see CONTRIBUTING.

Credits

The logo is taken from the awesome Circle Icons set by Nick Roach.

  • SwiftyBeaver - © 2015 Sebastian Kreutzberger
  • MBProgressHUD - © 2009-2016 Matej Bukovinski

© 2002-2018 OpenVPN Inc. - OpenVPN is a registered trademark of OpenVPN Inc.

Disclaimer

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.

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

Website: passepartoutvpn.app