Send and receive email.

Connecting to GMail

Google now requires email clients implement its proprietary protocol to sign in by default. As a result, you may need to update your Google settings to allow Geary to connect to your GMail account via IMAP. The setting to change depends on whether you have 2-Step authentication enabled for your Google account:

A future version of Geary will support Google's proprietary protocol, see Bug 746705 for more information.


Geary crashes when I run it. What I can do to help the developers?

If you can reproduce a crash, please check you are running the most recent version of Geary. If so, then get a stack trace and report the bug.


How do I turn on logging with Geary?

To enable logging, run Geary with the --debug (or -d) command line parameter:

geary --debug

This enables some basic debug output that can be used to track down what Geary is doing.

While debugging mode is active, there are several logging options to log network activity, etc. These options can be listed by running:

geary --help

Note that the logs may contain personal information like email address and the contents of your messages. Some logging options (such as --log-serializer) dump all information indiscriminantly, including usernames and passwords, so beware when using.


How do I backup Geary mail?

All the mail Geary pulls from your server(s) is stored in ~/.local/share/geary (that is, /home/<username>/.local/share/geary). You should copy or archive that entire directory structure to your backup location.

Why can’t I examine the Geary MessageSearchTable with an SQLite explorer tool (or the sqlite3 command-line app)?

Geary uses SQLite’s full-text search (FTS) feature as well as a Unicode tokenizer and stemmer to improve search performance and results. In order to examine the FTS virtual table, the stemmer/tokenizer must be loaded. Geary is linked with this tokenizer. In order to use the tokenizer/stemmer with another tool or the sqlite3 console program, you must install the tokenizer and load it into memory.

To install:

$ cd src/sqlite3-unicodesn
$ make
$ sudo make install

To use:

  • With the SQLite command-line application:

$ sqlite3 -cmd '.load unicodesn.sqlext' geary.db
  • Check other application's documentation for instructions on loading SQLite extensions at runtime.


Conversation Viewer

The conversation viewer uses WebKit to display an HTML page. To inspect the HTML interactively with WebKit, run Geary with --inspector. Right-click on the conversation viewer to open the WebKit Inspector window.

Customize conversation CSS

You can customize the display of Geary's conversations via CSS. You need to place a custom CSS file at ~/.config/geary/user-message.css. Consult the Geary master CSS file (installed in $(PREFIX)/share/geary/theming/message-viewer.css) when building your custom one to see the various classes and IDs used throughout the conversation. Also use the WebKit Inspector (above) to see how conversations are laid out.

Geary will monitor for changes to your custom CSS file and re-load it when it changes. You should be able to edit it and see the changes immediately in Geary, handy for testing and debugging your CSS.

Custom CSS was added in Geary 0.2.

Building on Ubuntu 12.04 (Precise Pangolin)

The current development version of Geary does not build on Ubuntu 12.04 (Precise Pangolin). Read this page to learn how to upgrade your installation so Geary will build.


How is "Geary" pronounced?

Geary is pronounced with a hard G. It should sound like the word “gear” followed by a long “e” sound.

For an audio example, visit this website

Apps/Geary/FAQ (last edited 2017-09-25 02:35:57 by MichaelGratton)