Settings

EasyOrg lets you configure different parameters. Most of them can be set by using the graphical user interface. These global settings will be applied the same for every file.

Sometimes you might want to have different settings depending on the file/project. You can do this by using org-mode settings on a per file basis at the top of each file.

The per-file settings take precedence over the GUI settings.

Per-File Settings in Org file

Below is an example of settings you can make at the start of your org-file.

#+TODO: TODO WAIT | DONE CANCELED
#+PROPERTY: Effort_ALL 0 0:10 0:30 1:00 2:00 3:00 4:00 5:00 6:00 7:00
#+PRIORITIES: A D C

The org documentation refers to this as in-buffer settings.

The #+TODO setting allows you to define a different set of todo states than what the global settings has defined. Before the | you define the Todo states and after the | you define the Done states.

The #+PROPERTY setting allows you to assign values to specific properties. EasyOrg internally currently only uses and supports the Effort_ALL property. It is used to set the values of the Effort selector.

The #+PRIORITIES setting allows you to define the priority levels in your file. The first value is the highest, the second is the lowest and the third is the default if you don't explicitly attach a priority to an item.

GUI Settings

There are three types of settings in the settings GUI, one related to the Editor, one to the Agenda and one related to Org mode. The Editor settings relate to fonts, editor color theme etc. The Agenda settings relate to agenda color theme and default views. The Org mode settings relate to TODO keywords, priorities etc.

Screenshot of settings

Editor settings

  • Font Size: Select the font size used in the editor
  • Font Family: The font family used in the editor
  • Theme: The color theme used in the editor
  • Highlight Active Line: A shadow covers the line where the cursor is
  • Indented Soft Wrap: Indents Soft Wrap if line is indented
  • Show Gutter: Show/Hide gutter
  • Show Line Numbers: Show line numbers in gutter
  • Show Invisibles: Show invisible characters
  • Default Directory: Select the directory you most often want to open from/save to

Preview settings

Here you can define the colors of each heading level in the Preview.

Agenda settings

  • Agenda View at Startup: Which agenda view you want to show at startup. 'Last' will show the last used one.
  • Panels Open at Startup: Show Editor + Agenda or only Agenda panel at startup.
  • Theme: Light or Dark theme for Agenda
  • Height of Body Text Field: Define the height of the Add/Edit windows body text field.

Org Mode settings

  • Log When Marking as Done: When marking a todo as DONE you can add a timestamp or note so you know when it happened and any comments you might have. The 'note' setting also adds a timestamp.

  • Keep Existing CLOSED timestamp when moving from DONE to other non-TODO state: Keep or remove the CLOSED timestamp when changing from DONE -> TODO.

  • Maintain one blank line between TODOs when Adding/Updating a TODO via GUI: Add a blank line between new and existing todo or add the todo on the next line.

  • Insert CREATED property when creating new TODO. If checked when creating new Todos via the GUI a CREATED property with the current date and time is inserted. This Created At timestamp is shown on the Todo card.

  • Prefer inserting ID (UUID) over CUSTOM_ID (timestamp) property. Default is to insert CUSTOM_ID timestamp properties. You can decide to insert ID properties with UUIDs instead. These are mainly used as link targets and used by the 'Create and Copy ID' context menu option.

  • Deadline Warning Days: The number of days to warn/notify the user before a deadline.

  • Todo Keywords: You can define your own TODO keywords (states). Add "Todo" type keywords to the left and "Done" type keywords on the right of the "|". Separate each keyword with a comma. Eg. TODO,WAIT|CANCELED,DONE. These settings are global. You can also define custom keywords per file. Se the Org mode docs.

  • Highest Priority: Priorities can range from A-Z. With A as the highest.

  • Lowest Priority: Set the lowest priority level.

  • Default Priority: This will be the priority level assigned to Todos which have no explicit priority set.

  • Global Properties: Here you can define global Org properties that will apply to all files. One property per line. For example set effort levels like so:

Effort_ALL 0 0:10 0:30 1:00 2:00 3:00 4:00 5:00 6:00 7:00