Jump to content

# GNOME/Evolution

2 languages

- Deutsch
- 日本語

From ArchWiki
< GNOME

Related articles

- GnuPG
- OpenPGP

Evolution is an application for managing email, calendars, contacts, tasks, notes, and RSS web feeds. It is the default mail client for GNOME and includes support for IMAP, Microsoft Exchange Server, Novell GroupWise, LDAP, WebDAV, CalDAV, and many other services and protocols.

## Installation

Install the evolution package. Non-GNOME users should also see #Using Evolution outside of GNOME.

Additional plugins:

- Bogofilter Plugin — Spam filtering for Evolution, using Bogofilter.

  https://bogofilter.sourceforge.io/ || evolution-bogofilter

- EteSync Plugin — End-to-end encrypted private information sync for Evolution using the EteSync open-source protocol.

  https://gitlab.gnome.org/GNOME/evolution-etesync || evolution-etesyncAUR

- EWS Plugin — MS Exchange integration through Exchange Web Services.

  https://wiki.gnome.org/Apps/Evolution || evolution-ews

- On Plugin — Support for controling Evolution from system tray.

  https://github.com/acidrain42/evolution-on || evolution-on

- SpamAssassin Plugin — Spam filtering for Evolution, using SpamAssassin.

  https://spamassassin.apache.org/ || evolution-spamassassin

## IMAP setup

See IMAP+ mail account settings in GNOME Help.

## Alternative IMAP setup

An alternative to letting Evolution connect directly to the IMAP server is to sync the IMAP server to your PC. This costs as much hard-disk space as you have mail, though it is possible to limit the folders synced in this manner (see #OfflineIMAP setup). An additional benefit (primary inspiration for this app) is that you have a full copy of your email, including attachments, on your PC for retrieval, even if on the move without an internet connection.

To set this up, you will need to install the offlineimap package. See https://www.offlineimap.org/ for more information.

### OfflineIMAP setup

OfflineIMAP takes its settings from the `~/.offlineimaprc` file, which you will need to create. Most users will be able to use the template file below for a standard IMAP server. See OfflineIMAP for more information.

    [general]
    accounts = MyAccount
    # Set this to the number of accounts you have.
    maxsyncaccounts = 1
    # You can set ui = TTY.TTYUI for interactive password entry if needed.
    # Setting it within this file (see below) is easier.
    ui = Noninteractive.Basic

    [Account MyAccount]
    # Each account should have a local and remote repository
    localrepository = MyLocal
    remoterepository = MyMailserver
    # Specifies how often to do a repeated sync (if running without crond)
    autorefresh = 10

    [Repository MyLocal]
    type = Maildir
    localfolders = /home/path/to/your/maildir
    # This needs to be specified so offlineimap does not complain during resync
    sep = .
    nametrans = lambda folder: re.sub('^.', '',
                               re.sub('^$', '.INBOX', folder))

    [Repository MyMailserver]
    # Example for a gmail account
    type = IMAP
    remotehost = your.imap.server.com
    remoteuser = yourname
    remotepass = yourpassword
    remoteport = 143
    # You need to configure some CA certificates
    sslcacertfile = /etc/ssl/certs/ca-certificates.crt
    # Translate your INBOX to be the root directory.
    # All other directories need a dot before the actual name.
    nametrans = lambda folder: re.sub('^.INBOX$', '',
                               re.sub('^', '.', folder))

You will likely need to add additional translations[dead link 2023-04-23—HTTP 404] if you are using Gmail.

For remote Mailserver repository:

    nametrans = lambda folder: re.sub('^.INBOX$', '',
                               re.sub('^', '.',
                               re.sub('\.', '_2E',
                               re.sub('^\[Gmail\].Drafts$', 'Drafts',
                               re.sub('^\[Gmail\].Sent Mail$', 'Sent', folder)))))

For Local repository:

    nametrans = lambda folder: re.sub('^Sent$',   '[Gmail].Sent Mail',
                               re.sub('^Drafts$', '[Gmail].Drafts',
                               re.sub('_2E', '.',
                               re.sub('^.', '',
                               re.sub('^$', '.INBOX', folder)))))

Other examples of nametrans configurations (including those for Courier IMAP servers) can be found at https://www.offlineimap.org/doc/nametrans.html.

Warning: Please note that lines of `~/.offlineimaprc` code indented by any amount of space will be interpreted as a continuation of the previous line. Take care to only indent lines if this behaviour is desired (like with the `re.sub` calls in the lambda expressions above).

You may also be interested in running offlineimap in the background.

### Evolution setup for offlineimap's maildir

See Maildir Format Mail Directories account settings[dead link 2024-12-15—HTTP 404] in GNOME Help. Set the Mail Directory path in Edit > Preferences > Mail Accounts > Edit > Receiving Email to the "root" folder if you are using a variant of the `~/.offlineimaprc` file from #OfflineIMAP setup. You can also choose to "check for new messages" more frequently in Receiving Options (like every minute instead of every 60 minutes) since this process will only check your local copy and not the server-side copy.

## Gmail setup

See Access a Gmail IMAP via Evolution[dead link 2024-12-15—HTTP 404] or Access a Gmail POP Account via Evolution[dead link 2024-12-15—HTTP 404] in GNOME Help. You may also be interested in reading Check Gmail through other email platforms (for IMAP) or Read Gmail messages on other email clients using POP in Gmail Help to manually fill in the following fields/checkboxes under Receiving Mail and/or Sending Mail in the Evolution Mail Configuration Assistant:

- Server Type
- Server and Port
  - Server requires authentication
- Username
- Encryption method

OAuth2 (Google) should be selected from the drop-down menu under Authentication in Receiving Email.

Tip:

- The assistant will automatically configure your settings for receiving/sending mail via Gmail if you check Look up mail server details based on the entered e-mail address in the Identity section. Note that the assistant will always default to IMAP for receiving mail.
- You can instead add a Google Account through Settings > Online Accounts if you are using GNOME.

## Gmail calendar

You can use your Gmail calendar in Evolution with one of two methods (barring GNOME Online Accounts[dead link 2024-12-15—HTTP 404] as mentioned in #Gmail setup).

### Using a WebDAV calendar

Follow the steps under "Get your calendar (view only)" in Google's Calendar Help to obtain the "secret address in iCal format" for your desired calendar. Then follow the steps under Using a WebDev calendar[dead link 2024-12-15—HTTP 404] in GNOME Help. Use the previously obtained secret address for the address in the URL field.

### Using a Google calendar

Follow the steps under Using a Google calendar[dead link 2024-12-15—HTTP 404] in GNOME Help. You may need to grant GNOME Evolution access to your Google Account if prompted.

## Google contacts

Similarly with #Gmail calendar, you can also sync your Google contacts in Evolution. See Using a Google addressbook[dead link 2024-12-15—HTTP 404] in GNOME Help for more information.

## Microsoft Exchange and Office 365

If your email is locally hosted on a Microsoft Exchange Server or cloud hosted on Office 365, you can use IMAP/POP and SMTP to access your email. However, some additional features such as access to Outlook Calendar and contact management are only available if you connect to the Microsoft Exchange Server or Office 365 server using Microsoft's proprietary Exchange ActiveSync (EAS) protocol.

There are two methods by which you can add/manage a Microsoft Exchange account in Evolution, but both will require Evolution EWS.

### Using GNOME Online Accounts

Install the gnome-online-accounts package if it is not already present. Then select Online Accounts in GNOME Settings and add a new Microsoft Exchange account with the following values:

E-mail | Your e-mail address (e.g. your.name@example.com)
Password | Your e-mail account password or an app password from https://aka.ms/mfasetup
Username | Your e-mail address once more
Server | outlook.office365.com

Your Exchange account should be listed alongside your other online accounts after clicking Connect. Choose what you want to synchronize (by default, all features are enabled).

The factual accuracy of this article or section is disputed.

Reason: Using 2FA with a personal Microsoft account, GOA, evolution-ews, and an app password (created by following [1]) seems to work fine with Evolution as of 2021-12-15. (Discuss in Talk:GNOME/Evolution)
Note:

- You still need to use outlook.office365.com for the Server field during account configuration if your e-mail address uses a custom domain.
- Enabling 2FA will prevent connections to the Exchange Server.

### Without using GNOME Online Accounts

See https://wiki.gnome.org/Apps/Evolution/EWS/OAuth2; in particular, the introduction and "Configure the account in Evolution" for users of free accounts. In other words, users of free accounts do not need to concern themselves with application/tenant IDs since they cannot use OAuth2.

Access to the GNOME Evolution (EWS) application may not not allowed by your organization. One possible workaround (instead of requesting access from an administrator) is to select Basic instead of OAuth2 (Office365) from the drop-down menu under Authentication in the Receiving Email section of the Evolution Mail Configuration Assistant. Users of free accounts can also select Basic—this is an alternative to "creating an application specific password."

## Using Evolution outside of GNOME

Evolution relies on GNOME Keyring for storing account passwords, so to use Evolution outside of GNOME, see GNOME/Keyring#Using the keyring and make sure a password keyring with the name login exists.

## Spell checking

See Spell checking[dead link 2024-12-15—HTTP 404] in GNOME Help. Evolution uses Enchant through gspell, so you can use checkers other than Hunspell to facilitate spell checking.

## Tips and tricks

### Changing cipher settings

It is possible to change the advertised ciphers used to secure the connection to the server. Evolution does not provide a switch to change the settings for the used ciphers. However, since Evolution uses GnuTLS, it is possible to change the settings using environment variables.

One way to change these settings is to copy the `/usr/share/applications/org.gnome.Evolution.desktop` file to `~/.local/share/applications/` and set the appropriate environment variable in the copied .desktop file. For example, make the following changes to avoid using ECC ciphers with NIST/NSA curves:

    ~/.local/share/applications/org.gnome.Evolution.desktop

    ...
    Exec=env G_TLS_GNUTLS_PRIORITY=${G_TLS_GNUTLS_PRIORITY:-NORMAL:-ECDHE-ECDSA:-ECDHE-RSA} evolution %U
    ...

A different way to achieve this would be with a wrapper script:

    #!/bin/sh

    export G_TLS_GNUTLS_PRIORITY=${G_TLS_GNUTLS_PRIORITY:-NORMAL:%COMPAT:\!VERS-SSL3.0}

    exec /usr/bin/evolution

The available cipher settings are documented in https://gnutls.org/manual/html_node/Priority-Strings.html.

### Use custom fonts

As default, Evolution offers only a few builtin fonts to be used for writing messages. However, you can set others fonts to be used as the "Default" option when writing HTML messages. That is done by creating a webkit editor plugin on `~/.local/share/evolution/webkit-editor-plugins/body-font.js`. Check below an example using Microsoft's Calibri font:

    'use strict';

    var localhostBodyFontPlugin = {
       name : "localhostBodyFontPlugin",
       setup : function(doc) {
          if (doc.body) {
              doc.body.setAttribute("style", "font-family: Calibri,sans-serif; font-size: 11.0pt;")
          }
       }
    };

    EvoEditor.RegisterPlugin(localhostBodyFontPlugin);

## See also

- GNOME Help page
- GNOME Wiki page

Categories:

- Email clients
- News aggregators
- GNOME
- OpenPGP

Hidden categories:

- Pages with dead links
- Pages or sections flagged with Template:Accuracy