search

ndrong / zivver-thunderbird

Zivver for Thunderbird automatically decrypts Zivver messages in your inbox using the Zivver API.
https://addons.thunderbird.net/thunderbird/addon/zivver-thunderbird/
MIT License
3 stars 0 forks source link
thunderbird zivver

readme

Zivver for Thunderbird

Introduction

This extension automatically detects Zivver messages and decrypts them on-the-fly using the Zivver API. Messages are decrypted only when actively displayed by the user and are never stored locally.

Installation

  1. Download the latest version of the extension from the Releases page.
    Alternatively, you can download the extension from the built-in add-on catalog (which has the additional benefit of automatic updates).
  2. Install the extension in Thunderbird (Tools > Add-ons and Themes > ⚙️ Settings > Install Add-on From File... > Select the downloaded .zip file and press 'Add' when prompted).
  3. Click on the extension (under 'Manage Your Extensions') and go to the Preferences tab to add the required credentials.
  4. In the 'Refresh token' field, enter your refresh token. This token can be found by logging into https://app.zivver.com while opening the Developer Tools (Ctrl + Shift + I) and looking for a request to https://app.zivver.com/api/authentication/login (see the screenshots below for an example request). The form data in this request should include a parameter called "request_token", containing a value starting with "Z1.1.2.". Copy the value (making sure to remove the quotes at the beginning and end) and paste it into the 'Refresh token' field.
  5. In the 'Email address' field, simply enter the email address used to authenticate at https://app.ziver.com. Make sure to press 'Save' before exiting the Preferences tab.
  6. To check whether the extension is configured properly, open a Zivver notification message in your Thunderbird inbox. If everything is working correctly, the message should be decrypted and shown in the message pane.

Example request view 1 Example request view 2
Screenshots showing where to find the refresh token using the Developer Tools on Firefox.

Building from source

  1. Clone the repo: clone git@github.com:NDrong/zivver-thunderbird.git
  2. Change your current working directory to the cloned repo: cd zivver-thunderbird
  3. Install dependencies: npm install
  4. Build the extension: npm run build
  5. The compiled extension can be found under web-ext-artifacts/

Contributing

Contributions are welcome! Please feel free to open a pull request or issue if you have any suggestions or improvements.
Since this is my very first Thunderbird extension, I'm aware that code quality may not be optimal (feel free to improve on that as well).

Some ideas for future improvements:

License

This project is distributed under the MIT License.

Notice

This project is not affiliated with or endorsed by Zivver B.V.