VPN client for Apple platforms.
Go to file
Davide De Rosa 28940f75ec Set beta release 2020-02-28 18:45:17 +01:00
.github Add sponsors 2019-08-24 23:02:16 +02:00
Libraries Symlink to submodules 2019-05-27 00:14:14 +02:00
Passepartout-iOS Allow any character in host profile name 2020-02-28 18:33:03 +01:00
Passepartout-iOS-Tunnel Bump version 2020-02-27 16:29:28 +01:00
Passepartout.xcodeproj Upgrade Xcode project 2020-02-28 17:28:18 +01:00
Passepartout.xcworkspace Initial commit 2018-10-11 09:13:19 +02:00
PassepartoutCore-iOS Bump version 2020-02-27 16:29:28 +01:00
Submodules Allow any character in host profile name 2020-02-28 18:33:03 +01:00
fastlane Set beta release 2020-02-28 18:45:17 +01:00
res Update README snapshots 2019-11-04 12:14:03 +01:00
scripts Move copy release notes script out 2019-12-12 20:55:48 +01:00
.env Move scripts to Core 2019-12-12 20:50:57 +01:00
.env.beta-archive Initial commit 2018-10-11 09:13:19 +02:00
.env.beta-deploy Refactor fastlane scripts 2019-09-30 14:21:07 +02:00
.env.dev-archive Initial commit 2018-10-11 09:13:19 +02:00
.env.dev-deploy Refactor fastlane scripts 2019-09-30 14:21:07 +02:00
.env.template.secret-codesign Add secret env templates 2019-03-29 13:22:25 +01:00
.env.template.secret-deploy Refactor fastlane scripts 2019-09-30 14:21:07 +02:00
.gitignore Move scripts to Core 2019-12-12 20:50:57 +01:00
.gitmodules Fix internal submodule URL 2019-12-08 15:05:08 +01:00
CHANGELOG.md Set beta release 2020-02-28 18:45:17 +01: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 Use TunnelKit 2.0.3 2019-09-07 00:14:01 +02:00
Gemfile.lock Update bundle 2020-02-24 20:16:43 +01:00
LICENSE Initial commit 2018-10-11 09:13:19 +02:00
Podfile Update TunnelKit 2020-01-11 09:33:51 +01:00
Podfile.include Upgrade to TunnelKit 2.0 2019-05-25 18:29:10 +02:00
Podfile.lock Update pods 2020-02-24 20:50:03 +01:00
README.md Prepare release 2019-12-11 17:04:02 +01:00
ci Reuse fastlane templates from submodule 2019-10-11 18:44:53 +02:00
swiftgen.yml Add stubs for purchase screen 2019-10-31 09:36:08 +01:00

README.md

Passepartout

iOS 11+ TunnelKit 2.2 License GPLv3 Join Reddit Join Telegram Tweet

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

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.

Siri shortcuts

Enjoy the convenience of Siri shortcuts to automate frequent VPN actions.

Override network settings

Override default gateway, DNS and proxy settings right from the app. Don't bother editing the .ovpn file or your pushed server settings. This is especially useful if you want to override your provider settings, e.g. to integrate your own DNS-based ad blocking.

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 if 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.

You can find details on what may or may not work in the related section of the TunnelKit README.

Installation

Requirements

  • iOS 11.0+
  • Xcode 11+ (Swift 5)
  • Git (preinstalled with Xcode Command Line Tools)
  • Ruby (preinstalled with macOS)
  • CocoaPods 1.8.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/passepartoutvpn/passepartout-ios.git

Enter the directory and clone the submodules:

$ git submodule init
$ git submodule update

Assuming you have a working CocoaPods environment, setting up the app workspace only requires installing the pod dependencies:

$ pod install

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.

Make sure to update Passepartout-iOS/Config.xcconfig according to your developer account and your identifiers:

CFG_TEAM_ID = A1B2C3D4E5
CFG_APP_ID = com.example.ios.MyApp
CFG_GROUP_ID = com.example.MyAppGroup // omit the "group." prefix
CFG_APPSTORE_ID = 1234567890 // optional for development, can be bogus

After that, open Passepartout.xcworkspace in Xcode and run the Passepartout-iOS 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.

The country flags are taken from: https://github.com/lipis/flag-icon-css/

  • Kvitto - © 2015 Oliver Drobnik
  • lzo - © 1996-2017 Markus F.X.J. Oberhumer
  • MBProgressHUD - © 2009-2016 Matej Bukovinski
  • PIATunnel - © 2018-Present Private Internet Access
  • SSZipArchive - © 2010-2012 Sam Soffes
  • SwiftGen - © 2018 SwiftGen
  • SwiftyBeaver - © 2015 Sebastian Kreutzberger

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (https://www.openssl.org/)

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

Translations

  • Chinese (Simplified): OnlyThen - @OnlyThen
  • Dutch: Norbert de Vreede - @paxpacis
  • English: Davide De Rosa (author)
  • French: Julien Laniel - @linkjul
  • German: Christian Lederer, Theodor Tietze
  • Greek: Konstantinos Koukoulakis
  • Italian: Davide De Rosa (author)
  • Polish: Piotr Książek
  • Portuguese: Helder Santana - @heldr
  • Russian: Alexander Korobynikov
  • Spanish: Davide De Rosa (author), Elena Vivó
  • Swedish: Henry Gross-Hellsen - @cowpod

Usage

You are strongly encouraged to read carefully both the disclaimer and privacy policy before using this software.

Contacts

Twitter: @keeshux

Website: passepartoutvpn.app