Conduit

Conduit runs inproxy from psiphon-tunnel-core. This repository targets a mobile app on Android, iOS, and Mac (via Catalyst), as well as a cross-platform CLI.

CLI and Mac releases are available on this repository's releases page. The Android mobile app is available on the Google Play store: https://play.google.com/store/apps/details?id=ca.psiphon.conduit. The iOS app is not currently released due to technical limitations.

For more information about Conduit, visit the web site.

React Native App

The React Native app is implemented in src/. Android and iOS projects are generated from app.json and the config plugins with npm run native:generate; they are not committed. This project uses Expo, so follow the Expo development-environment instructions for native setup.

To run the app in a development environment, you need a psiphon config file. This can be obtained from Psiphon at conduit-oss@psiphon.ca.

Run the android client with:

npm install
npm run android

This starts a metro development server automatically.

CLI App

See the cli folder for more details about the Conduit CLI.

Contributing

See CONTRIBUTING.md for information about contributing to Conduit.

Git LFS Usage

This project uses Git LFS to manage large files such as the tunnel core libraries.

Translations

For information about pulling and verifying translations, see i18n/README.md.