Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

programs.khal.enable

Whether to enable khal, a CLI calendar application.

Type: boolean

Default:

false

Example:

true

Declared by:

programs.khal.package

The khal package to use.

Type: null or package

Default:

pkgs.khal

Declared by:

programs.khal.locale

khal locale settings.

Type: submodule

Default:

{ }

Declared by:

programs.khal.locale.dateformat

khal will display and understand all dates in this format.

Format strings are for Python strftime, similarly to strftime(3).

Type: string

Default:

"%x"

Declared by:

programs.khal.locale.datetimeformat

khal will display and understand all datetimes in this format.

Format strings are for Python strftime, similarly to strftime(3).

Type: string

Default:

"%c"

Declared by:

programs.khal.locale.default_timezone

Default for new events or if khal does not understand the timezone in an ical file. If null, the timezone of your computer will be used.

Type: null or string

Default:

null

Declared by:

programs.khal.locale.firstweekday

The first day of the week, where Monday is 0 and Sunday is 6.

Type: integer between 0 and 6 (both inclusive)

Default:

0

Declared by:

programs.khal.locale.local_timezone

khal will show all times in this timezone. If null, the timezone of your computer will be used.

Type: null or string

Default:

null

Declared by:

programs.khal.locale.longdateformat

khal will display and understand all dates in this format. It should contain a year (e.g. %Y).

Format strings are for Python strftime, similarly to strftime(3).

Type: string

Default:

"%x"

Declared by:

programs.khal.locale.longdatetimeformat

khal will display and understand all datetimes in this format. It should contain a year (e.g. %Y).

Format strings are for Python strftime, similarly to strftime(3).

Type: string

Default:

"%c"

Declared by:

programs.khal.locale.timeformat

khal will display and understand all times in this format.

Format strings are for Python strftime, similarly to strftime(3).

Type: string

Default:

"%X"

Declared by:

programs.khal.locale.unicode_symbols

By default khal uses some Unicode symbols (as in “non-ASCII”) as indicators for things like repeating events. If your font, encoding etc. does not support those symbols, set this to false (this will enable ASCII-based replacements).

Type: boolean

Default:

true

Declared by:

programs.khal.locale.weeknumbers

Enable week numbers in calendar and interactive (ikhal) mode. As those are ISO week numbers, they only work properly if firstweekday is set to 0.

Type: one of “off”, “left”, “right”

Default:

"off"

Declared by:

programs.khal.settings

Configuration options to add to the various sections in the configuration file.

Type: attribute set of section of an INI file (attrs of INI atom (null, bool, int, float or string))

Default:

{ }

Example:

{
  default = {
    default_calendar = "Calendar";
    timedelta = "5d";
  };
  view = {
    agenda_event_format = "{calendar-color}{cancelled}{start-end-time-style} {title}{repeat-symbol}{reset}";
  };
}

Declared by: