Struct Settings 

pub struct Settings {

    pub schema_version: u32,
    pub download_dir: Option<PathBuf>,
    pub transfer_concurrency: u32,
    pub cache_ttl_secs: u64,
    pub cache_size_cap_mb: u64,
    pub preview_size_limit_mb: u64,
    pub default_view_mode: String,
    pub notifications: NotificationSettings,
    pub fallback_threshold_mb: u64,
    pub transfer_confirmations: TransferConfirmations,
    pub s3_compatible_endpoints: Vec<S3CompatibleEndpoint>,
    pub auto_update: AutoUpdateSettings,
    pub diagnostics_enabled: bool,
    pub startup_behavior: StartupBehavior,
    pub proxy: ProxyMode,
    pub theme: String,
    pub keyboard_shortcuts: BTreeMap<String, String>,
    pub unknown: BTreeMap<String, Value>,
}

All application settings, versioned and forward-compatible.

Defaults are in defaults.rs; this struct must never hard-code a default inline — use Settings::default() as the canonical factory.

Fields

schema_version: u32

Schema version; currently always 1.

download_dir: Option<PathBuf>

Default download directory. None means “resolve from tauri::api::path::download_dir() at runtime”.

transfer_concurrency: u32

Maximum number of concurrent S3 object transfers.

cache_ttl_secs: u64

Listing cache TTL in seconds.

cache_size_cap_mb: u64

Maximum in-memory cache size in MiB.

preview_size_limit_mb: u64

Files larger than this (MiB) show a warning before preview.

default_view_mode: String

Default view mode: "Details", "Icons", "Gallery", "Tree", "FlatKey", "Column", or "DualPane".

notifications: NotificationSettings

fallback_threshold_mb: u64

Objects up to this size (MiB) auto-fall back on cross-account ops; larger objects require confirmation.

transfer_confirmations: TransferConfirmations

s3_compatible_endpoints: Vec<S3CompatibleEndpoint>

auto_update: AutoUpdateSettings

diagnostics_enabled: bool

Enable local log/exception collection. Collection is always user-initiated; nothing is ever auto-uploaded.

startup_behavior: StartupBehavior

proxy: ProxyMode

theme: String

"light", "dark", or "system".

keyboard_shortcuts: BTreeMap<String, String>

Sparse map of user-overridden shortcuts. Keys are action identifiers (e.g. "navigate.up"); values are key-combo strings (e.g. "Alt+Up"). The frontend baseline shortcut map is canonical and is NOT stored here; only user overrides are persisted (per Decision D3).

unknown: BTreeMap<String, Value>

Absorbs any JSON keys not known to this schema version. Round-tripped verbatim on save so future-app settings survive a downgrade.

Implementations

impl Settings

pub async fn load(path: &Path) -> Result<Self, AppError>

Load settings from path.

Returns Settings::default() when the file does not exist. Returns an AppError::Internal if the file exists but cannot be read or parsed.

pub fn load_sync(path: &Path) -> Self

Synchronous variant of load for use in contexts where async is unavailable (e.g. the Tauri setup callback, which is synchronous).

Returns Settings::default() when the file does not exist.

pub async fn save(&self, path: &Path) -> Result<(), AppError>

Persist settings to path atomically (write to <path>.tmp, then rename), so a crash during write cannot corrupt the stored settings.

Trait Implementations

impl Clone for Settings

fn clone(&self) -> Settings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Settings

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

Formats the value using the given formatter.

impl Default for Settings

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Settings

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Settings

fn eq(&self, other: &Settings) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Settings

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Settings