VPN client for Apple platforms.

combine ios macos network-extension openvpn openvpn-client osx ovpn shortcuts siri-shortcuts swiftui swiftui-learning tvos vpn wireguard

Go to file

Davide De Rosa c6fbdca342 Move network settings to ad-hoc screen Can now set gateway/DNS/proxy settings explicitly. - Read from .ovpn (hosts only) - Pull from server (PUSH_REPLY) - Set manually		2019-05-01 23:00:28 +02:00
Passepartout	Move network settings to ad-hoc screen	2019-05-01 23:00:28 +02:00
Passepartout-Core	Bump version	2019-05-01 22:59:05 +02:00
Passepartout-CoreTests	Bump version	2019-05-01 22:59:05 +02:00
Passepartout-iOS	Move network settings to ad-hoc screen	2019-05-01 23:00:28 +02:00
Passepartout-iOS-Tunnel	Bump version	2019-05-01 22:59:05 +02:00
Passepartout.xcodeproj	Move network settings to ad-hoc screen	2019-05-01 23:00:28 +02:00
Passepartout.xcworkspace	Initial commit	2018-10-11 09:13:19 +02:00
ci	Upgrade API to v2 (JSON)	2019-04-25 23:13:26 +02:00
fastlane	Drop ru App Store metadata stubs	2019-04-28 17:39:43 +02:00
res	Set release date	2019-05-01 22:56:35 +02:00
.env	Set RC release	2018-11-01 15:26:28 +01: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	Submit dev builds to App Center	2019-03-21 22:20:53 +01:00
.env.template.secret-codesign	Add secret env templates	2019-03-29 13:22:25 +01:00
.env.template.secret-deploy	Add secret env templates	2019-03-29 13:22:25 +01:00
.gitignore	Add local symlinks to metadata	2019-04-15 21:14:32 +02:00
CHANGELOG.md	Set release date	2019-05-01 22:56:35 +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	Add App Center plugin for fastlane	2019-03-21 22:20:53 +01:00
LICENSE	Initial commit	2018-10-11 09:13:19 +02:00
Podfile	Use builders for editing configurations	2019-05-01 23:00:28 +02:00
Podfile.lock	Use builders for editing configurations	2019-05-01 23:00:28 +02:00
README.md	Set release date	2019-05-01 22:56:35 +02:00
swiftgen.yml	Externalize About storyboard	2019-04-07 08:52:16 +02:00

README.md

Passepartout

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

Beta

Passepartout betas are available for patrons on TestFlight.

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 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 10+ (Swift 5)
Git (preinstalled with Xcode Command Line Tools)
Ruby (preinstalled with macOS)
CocoaPods 1.6.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

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.

Make sure to also update the following constants in Passepartout/Sources/GroupConstants.swift according to your developer account and your target bundle identifiers:

public static let teamId
public static let appId
public static let appGroup
public static let tunnelIdentifier

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/

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

Translations

German: Christian Lederer
Italian: Davide De Rosa (author) - @keeshux
Portuguese: Helder Santana - @heldr
Russian: Alexander Korobynikov

Usage

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

Contacts

Twitter: @keeshux

Website: passepartoutvpn.app