yesBad/proton-bridge
1
0
Fork 0
forked from Silverfish/proton-bridge
Code Actions Activity

Update README.md

Browse Source
This commit is contained in:
Delong Lu
2020-04-15 17:14:18 +00:00
committed by Jakub Cuth
parent 3b1528cc2a
commit 409abba995
2 changed files with 23 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
BUILDS.md
View File

@ -2,14 +2,14 @@
## Prerequisites ## Prerequisites
* Go 1.13 * Go 1.13
* Bash with basic build utils: make, gcc, sed, find, grep, … * Bash with basic build utils: make, gcc, sed, find, grep, ...
* For Windows it is recommended to use MinGW 64bit shell from [MSYS2](https://www.msys2.org/) * For Windows it is recommended to use MinGW 64bit shell from [MSYS2](https://www.msys2.org/)
* GCC (linux, windows) or Xcode (macOS) * GCC (linux, windows) or Xcode (macOS)
* Windres (windows) * Windres (windows)
To enable the sending of crash reports using Sentry please set the To enable the sending of crash reports using Sentry please set the
`main.DSNSentry` value with client key of your sentry project before build. `main.DSNSentry` value with the client key of your sentry project before build.
Otherwise sending of crash reports will be disabled. Otherwise, the sending of crash reports will be disabled.
## Build ## Build
* for Windows please unset the `MSYSTEM` variable * for Windows please unset the `MSYSTEM` variable
@ -25,14 +25,15 @@ make build
``` ```
* The result will be stored in `./cmd/Destop-Bridge/deploy/${GOOS}/` * The result will be stored in `./cmd/Destop-Bridge/deploy/${GOOS}/`
* for `linux` binary will the name of project directory e.g `bridge` * for `linux`, the binary will have the name of the project directory (e.g `bridge`)
* for `windows` the binary has extension `.exe` e.g `bridge.exe` * for `windows`, the binary will have the file extension `.exe` (e.g `bridge.exe`)
* for `darwin` the application will be created with name of project directory e.g `bridge.app` * for `darwin`, the application will be created with name of the project directory (e.g `bridge.app`)
## Usefull tests, lints and checks ## Useful tests, lints and checks
In order to be able to run following commands please install development dependencies: `make install-dev-dependencies` In order to be able to run following commands please install the development dependencies:
`make install-dev-dependencies`
* `make test` will run unit test for whole project * `make test` will run all unit tests
* `make lint` will run liter for whole project * `make lint` will lint the whole project
* `make -C ./tests test` will run integration tests for Bridge application * `make -C ./tests test` will run the integration tests
* `make run` will compile without GUI and start Bridge application in CLI mode * `make run` will build Bridge without a GUI and start it in CLI mode

20
README.md
View File

@ -7,25 +7,25 @@ For licensing information see [COPYING](./COPYING.md).
For contribution policy see [CONTRIBUTING](./CONTRIBUTING.md). For contribution policy see [CONTRIBUTING](./CONTRIBUTING.md).
## Description ## Description
ProtonMail Desktop Bridge for e-mail clients. ProtonMail Bridge for e-mail clients.
When launched, the servers will be started and a GUI will show up. From this GUI, When launched, Bridge will initialize local IMAP/SMTP servers and render
the server can be started and stopped and configuration for e-mail clients can its GUI.
be generated.
To configure an e-mail client, enter your ProtonMail credentials. Open your To configure an e-mail client, firstly log in using your ProtonMail credentials.
e-mail client and add a new account with the settings which are displayed. Open your e-mail client and add a new account using the settings which are
The client will be able to sync with your ProtonMail account only when the located in the Bridge GUI. The client will only be able to sync with
bridge is started, so enabling it on startup is recommended. your ProtonMail account when the Bridge is running, thus the option
to start Bridge on startup is enabled by default.
When the main window is closed, the bridge will continue to run in the When the main window is closed, Bridge will continue to run in the
background. background.
More details [on the public website](https://protonmail.com/bridge). More details [on the public website](https://protonmail.com/bridge).
## Keychain ## Keychain
You need to have keychain in order to run the ProtonMail Bridge. On Mac or You need to have a keychain in order to run the ProtonMail Bridge. On Mac or
Windows, Bridge uses native credential managers. On Linux, use Windows, Bridge uses native credential managers. On Linux, use
[Gnome keyring](https://wiki.gnome.org/Projects/GnomeKeyring/) [Gnome keyring](https://wiki.gnome.org/Projects/GnomeKeyring/)
or or