Everdo User Manual


#1

This page is (going to be) a complete Everdo user manual. Some of the sections are under development.

Contents


Inline Commands
#2

Keyboard Shortcuts

Everdo relies heavily on keyboard shortcuts to achieve fast and low-friction user experience.

Item Creation

key action
i Create an Inbox item
n Create New item in the current view
p Create a Project
b Create a noteBook

Navigation and Quick Editing

key action
j select next item
down select next item
k select previous item
up select previous item
enter open item editor
alt + enter open corresponding project
f toggle focus selected item
space toggle complete selected item
d toggle due date for selected item
x move item to trash

Sidebar Navigation

key action
1 Inbox
2 Next
0 Trash

Areas

key action
Shift + 0 All Areas
Shift + 1 Area 1
Shift+0 Unassigned items

Misc Shortcuts

key action
h Open Help
t Open Tag manager
s or / Search all items (non-archived, non-deleted)

Save / Cancel Conventions

  • “Escape” cancels changes and closes dialogs instantly without asking questions
  • “Enter” or “Ctrl+Enter” saves and closes the current editor/dialog

#3

Inline Commands

Inline commands allow to modify item’s properties simply by editing it’s title:

Commands can be applied when:

  • creating a new item
  • editing an existing item

To apply an inline command, type it at the end of the item’s title and press Save or “Enter”.

You can combine multiple commands. For example, set focus, high energy and due date would be:

:f :e high :d

Once applied, the commands are removed from the title.

Available Commands

Here’s a full list of all commands supported in the current desktop version (1.1.1).

command example
move to next :n
move to someday/maybe :m
move to scheduled and set start date :s
set start date to tomorrow :s
set start date to n days in the future :s 5
:s 5d
set specific start date :s May 5
:s 5 May
:s 5 May 2018
focus item :f
remove focus :f none
set time in minutes :t 10m
:t 10
set time in hours :t 1h
remove time estimate :t none
set energy to High :e h
:e high
set energy to Medium :e m
:e med
set energy to Low :e l
:e low
remove energy estimate :e none
set due date for Today :d
set due date n days in the future/past :d +5
:d 5
:d -1
set specific due date :d May 5
:d 5 May
:d 5 May 2018

#4

#5

Search

To search items you can use the search textbox at the top of Everdo window:

search box

By default, search works across all items that are:

  • not archived
  • not in trash

The following item properties are matched against the search query:

  • title
  • note/description

Search Shortcuts

  • To quickly initiate search: press s or /, then type your query
  • To cancel search: press esc

Advanced Search Options

You can change the scope of search by specifying a search operator at the beginning of your query:

search operator example

scope of search search query
archived items in:archive

#6

Export

Everdo offers several ways get your data out of the app for analysis, reporting, backup or other reasons.

  • Copy as Text
  • CSV Export
  • JSON Export
  • Direct database access

Copy as Text

This feature is useful to quickly get the contexts of the current view/list in a human-readable plain text format:

Next
----
[ ] Try using "Export as CSV"
[ ] Try using "Export as JSON"

Done
----
[x](Apr 2)  Use "Copy as Text"

To make the export :

  1. Click “Copy as Text” button in the filter bar
  2. Paste into to a text editor

JSON Export

JSON export allows to get the complete data in a machine-friendly format well suited for further automated processing.

json-export-example

See this topic for more detail regarding the data schema.

CSV Export

This feature allows to export all Everdo data in a standard format readable by Excel and other spreadsheet programs.

csv-export-example

Direct Database Access

:warning: Always use a copy, not the actual Everdo db file. Never modify the database file directly. It’s very easy to change data in such a way that will lead to Everdo crashing.

All the Everdo data is stored in a single sqlite database file, located in the Everdo home directory:

  • on Linux: ~/.config/everdo/db
  • on OS X: ~/Library/Application Support/everdo/db
  • on Windows: %USERPROFILE%\AppData\Roaming\Everdo\db

You can copy the database file and use the copy to extract and analyze your data.


#7

#8

[Unreleased] Encrypted Sync Service (ESS)

Encrypted Sync Service is the easiest way to sync your Everdo data between your devices.

NOTE: This functionality is not yet released (soon)

How it works

ESS sync works similarly to the network-based sync. The differences are:

  • You don’t host the server yourself, which makes configuration easier and you don’t have to rely on a specific physical network for it to work smoothly.
  • All text data transmitted for sync purposes gets client-side encrypted. The sync server never receives or stores clear text.

Each of your devices needs to have the same encryption passphrase set up to be able to work with encrypted data.

Making sure the same encryption key is used on all devices

When a synced device sends encrypted data to ESS, it also sends a fingerprint or hash of the encryption key used. This is done to prevent a situation where different devices are set up with different encryption keys. This is not allowed as it would create data corruption where different devices are unable to decrypt each other’s data correctly. Consequently, a device can only sync with ESS if it presents a correct key hash. The key hash does not reveal any information about the key - it merely helps to determine whether two keys are exactly equal.

Create ESS Account

A user account is needed to authenticate your devices with ESS.
… to be added

Configure Your Devices

Before you begin configuration, sync your devices by whatever method you used before, otherwise continue.

Start with the desktop app

  1. Go to sync settings and select “Encrypted Sync”.
  2. Sign in using your ESS username and password.
  3. You should see sync status updating every few seconds. This means sync is working - it’s sending incremental updates to ESS.
  4. !!! SUPER IMPORTANT IF MOVING FROM NETWORK SYNC Press “Push” - this will make sure all data from your device gets added to ESS in encrypted form.

Mobile app

  1. Open setting then switch sync type to Encrypted Service.
  2. Sign in with the same credentials as you used on desktop and type in the exact same encryption key. You can scan the QR code from the desktop app.
  3. Now exit settings and try to swipe down to sync. You should see a success message if everything is in order.

Q&A

Once I start using ESS, can I go back to network sync?

Yes. It’s just a matter of re-configuring your devices.

Which data gets encrypted and how?

The titles and descriptions of items and tags are encrypted with AES256-CBC.
A 16-word passphrase generated on your computer is used as the encryption key. The passphrase is stored on each synced device in order to work with encryption (but not on ESS server).
Each string gets encrypted separately for every sync attempt and gets it’s own IV.

This is what an action’s title looks like when encrypted: 1.EoCd6AP5LeGP937S3Mi31g==.kFdPOGCP7e+Z8sAl4wcesADJY54TQULqmmUETq2QWHY=

Is my data also stored in an encrypted form on my devices?

No, the data on you devices is still in clear text. It’s only encrypted prior to being sent to ESS. Doesn’t make sense to store encrypted data on your own device since the key is stored in the same place anyway.

What happens if I lose the encryption key?

The encryption key is stored in a text file in the same directory as the database. If you lose it somehow, it’s not a huge problem, since the data is still in the clear on each of your devices. In this case you can simply generate a new key, update all devices to use it, then use the “Force Push” option to tell ESS to accept the new key.

I’m getting the “Key Mismatch” error

This means the device your are currently trying to sync uses a different encryption key compared to the one seen by ESS previously. You need to set the encryption keys to be exactly the same on all devices.


Participate in Encryption Sync Service closed test