diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1896e471..a7654262 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -4,5 +4,5 @@ - GOOD: "Add new feature" - BAD: "Added new feature" - Rebase your branch to `master` and possibly squash unrelevant commits. -- Make sure to pass the unit tests, as long as CI doesn't automate them yet. +- Make sure to pass the unit tests locally, even though CI runs them automatically. - Submit the PR. diff --git a/Library/Sources/UILibrary/Resources/Credits.json b/Library/Sources/UILibrary/Resources/Credits.json index c6c68410..4a6d012a 100644 --- a/Library/Sources/UILibrary/Resources/Credits.json +++ b/Library/Sources/UILibrary/Resources/Credits.json @@ -1,6 +1,10 @@ { "licenses": [ { + "name": "fastlane", + "licenseName": "MIT", + "licenseURL": "https://raw.githubusercontent.com/fastlane/fastlane/master/LICENSE" + }, { "name": "GenericJSON", "licenseName": "MIT", "licenseURL": "https://raw.githubusercontent.com/iwill/generic-json-swift/master/LICENSE" @@ -20,6 +24,10 @@ "name": "SwiftGen", "licenseName": "MIT", "licenseURL": "https://raw.githubusercontent.com/SwiftGen/SwiftGen/master/LICENCE" + }, { + "name": "SwiftLint", + "licenseName": "MIT", + "licenseURL": "https://raw.githubusercontent.com/realm/SwiftLint/master/LICENSE" } ], "notices": [ diff --git a/Library/Sources/UILibrary/Theme/Theme.swift b/Library/Sources/UILibrary/Theme/Theme.swift index 74cf05fe..5202489a 100644 --- a/Library/Sources/UILibrary/Theme/Theme.swift +++ b/Library/Sources/UILibrary/Theme/Theme.swift @@ -54,9 +54,17 @@ public final class Theme: ObservableObject { public internal(set) var emptyMessageColor: Color = .secondary - public internal(set) var primaryColor = Color(red: 0.318, green: 0.365, blue: 0.443) + public internal(set) var primaryColor = Color( + red: Double(0x51) / 255.0, + green: Double(0x5D) / 255.0, + blue: Double(0x70) / 255.0 + ) - public internal(set) var activeColor = Color(red: .zero, green: Double(0xAA) / 255.0, blue: .zero) + public internal(set) var activeColor = Color( + red: .zero, + green: Double(0xAA) / 255.0, + blue: .zero + ) public internal(set) var inactiveColor: Color = .gray diff --git a/README.md b/README.md index a434585b..692593c8 100644 --- a/README.md +++ b/README.md @@ -1,130 +1,61 @@ -

- -![iOS 16+](https://img.shields.io/badge/iOS-16+-green.svg) -![macOS 13+](https://img.shields.io/badge/macOS-13+-green.svg) -![tvOS 17+](https://img.shields.io/badge/tvOS-17+-green.svg) -[![License GPLv3](https://img.shields.io/badge/License-GPLv3-lightgray.svg)](LICENSE) - -[![Unit Tests](https://github.com/passepartoutvpn/passepartout/actions/workflows/test.yml/badge.svg?branch=)](https://github.com/passepartoutvpn/passepartout/actions/workflows/test.yml) -[![Release](https://github.com/passepartoutvpn/passepartout/actions/workflows/release.yml/badge.svg?branch=)](https://github.com/passepartoutvpn/passepartout/actions/workflows/release.yml) +![Passepartout logo](Passepartout/App/Assets.xcassets/Logo.imageset/Logo@2x.png) # [Passepartout][about-website] -Passepartout is your go-to app for VPN and privacy. [OpenVPN®][openvpn] and [WireGuard®][wireguard] client for Apple platforms, the OpenVPN stack also implements the [Tunnelblick XOR patch][openvpn-xor-patch]. - +[![Unit Tests](https://github.com/passepartoutvpn/passepartout/actions/workflows/test.yml/badge.svg?branch=)](https://github.com/passepartoutvpn/passepartout/actions/workflows/test.yml) +[![Release](https://github.com/passepartoutvpn/passepartout/actions/workflows/release.yml/badge.svg?branch=)](https://github.com/passepartoutvpn/passepartout/actions/workflows/release.yml) [![Join Reddit](https://img.shields.io/badge/discuss-Reddit-orange.svg)][about-reddit] [![Join TestFlight](https://img.shields.io/badge/beta-Testflight-blue.svg)][about-testflight] -## Overview +Passepartout is your go-to app for VPN and privacy. -### All profiles in one place +Passepartout runs on [iPhone, iPad, Mac, and Apple TV][web-appstore]. -Passepartout lets you handle multiple profiles in one single place and quickly switch between them. +## Features -[](res/ios/snap-home.png) +[OpenVPN®][openvpn] and [WireGuard®][wireguard] client for Apple platforms, the OpenVPN stack also implements the [Tunnelblick XOR patch][openvpn-xor-patch]. -### Ease of use +Other features: -With its native look & feel, Passepartout focuses on ease of use. It does so by stripping the flags that are today obsolete or rarely used. With good approximation, it mimics the most relevant features you will find in the official OpenVPN and WireGuard clients. +- On-demand rules +- Override DNS and HTTP proxy +- Custom routing +- Presets for multiple providers (virtually any) -Not to mention iCloud support, which makes your VPN profiles available on all your devices without any additional effort! +Tailored for Apple platforms: -### On demand - -Define rules for Wi-Fi, cellular (iOS) or wired (macOS) networks to fine-grain how you automate your VPN connectivity. - -[](res/ios/snap-on-demand.png) - -### Siri shortcuts - -Enjoy the convenience of Siri shortcuts to automate frequent VPN actions. - -[](res/ios/snap-shortcuts.png) - -### Override network settings - -Override default gateway, DNS (plus DoH/DoT), proxy and MTU settings right from the app. Don't bother editing the configuration file or your server settings. This is especially useful if you want to override your provider settings, e.g. to integrate your own DNS-based ad blocking. - -[](res/ios/snap-network.png) - -### See your connection parameters - -Passepartout strives for transparency, by showing a fairly detailed yet understandable resume of your connection parameters. - -[](res/ios/snap-parameters.png) - -### 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] 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: - -- [Hide.me][app-net-hideme] -- [Mullvad][app-net-mullvad] -- [NordVPN][app-net-nordvpn] -- [Oeck][app-net-oeck] -- [Private Internet Access][app-net-pia] -- [ProtonVPN][app-net-protonvpn] -- [SurfShark][app-net-surfshark] -- [TorGuard][app-net-torguard] -- [TunnelBear][app-net-tunnelbear] -- [VyprVPN][app-net-vyprvpn] -- [Windscribe][app-net-windscribe] - -In preset mode, you can pick pre-resolved IPv4 endpoints when DNS is problematic. - -### Import configuration files - -Passepartout can import .ovpn (OpenVPN) and .conf/.wg (WireGuard) configuration files as is. You can find details on what may or may not work in the related section of the [TunnelKit README][dep-tunnelkit-ovpn]. +- Apple TV +- iCloud +- Shortcuts +- No background activities +- Wise on battery ## Installation +**WARNING: This will not work because PassepartoutKit is a private repository, as it's not ready for public use yet.** [Follow updates here](https://github.com/passepartoutvpn/passepartout/issues/793). + ### Requirements -- iOS 15+ / macOS 12+ / tvOS 17+ -- Xcode 13+ (SwiftPM 5.3) +- iOS 16+ / macOS 13+ / tvOS 17+ +- Xcode 15+ (SwiftPM 5.5) - Git (preinstalled with Xcode Command Line Tools) - Ruby (preinstalled with macOS) -- golang -It's highly recommended to use the Git and Ruby packages provided by [Homebrew][dep-brew]. +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-apple.git + $ git clone https://github.com/passepartoutvpn/passepartout.git -Enter the directory and clone the submodules: - - $ git submodule init - $ git submodule update - -For everything to work properly, make sure to comply with all the capabilities/entitlements, both in the main app and the tunnel extension target. - -Make sure to update `Config.xcconfig` according to your developer account and your identifiers: - - CFG_TEAM_ID = A1B2C3D4E5 - CFG_APP_ID = com.example.MyApp - CFG_APP_LAUNCHER_ID = com.example.MyApp.Launcher // macOS only - CFG_GROUP_ID = com.example.MyAppGroup // omit the "group." prefix - CFG_APPSTORE_ID = 1234567890 // optional for development, can be bogus - -Also, `PATH` must include your golang installation in order to compile WireGuardKit: - - PATH = $(PATH):/path/to/golang +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 eventually test the app, open `Passepartout.xcodeproj` in Xcode and run the `Passepartout` target. ## License -Copyright (c) 2023 Davide De Rosa. All rights reserved. +Copyright (c) 2024 Davide De Rosa. All rights reserved. This project is licensed under the [GPLv3][license-content]. @@ -134,23 +65,22 @@ By contributing to this project you are agreeing to the terms stated in the [Con ## Credits +- [fastlane][credits-fastlane] +- [GenericJSON][credits-genericjson] +- [Kvitto][credits-kvitto] +- [lzo][credits-lzo] +- [SwiftGen][credits-swiftgen] +- [SwiftLint][credits-swiftlint] + The logo is taken from the awesome Circle Icons set by Nick Roach. -The country flags are taken from: - -- Kvitto - Copyright (c) 2015 Oliver Drobnik -- lzo - Copyright (c) 1996-2017 Markus F.X.J. Oberhumer -- PIATunnel - Copyright (c) 2018-Present Private Internet Access -- SwiftGen - Copyright (c) 2018 SwiftGen -- SwiftyBeaver - Copyright (c) 2015 Sebastian Kreutzberger - ### OpenVPN -© Copyright 2023 OpenVPN | OpenVPN is a registered trademark of OpenVPN, Inc. +© Copyright 2024 OpenVPN | OpenVPN is a registered trademark of OpenVPN, Inc. ### WireGuard -© Copyright 2015-2023 Jason A. Donenfeld. All Rights Reserved. "WireGuard" and the "WireGuard" logo are registered trademarks of Jason A. Donenfeld. +© Copyright 2015-2024 Jason A. Donenfeld. All Rights Reserved. "WireGuard" and the "WireGuard" logo are registered trademarks of Jason A. Donenfeld. ### OpenSSL @@ -168,6 +98,8 @@ A _huge_ credit goes to: ## Translations +The app is mostly translated with [ChatGPT][credits-chatgpt], but these are the acknowledgments to the original translators: + - Chinese (Simplified): OnlyThen - [@OnlyThen](https://github.com/OnlyThen) - Dutch: Norbert de Vreede - [@paxpacis](https://github.com/paxpacis) - English: Davide De Rosa (author) @@ -184,7 +116,7 @@ A _huge_ credit goes to: ## Usage -You are strongly encouraged to read carefully both the [disclaimer][web-disclaimer] and [privacy policy][web-privacy] before using this software. +You are encouraged to read carefully both the [disclaimer][web-disclaimer] and [privacy policy][web-privacy] before using this software. ## Contacts @@ -192,32 +124,27 @@ Twitter: [@keeshux][about-twitter] Website: [passepartoutvpn.app][about-website] ([FAQ][about-faq]) +[web-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/ -[app-api]: https://github.com/passepartoutvpn/passepartout-api -[app-net-hideme]: https://member.hide.me/en/checkout?plan=new_default_prices&coupon=6CB-BDB-802&duration=24 -[app-net-mullvad]: https://mullvad.net/en/account/create/ -[app-net-nordvpn]: https://go.nordvpn.net/SH21Z -[app-net-oeck]: https://www.oeck.com -[app-net-pia]: https://www.privateinternetaccess.com/pages/buy-vpn/ -[app-net-protonvpn]: https://proton.go2cloud.org/SHZ -[app-net-surfshark]: https://surfshark.com -[app-net-torguard]: https://torguard.net/ -[app-net-tunnelbear]: https://www.tunnelbear.com/ -[app-net-vyprvpn]: https://www.vyprvpn.com/ -[app-net-windscribe]: https://secure.link/kCsD0prd - [dep-brew]: https://brew.sh/ -[dep-tunnelkit]: https://github.com/passepartoutvpn/tunnelkit -[dep-tunnelkit-ovpn]: https://github.com/passepartoutvpn/tunnelkit#support-for-ovpn-configuration [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-kvitto]: https://github.com/Cocoanetics/Kvitto +[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-disclaimer]: https://passepartoutvpn.app/disclaimer/ [web-privacy]: https://passepartoutvpn.app/privacy/ diff --git a/res/ios/snap-home.png b/res/ios/snap-home.png deleted file mode 100644 index 54fc5b5a..00000000 Binary files a/res/ios/snap-home.png and /dev/null differ diff --git a/res/ios/snap-network.png b/res/ios/snap-network.png deleted file mode 100644 index fca07dc9..00000000 Binary files a/res/ios/snap-network.png and /dev/null differ diff --git a/res/ios/snap-on-demand.png b/res/ios/snap-on-demand.png deleted file mode 100644 index b60eee75..00000000 Binary files a/res/ios/snap-on-demand.png and /dev/null differ diff --git a/res/ios/snap-parameters.png b/res/ios/snap-parameters.png deleted file mode 100644 index abda6969..00000000 Binary files a/res/ios/snap-parameters.png and /dev/null differ diff --git a/res/ios/snap-shortcuts.png b/res/ios/snap-shortcuts.png deleted file mode 100644 index fa074d58..00000000 Binary files a/res/ios/snap-shortcuts.png and /dev/null differ diff --git a/res/logo.svg b/res/logo.svg deleted file mode 100644 index 877330b4..00000000 --- a/res/logo.svg +++ /dev/null @@ -1 +0,0 @@ -