It appears that configuration is done using gsetting values or an .ini file. However, there is no single set of documentation for these values.

For example, what are org.workrave.general.operation-mode and org.workrave.general.usage-mode?

*** Bug 1142 has been marked as a duplicate of this bug. ***

Linked duplicate is about dconf settings not containing summary, description and default values.

It looks like operation-mode refers to Normal (0), Quiet (2) and Suspended (1) modes, and usage-mode refers to Reading Mode being off (0) or on (1). (Discovered by watching dconf editor while changing these settings, and changing settings in dconf editor and seeing changes in app indicator.)

Workrave's settings were never designed to be an external API:

- Many settings use numeric values instead of more user readable strings.
- Workrave does not extensively check the values it reads. Incorrect values may result in unspecified behaviour.

This is also one of the reasons I never documented the settings. But feel free to document the schema files. It is not very high on my todo list...

Thanks for the feedback Rob, I understand this is not a common use case. It looks like the relevant file would be: workrave / frontend / gtkmm / src / org.workrave.gui.gschema.xml.in.in ?