Struct Settings 

pub struct Settings {

    pub layout_left_pct: u16,
    pub layout_center_pct: u16,
    pub layout_right_pct: u16,
    pub app_dry_run_default: bool,
    pub keymap: KeyMap,
    pub sort_mode: SortMode,
    pub clipboard_suffix: String,
    pub show_recent_pane: bool,
    pub show_install_pane: bool,
    pub show_keybinds_footer: bool,
    pub selected_countries: String,
    pub mirror_count: u16,
    pub virustotal_api_key: String,
    pub scan_do_clamav: bool,
    pub scan_do_trivy: bool,
    pub scan_do_semgrep: bool,
    pub scan_do_shellcheck: bool,
    pub scan_do_virustotal: bool,
    pub scan_do_custom: bool,
    pub scan_do_sleuth: bool,
    pub start_in_news: bool,
    pub news_filter_show_arch_news: bool,
    pub news_filter_show_advisories: bool,
    pub news_filter_show_pkg_updates: bool,
    pub news_filter_show_aur_updates: bool,
    pub news_filter_show_aur_comments: bool,
    pub news_filter_installed_only: bool,
    pub news_max_age_days: Option<u32>,
    pub startup_news_configured: bool,
    pub startup_news_show_arch_news: bool,
    pub startup_news_show_advisories: bool,
    pub startup_news_show_aur_updates: bool,
    pub startup_news_show_aur_comments: bool,
    pub startup_news_show_pkg_updates: bool,
    pub startup_news_max_age_days: Option<u32>,
    pub news_cache_ttl_days: u32,
    pub package_marker: PackageMarker,
    pub news_read_symbol: String,
    pub news_unread_symbol: String,
    pub preferred_terminal: String,
    pub skip_preflight: bool,
    pub locale: String,
    pub search_startup_mode: bool,
    pub fuzzy_search: bool,
    pub updates_refresh_interval: u64,
    pub installed_packages_mode: InstalledPackagesMode,
    pub get_announcement: bool,
    pub use_passwordless_sudo: bool,
    pub use_terminal_theme: bool,
}

User-configurable application settings parsed from pacsea.conf.

Fields

layout_left_pct: u16

Percentage width allocated to the Recent pane (left column).

layout_center_pct: u16

Percentage width allocated to the Search pane (center column).

layout_right_pct: u16

Percentage width allocated to the Install pane (right column).

app_dry_run_default: bool

Default value for the application’s dry-run mode on startup. This can be toggled via the --dry-run CLI flag.

keymap: KeyMap

Configurable key bindings parsed from pacsea.conf

sort_mode: SortMode

Initial sort mode for results list.

clipboard_suffix: String

Text appended when copying PKGBUILD to clipboard.

show_recent_pane: bool

Whether the Search history pane should be shown on startup.

show_install_pane: bool

Whether the Install/Remove pane should be shown on startup.

show_keybinds_footer: bool

Whether the keybinds footer should be shown on startup.

selected_countries: String

Selected countries used when updating mirrors (comma-separated or multiple).

mirror_count: u16

Number of mirrors to fetch/rank when updating.

virustotal_api_key: String

VirusTotal API key for security scanning.

scan_do_clamav: bool

Whether to run ClamAV scan on AUR packages.

scan_do_trivy: bool

Whether to run Trivy scan on AUR packages.

scan_do_semgrep: bool

Whether to run Semgrep scan on AUR packages.

scan_do_shellcheck: bool

Whether to run ShellCheck scan on AUR packages.

scan_do_virustotal: bool

Whether to run VirusTotal scan on AUR packages.

scan_do_custom: bool

Whether to run custom scan on AUR packages.

scan_do_sleuth: bool

Whether to run Sleuth scan on AUR packages.

start_in_news: bool

Whether to start the app in News mode (true) or Package mode (false).

news_filter_show_arch_news: bool

Whether to show Arch news items in the News view.

news_filter_show_advisories: bool

Whether to show security advisories in the News view.

news_filter_show_pkg_updates: bool

Whether to show installed package update items in the News view.

news_filter_show_aur_updates: bool

Whether to show AUR package update items in the News view.

news_filter_show_aur_comments: bool

Whether to show installed AUR comment items in the News view.

news_filter_installed_only: bool

Whether to restrict advisories to installed packages in the News view.

news_max_age_days: Option<u32>

Maximum age of news items in days (None = unlimited).

startup_news_configured: bool

Whether startup news popup setup has been completed.

startup_news_show_arch_news: bool

Whether to show Arch news in startup news popup.

startup_news_show_advisories: bool

Whether to show security advisories in startup news popup.

startup_news_show_aur_updates: bool

Whether to show AUR updates in startup news popup.

startup_news_show_aur_comments: bool

Whether to show AUR comments in startup news popup.

startup_news_show_pkg_updates: bool

Whether to show official package updates in startup news popup.

startup_news_max_age_days: Option<u32>

Maximum age of news items in days for startup news popup (None = unlimited).

news_cache_ttl_days: u32

How many days to keep Arch news and advisories cached on disk. Default is 7 days. Helps reduce network requests on startup.

package_marker: PackageMarker

Visual marker style for packages added to Install/Remove/Downgrade lists.

news_read_symbol: String

Symbol used to mark a news item as read in the News modal.

news_unread_symbol: String

Symbol used to mark a news item as unread in the News modal.

preferred_terminal: String

Preferred terminal binary name to spawn for shell commands (e.g., “alacritty”, “kitty”, “gnome-terminal”). When empty, Pacsea auto-detects from available terminals.

skip_preflight: bool

When true, skip the Preflight modal and execute actions directly (install/remove/downgrade). Defaults to false to preserve the safer, review-first workflow.

locale: String

Locale code for translations (e.g., “de-DE”, “en-US”). Empty string means auto-detect from system locale.

search_startup_mode: bool

Search input mode on startup. When false, starts in insert mode (default). When true, starts in normal mode.

fuzzy_search: bool

Whether fuzzy search is enabled by default on startup. When false, uses normal substring search (default). When true, uses fuzzy matching (fzf-style).

updates_refresh_interval: u64

Refresh interval in seconds for pacman -Qu and AUR helper checks. Default is 30 seconds. Set to a higher value to reduce resource usage on slow systems.

installed_packages_mode: InstalledPackagesMode

Filter mode for installed packages display. LeafOnly shows explicitly installed packages with no dependents. AllExplicit shows all explicitly installed packages.

get_announcement: bool

Whether to fetch remote announcements from GitHub Gist. If true, fetches announcements from the configured Gist URL. If false, remote announcements are disabled (version announcements still show).

use_passwordless_sudo: bool

Whether to use passwordless sudo for install operations when available. If false (default), password prompt is always shown even if passwordless sudo is configured. If true, passwordless sudo is used when available, skipping the password prompt. This acts as an additional safety barrier requiring explicit opt-in.

use_terminal_theme: bool

Whether to use the terminal’s theme colors instead of theme.conf. If true, Pacsea queries the terminal for foreground/background colors via OSC 10/11. If false (default), uses theme.conf colors. Note: Terminal theme is also used automatically when theme.conf is missing/invalid and the terminal is on the supported list (alacritty, kitty, konsole, ghostty, xterm, gnome-terminal, xfce4-terminal, tilix, mate-terminal, wezterm-gui, WezTerm).

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

What: Provide the built-in baseline configuration for Pacsea settings.

Inputs:

• None.

Output:

• Returns a Settings instance populated with Pacsea’s preferred defaults.

Details:

• Sets balanced pane layout percentages and enables all panes by default.
• Enables all scan types and uses Catppuccin-inspired news glyphs.