Struct Config 

pub struct Config {

    pub language: Option<String>,
    pub theme: Option<String>,
    pub places_named: bool,
    pub screen_colours: Option<bool>,
    pub calmer_colours: Option<String>,
    pub notes_root: Option<String>,
    pub share_projects: bool,
    pub known_senders: Option<String>,
    pub blocked_senders: Option<String>,
    pub history_weeks: Option<u32>,
    pub fetch_minutes: Option<u32>,
    pub notes_folder: Option<String>,
    pub filed_words: Option<Vec<String>>,
    pub reading: Reading,
    pub mail: MailSettings,
    pub spam: SpamSettings,
    pub tasks: TaskSettings,
    pub planning: PlanningSettings,
    pub agenda: AgendaSettings,
    pub map: MapSettings,
    pub contacts: ContactSettings,
    pub words: Table,
    pub reminders: ReminderSettings,
    pub notify: NotifySettings,
    pub attention: Option<Settings>,
    pub free_time: FreeTimeSettings,
    pub pause: PauseSettings,
    pub dnd: DndSettings,
    pub letters: LetterSettings,
    pub routines: Vec<Routine>,
    pub weather: WeatherSettings,
    pub bitwarden: BitwardenSettings,
    pub github: GithubSettings,
    pub invoice: InvoiceSettings,
    pub mcp: McpSettings,
    pub accounts: Vec<Account>,
    pub sites: Vec<Account>,
    pub site_order: Vec<String>,
    pub accounts_off: Vec<Account>,
    pub windows: Vec<AdminWindow>,
    pub office_hours: Vec<AdminWindow>,
    pub time_off: Vec<TimeOff>,
    pub quiet: QuietSettings,
    pub porch: PorchSettings,
    pub reach: ReachSettings,
    pub calls: CallSettings,
}

Fields

language: Option<String>

The language of what Sioul says (“fr”, “en”); the session’s language if unset.

theme: Option<String>

“light” or “dark”; the system’s colours if unset.

places_named: bool

The places, on the left of the window, with their names beside their icons: for whoever reads words more easily than icons. Their icons alone if unset.

screen_colours: Option<bool>

colour: the sites shown in the screen’s own colours, read from its colour profile (docs/colour.md); on unless set to false.

calmer_colours: Option<String>

colour: loud colours on sites softened: “little”, “more”; off if unset.

notes_root: Option<String>

The notes folder: your Markdown files, with beside them your projects, budgets and papers. Its key in the file, case_store, is its first name, kept so that every configuration reads as before.

share_projects: bool

Projects, budgets and the bank’s movements (sioul-projects.toml, sioul-budgets.toml, sioul-bank.toml) travel sealed with the sharing between your devices, for a notes folder no sync carries; else they travel with that folder (docs/database.md).

known_senders: Option<String>

A text file of senders you know: one address or @domain per line.

blocked_senders: Option<String>

A text file of senders you blocked, in the same form.

history_weeks: Option<u32>

How far back mail and the agenda reach, in weeks; 0 for everything. Raising it fetches the older mail the next sync does not have yet.

fetch_minutes: Option<u32>

Minutes between two fetches of the folders a server does not push (IDLE keeps the inbox current).

notes_folder: Option<String>

Where new notes go in the notes folder.

filed_words: Option<Vec<String>>

Words that make a sender automatic, its mail filed: “no-reply”, “notification”… The whole list, as older settings wrote it; now [words.senders.automatic] (words), which wins once written.

reading: Reading

How long text reads: the family, size and line spacing of notes, mail and task notes.

mail: MailSettings

spam: SpamSettings

Sioul’s own spam filter: what it does with its verdicts, how sure it must be ([spam]).

tasks: TaskSettings

planning: PlanningSettings

What a day holds, as the plan learns it ([planning], docs/capacity.md).

agenda: AgendaSettings

map: MapSettings

contacts: ContactSettings

Contacts: the country of phone numbers written without one.

words: Table

The words Sioul looks for ([words], docs/words.md): the languages and countries whose packs are read, and your changes to each list (words::Words::of), kept as written.

reminders: ReminderSettings

Reminders before dates: events, dates asked, waits, payments (docs/reminders.md).

notify: NotifySettings

What each kind of notification did at each time, before [attention] ([notify]): read once, to seed it (attention::seeded).

attention: Option<Settings>

What reaches you, and when: a row per who on each channel and per kind ([attention], attention::Attention, docs/attention.md); none while never written, the older keys seeding it.

free_time: FreeTimeSettings

Free time, the global pause ([free_time], docs/pauses.md).

pause: PauseSettings

The pause, set up on a calm day ([pause], docs/pauses.md).

dnd: DndSettings

Do-not-disturb on every device: what turns it on, who gets through ([dnd], docs/do-not-disturb.md).

letters: LetterSettings

Paper letters: where their scans arrive (docs/porch.md).

routines: Vec<Routine>

Routines: timed steps played one at a time (docs/tasks.md).

weather: WeatherSettings

The place of the weather in the status line; none, no weather.

bitwarden: BitwardenSettings

Your Bitwarden account, to fill sites’ forms; read here, nothing installed.

github: GithubSettings

GitHub’s issues and pull requests as tasks: off unless asked (docs/github.md).

invoice: InvoiceSettings

Who sends your invoices, and what an hour costs by default.

mcp: McpSettings

What an AI agent connected to sioul mcp may use ([mcp], docs/mcp.md).

accounts: Vec<Account>

Your accounts, those switched on (Config::load sets the others aside).

sites: Vec<Account>

Sites kept open in Sioul (docs/sites.md): not accounts, they hold no sign-in of Sioul’s. Older files kept them as [[account]] of kind “portal”: Config::load reads them here, migrate_sites moves them.

site_order: Vec<String>

The order the Sites page shows them in, by their ids, as last chosen on any device (move_site): your devices share each site apart (format 2, docs/database.md), and this order with them. Sites it does not name come after, in the file’s order.

accounts_off: Vec<Account>

Accounts switched off: kept with their settings, neither synced nor shown.

windows: Vec<AdminWindow>

office_hours: Vec<AdminWindow>

When offices are open, for tasks that need one; Monday to Friday 9:00–17:00 when unsaid.

time_off: Vec<TimeOff>

Days off: holidays, sick leave; quiet from the first day to the last.

quiet: QuietSettings

porch: PorchSettings

The Porch’s own choices (docs/porch.md).

reach: ReachSettings

Who may reach you when, on each channel, before [attention]: read once, to seed it (attention::seeded).

calls: CallSettings

The camera, microphone and speaker calls in sites use (docs/sites.md).

Implementations

impl Config

pub fn working_hours(&self) -> Vec<AdminWindow>

Working hours, for quiet time: the days written with an end (by the week’s editor). Older admin windows, a start and minutes, keep opening the Porch and leave quiet time off until working hours are set.

pub fn week_hours(&self) -> Vec<AdminWindow>

The week’s hours: work’s and admin’s (docs/areas.md). Leisure is every other time: the free time an older Sioul set as hours is read and left aside, kept in the file.

pub fn office_hours(&self) -> Vec<AdminWindow>

When offices are open: the configuration’s, else Monday to Friday 9:00–17:00.

impl Config

pub fn task_kinds(&self, tr: &Translator) -> Vec<(String, String)>

The kinds of task, id and name: yours as you named them, else Sioul’s in your language.

impl Config

pub fn account_of(&self, file: &Path) -> Option<&Account>

The mail account a stored message belongs to, from where its file is.

pub fn load(path: &Path) -> Result<Config, String>

Reads a configuration file; each account takes the general history unless it has its own. Sites written as accounts by older files join the sites; accounts switched off are set aside.

pub fn settle(&mut self)

What load does once the file is read: sites apart, accounts switched off apart.

pub fn site(&self, id: &str) -> Option<&Account>

The site with this id.

pub fn every_account(&self) -> impl Iterator<Item = &Account>

Every account, those switched off too, in the file’s order of each.

pub fn history_days(&self) -> Option<i64>

How far back mail and the agenda reach, in days; None for everything.

pub fn notes_root_path(&self) -> Option<PathBuf>

The notes folder, with ~ expanded. On Android, unset: a folder of the app’s own storage, which no other app, nor any sync, reads.

pub fn known_senders_path(&self) -> PathBuf

The known senders’ file: known_senders, else known-senders.txt next to the configuration.

pub fn blocked_senders_path(&self) -> PathBuf

The blocked senders’ file: blocked_senders, else blocked-senders.txt next to the configuration.

pub fn safe_senders_path(&self) -> PathBuf

Who is safe (by default, their mail reaches you at any time): safe-senders.txt next to the configuration.

pub fn restricted_senders_path(&self) -> PathBuf

Who is restricted (by default, their mail comes in working hours only): restricted-senders.txt next to the configuration.

pub fn neutral_senders_path(&self) -> PathBuf

Who is neutral by your word, where a broader safe or blocked entry would name them otherwise.

pub fn all_trusted_ids(&self) -> Vec<String>

Every authserv-id of every account, for messages read outside an account.

pub fn account(&self, id: &str) -> Option<&Account>

The account with this id.

pub fn mail_sources(&self) -> Vec<Source>

The mail folders of every account that has mail on disk (portals have none). Sioul’s own checks are trusted first, then the provider’s.

pub fn free_id(&self, address: &str) -> String

An id for a new account from its address, unused yet: “example”, then “example-someone”.

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() -> Config

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.