https://github.com/passepartoutvpn/passepartout
Your go-to app for VPN and privacy.
https://github.com/passepartoutvpn/passepartout
combine ios macos network-extension openvpn openvpn-client osx ovpn shortcuts siri-shortcuts swiftui swiftui-learning tvos vpn wireguard
Last synced: about 1 month ago
JSON representation
Your go-to app for VPN and privacy.
- Host: GitHub
- URL: https://github.com/passepartoutvpn/passepartout
- Owner: passepartoutvpn
- License: gpl-3.0
- Created: 2018-10-10T21:20:52.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-04-03T13:05:40.000Z (about 1 month ago)
- Last Synced: 2025-04-03T14:23:07.979Z (about 1 month ago)
- Topics: combine, ios, macos, network-extension, openvpn, openvpn-client, osx, ovpn, shortcuts, siri-shortcuts, swiftui, swiftui-learning, tvos, vpn, wireguard
- Language: Swift
- Homepage: https://passepartoutvpn.app
- Size: 109 MB
- Stars: 923
- Watchers: 16
- Forks: 132
- Open Issues: 104
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.txt
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- fucking-open-source-ios-apps - Passepartout - friendly OpenVPN app (Security / RSS)
README
# [Passepartout][web-home]
[](https://github.com/passepartoutvpn/passepartout/actions/workflows/test.yml)
[](https://github.com/passepartoutvpn/passepartout/actions/workflows/release.yml)
[][about-github-discussions]
[][about-reddit]
[][about-testflight]
Passepartout is your go-to app for VPN and privacy.
Passepartout runs on [iPhone, iPad, Mac, and Apple TV][appstore].
## Features
[OpenVPN®][openvpn] and [WireGuard®][wireguard] client for Apple platforms, the OpenVPN stack also implements the [Tunnelblick XOR patch][openvpn-xor-patch].
Other features:
- On-demand rules
- Override DNS and HTTP proxy
- Custom routing
- Presets for multiple providers (virtually any)
Tailored for Apple platforms:
- Apple TV
- iCloud
- Shortcuts
- No background activities
- Wise on battery
## Installation
### Requirements
- iOS 16+ / macOS 13+ / tvOS 17+
- Xcode 16+
- SwiftPM 6.0
- Git (preinstalled with Xcode Command Line Tools)
- Ruby (preinstalled with macOS)
It's highly recommended that you use the Git and Ruby packages provided by [Homebrew][dep-brew].
### Testing
Download the app codebase locally:
```
$ git clone https://github.com/passepartoutvpn/passepartout
```
For everything to work properly, you must comply with all the capabilities and entitlements in the main app and the tunnel extension target. Therefore, you must update the `Config.xcconfig` file according to your developer account.
To test the app on your Mac or iOS/tvOS Simulator:
- Open `Passepartout.xcodeproj` in Xcode
- Edit `Packages/Partout-Framework/Package.swift`
- Set `environment = .onlineDevelopment`
- Run the `Passepartout` target
## License
Copyright (c) 2025 Davide De Rosa. All rights reserved.
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].
## Blog
[Follow the blog][web-blog] for insights, real-world challenges, and lessons learned from building and maintaining Passepartout.
## Credits
- [fastlane][credits-fastlane]
- [GenericJSON][credits-genericjson]
- [lzo][credits-lzo]
- [SwiftGen][credits-swiftgen]
- [SwiftLint][credits-swiftlint]
The logo is taken from the awesome Circle Icons set by Nick Roach.
### OpenVPN
© Copyright 2025 OpenVPN | OpenVPN is a registered trademark of OpenVPN, Inc.
### WireGuard
© Copyright 2015-2025 Jason A. Donenfeld. All Rights Reserved. "WireGuard" and the "WireGuard" logo are registered trademarks of Jason A. Donenfeld.
### OpenSSL
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. ([https://www.openssl.org/][dep-openssl])
### Community
A _huge_ credit goes to:
- My tiny group of 3 private beta testers
- The 9000+ public testers using the beta on a daily basis
- The continued support and feedback from the [Passepartout community on Reddit][about-reddit]
- The overall patience of users affected by my bugs that actively collaborate in resolving them
- All those who contributed to the amazingly high rating on the App Store
## Translations
The app is mostly translated with [ChatGPT][credits-chatgpt], but these are the acknowledgments to the original translators:
- Chinese (Simplified): [OnlyThen](https://github.com/OnlyThen)
- Dutch: [Norbert de Vreede](https://github.com/paxpacis)
- English: [Davide De Rosa](https://github.com/keeshux) (author)
- French: [Julien Laniel](https://github.com/linkjul)
- German: Christian Lederer, Philipp Reynders, Theodor Tietze
- Greek: Konstantinos Koukoulakis
- Italian: [Davide De Rosa](https://github.com/keeshux) (author)
- Polish: Piotr Książek
- Portuguese: [Helder Santana](https://github.com/heldr)
- Russian: Alexander Korobynikov
- Spanish: [Davide De Rosa](https://github.com/keeshux) (author), Elena Vivó
- Swedish: [Henry Gross-Hellsen](https://github.com/cowpod)
- Ukranian: [Dmitry Chirkin](https://github.com/josser)
## Usage
You are encouraged to read carefully both the [disclaimer][web-disclaimer] and the [privacy policy][web-privacy] before using this software.
## Contacts
Twitter: [@keeshux][about-twitter]
Website: [passepartoutvpn.app][web-home] ([FAQ][web-faq])
[appstore]: https://apps.apple.com/us/app/passepartout-vpn-client/id1433648537?mt=8
[openvpn]: https://openvpn.net/index.php/open-source/overview.html
[openvpn-xor-patch]: https://tunnelblick.net/cOpenvpn_xorpatch.html
[wireguard]: https://www.wireguard.com/
[dep-brew]: https://brew.sh/
[dep-openssl]: https://www.openssl.org/
[license-content]: LICENSE
[contrib-cla]: CLA.rst
[contrib-readme]: CONTRIBUTING.md
[credits-fastlane]: https://github.com/fastlane/fastlane
[credits-genericjson]: https://github.com/iwill/generic-json-swift
[credits-lzo]: https://www.oberhumer.com/opensource/lzo/
[credits-swiftgen]: https://github.com/SwiftGen/SwiftGen
[credits-swiftlint]: https://github.com/realm/SwiftLint
[credits-chatgpt]: https://chatgpt.com/
[web-home]: https://passepartoutvpn.app
[web-blog]: https://passepartoutvpn.app/blog/
[web-faq]: https://passepartoutvpn.app/faq/
[web-disclaimer]: https://passepartoutvpn.app/disclaimer/
[web-privacy]: https://passepartoutvpn.app/privacy/
[about-twitter]: https://twitter.com/keeshux
[about-github-discussions]: https://github.com/orgs/passepartoutvpn/discussions
[about-reddit]: https://www.reddit.com/r/passepartout
[about-testflight]: https://testflight.apple.com/join/K71mtLjZ