File: README.md

package info (click to toggle)
offlineimap3 0.0~git20210225.1e7ef9e%2Bdfsg-4
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 1,328 kB
  • sloc: python: 7,974; sh: 548; makefile: 81
file content (37 lines) | stat: -rw-r--r-- 1,298 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# gpg-offlineimap

Python bindings for offlineimap to use gpg instead of storing cleartext passwords

Author: Lorenzo G.
[GitHub](https://github.com/lorenzog/gpg-offlineimap)

## Quickstart

Requirements: a working GPG set-up. Ideally with gpg-agent. Should work
out of the box on most modern Linux desktop environments.

 1. Enable IMAP in gmail (if you have two factor authentication, you
    need to create an app-specific password)

 2. Create a directory `~/Mail`

 3. In `~/Mail`, create a password file `passwords-gmail.txt`. Format:
    `account@gmail.com password`. Look at the example file in this
    directory.

 4. **ENCRYPT** the file: `gpg -e passwords-gmail.txt`. It should create
    a file `passwords-gmail.txt.gpg`. Check you can decrypt it: `gpg -d
    passwords-gmail.txt.gpg`: it will ask you for your GPG password and
    show it to you.

 5. Use the file  `offlineimaprc.sample` as a sample for your own
    `.offlineimaprc`; edit it by following the comments. Minimal items
    to configure: the `remoteuser` field and the `pythonfile` parameter
    pointing at the `offlineimap.py` file in this directory.

 6. Run it: `offlineimap`. It should ask you for your GPG passphrase to
    decrypt the password file.

 7. If all works well, delete the cleartext password file.