Struct Config 

pub struct Config {

    pub config_version: u32,
    pub url: String,
    pub username: String,
    pub password: String,
    pub allow_insecure_certs: bool,
    pub disabled_calendars: Vec<String>,
    pub default_calendar: Option<String>,
    pub enable_local_mode: bool,
    pub hide_completed: bool,
    pub strikethrough_completed: bool,
    pub hide_fully_completed_tags: bool,
    pub hide_aliases_in_sidebar: bool,
    pub ui_scale: f32,
    pub sort_cutoff_months: Option<u32>,
    pub sort_standard_by_priority: bool,
    pub theme: AppTheme,
    pub language: Option<String>,
    pub urgent_days_horizon: u32,
    pub urgent_priority_threshold: u8,
    pub default_priority: u8,
    pub start_grace_period_days: u32,
    pub auto_reminders: bool,
    pub default_reminder_time: String,
    pub snooze_short_mins: u32,
    pub snooze_long_mins: u32,
    pub create_events_for_tasks: bool,
    pub delete_events_on_completion: bool,
    pub auto_refresh_interval_mins: u32,
    pub trash_retention_days: u32,
    pub max_done_roots: usize,
    pub max_done_subtasks: usize,
    pub show_ongoing_notifications: bool,
    pub show_priority_numbers: bool,
    pub pinned_actions: Vec<TaskAction>,
    pub quick_filter_term: String,
    pub quick_filter_icon: String,
    pub show_quick_filter: bool,
    pub sidebar_is_hidden: bool,
    pub description_editor: String,
    pub log_level: LogLevel,
    pub hidden_calendars: Vec<String>,
    pub tag_aliases: HashMap<String, Vec<String>>,
    pub expanded_tags: Vec<String>,
    pub expanded_locations: Vec<String>,
    pub expanded_done_groups: Vec<String>,
    pub sync_settings: bool,
    pub settings_updated_at: i64,
}

Fields

config_version: u32

IMPORTANT FOR DEVELOPERS: If you add a new action to default_pinned_actions() or modify a default collection that existing users should inherit, you MUST increment CURRENT_CONFIG_VERSION and add a migration step in Config::load(). Otherwise, existing users’ saved configs will override your new defaults.

url: String

username: String

password: String

allow_insecure_certs: bool

disabled_calendars: Vec<String>

default_calendar: Option<String>

enable_local_mode: bool

hide_completed: bool

strikethrough_completed: bool

hide_fully_completed_tags: bool

hide_aliases_in_sidebar: bool

ui_scale: f32

sort_cutoff_months: Option<u32>

sort_standard_by_priority: bool

When true, rank-4 (standard tasks with a due date within the cutoff) are sorted by priority first, then by due date. Default is false (date-first).

theme: AppTheme

language: Option<String>

urgent_days_horizon: u32

urgent_priority_threshold: u8

default_priority: u8

start_grace_period_days: u32

auto_reminders: bool

default_reminder_time: String

snooze_short_mins: u32

snooze_long_mins: u32

create_events_for_tasks: bool

delete_events_on_completion: bool

auto_refresh_interval_mins: u32

trash_retention_days: u32

max_done_roots: usize

max_done_subtasks: usize

show_ongoing_notifications: bool

show_priority_numbers: bool

pinned_actions: Vec<TaskAction>

quick_filter_term: String

quick_filter_icon: String

show_quick_filter: bool

sidebar_is_hidden: bool

description_editor: String

log_level: LogLevel

hidden_calendars: Vec<String>

tag_aliases: HashMap<String, Vec<String>>

expanded_tags: Vec<String>

expanded_locations: Vec<String>

expanded_done_groups: Vec<String>

sync_settings: bool

settings_updated_at: i64

Implementations

impl Config

pub fn get_syncable(&self) -> SyncableConfig

pub fn apply_syncable(&mut self, sync: SyncableConfig)

pub fn update_sync_timestamp_if_changed(&mut self, old: &Config)

pub fn load(ctx: &dyn AppContext) -> Result<Self>

Load the configuration from disk using an explicit context.

pub fn load_with_credentials(ctx: &dyn AppContext) -> Result<Self>

Load the configuration from disk and fetch the password from the OS keyring. Use this ONLY during app startup, explicit syncing, or opening the settings panel.

pub fn is_missing_config_error(err: &Error) -> bool

pub fn save(&self, ctx: &dyn AppContext) -> Result<()>

Save configuration using an explicit context. This method post-processes the TOML string to inject documentation comments.

pub fn save_with_credentials(&self, ctx: &dyn AppContext) -> Result<()>

Save configuration and update the OS keyring credential.

pub fn get_path_string(ctx: &dyn AppContext) -> Result<String>

Get the path string using an explicit context.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.