Frequently Asked Questions

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.

Under the Hood

How do I backup Geary mail?

Geary's configuration is stored in ~/.config/geary (that is, /home/<username>/.config/geary), backing up that or (even better) your entire ~/.config directory will make a copy of Geary's account information that can be restored later by moving it back into place.

The mail Geary pulls from your server(s) is stored in ~/.local/share/geary. Since mail is retrieved from your mail server it is safe to not back up this directory, however if it is deleted then your mail will need to be re-downloaded again.

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 message CSS

You can customize the display of messages in Geary's conversations via CSS. Place your custom CSS in a file at ~/.config/geary/user-message.css. If this file exists when Geary starts, it will be loaded and added to message web views as a user stylesheet when displaying messages.

Note that if you have the preference Always watch for new mail enabled, Geary may already be running when you log in, hence use geary --quit first to see any changes to your CSS.

This is supported as of version 0.12.

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.


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-10-24 01:28:19 by MichaelGratton)