Notifications settings page

Closes: pop-os/cosmic-notifications#97 pop-os/cosmic-notifications#83

I implemented a settings page for COSMIC Notifications so that it is
easier to edit its config. COSMIC Notification already exposes a config
to tweak useful options like the maximum time a notification may stay on
the screen. Currently, there isn't a nice way to edit this config which
can be confusing to end users.

Author: joshuamegnauth54

Cargo.lock

@@ -30,6 +30,9 @@ git = "https://github.com/pop-os/cosmic-idle"
 [workspace.dependencies.cosmic-panel-config]
 git = "https://github.com/pop-os/cosmic-panel"
 
+[workspace.dependencies.cosmic-notifications-config]
+git = "https://github.com/pop-os/cosmic-notifications"
+
 [workspace.dependencies.cosmic-randr-shell]
 git = "https://github.com/pop-os/cosmic-randr"
 

Cargo.toml

@@ -22,6 +22,7 @@ cosmic-dbus-networkmanager = { git = "https://github.com/pop-os/dbus-settings-bi
 nm-secret-agent-manager = { git = "https://github.com/pop-os/dbus-settings-bindings", optional = true }
 cosmic-idle-config.workspace = true
 cosmic-panel-config = { workspace = true, optional = true }
+cosmic-notifications-config.workspace = true
 cosmic-protocols = { git = "https://github.com/pop-os/cosmic-protocols", optional = true }
 cosmic-randr-shell.workspace = true
 cosmic-randr = { workspace = true, optional = true }

cosmic-settings/Cargo.toml

@@ -4,6 +4,7 @@
 pub mod appearance;
 #[cfg(feature = "wayland")]
 pub mod dock;
+pub mod notifications;
 #[cfg(feature = "wayland")]
 pub mod panel;
 pub mod wallpaper;
@@ -37,6 +38,7 @@ impl page::AutoBind<crate::pages::Message> for Page {
     ) -> page::Insert<crate::pages::Message> {
         page = page.sub_page::<wallpaper::Page>();
         page = page.sub_page::<appearance::Page>();
+        page = page.sub_page::<notifications::Page>();
 
         #[cfg(feature = "wayland")]
         {

cosmic-settings/src/pages/desktop/mod.rs

@@ -0,0 +1,116 @@
+// Copyright 2026 System76 <info@system76.com>
+// SPDX-License-Identifier: GPL-3.0-only
+
+//! User configuration for `cosmic-notifications`.
+
+use cosmic::{
+    Apply, Element, Task,
+    cosmic_config::{Config, ConfigSet, CosmicConfigEntry},
+    widget::settings,
+};
+use cosmic_notifications_config::NotificationsConfig;
+use cosmic_settings_page::{self as page, AutoBind, Content, Info, Section, section};
+use slotmap::SlotMap;
+use tracing::{debug, trace, warn};
+
+use crate::pages;
+
+pub struct Page {
+    entity: page::Entity,
+    config_helper: Option<Config>,
+    config: NotificationsConfig,
+}
+
+impl Page {
+    /// Reload [`NotificationsConfig`] if it exists.
+    pub fn refresh(&mut self) {
+        self.config = load_config(self.config_helper.as_ref());
+    }
+}
+
+impl Default for Page {
+    fn default() -> Self {
+        debug!(id = %cosmic_notifications_config::ID, "Loading Notifications config for the first time this instance");
+
+        let config_helper = Config::new(cosmic_notifications_config::ID, 1).ok();
+        let config = load_config(config_helper.as_ref());
+
+        Self {
+            entity: Default::default(),
+            config_helper,
+            config,
+        }
+    }
+}
+
+impl page::Page<pages::Message> for Page {
+    fn info(&self) -> Info {
+        // XXX: Need icon!
+        Info::new("notifications", "")
+            .title(fl!("notifications"))
+            .description(fl!("notifications", "desc"))
+    }
+
+    fn content(
+        &self,
+        _sections: &mut SlotMap<section::Entity, Section<pages::Message>>,
+    ) -> Option<Content> {
+        crate::slab!(descriptions {
+            anchor = fl!("notifications", "anchor-desc");
+            max_notif = fl!("notifications", "max-desc");
+            max_per_app = fl!("notifications", "max-per-app-desc");
+            max_timeout_urgent = fl!("notifications", "max-timeout-urgent-desc");
+            max_timeout_normal = fl!("notifications", "max-timeout-normal-desc");
+            max_timeout_low = fl!("notifications", "max-timeout-low-desc");
+        });
+
+        Some(vec![
+            Section::default()
+                .title(fl!("notifications"))
+                .descriptions(descriptions)
+                .view::<Page>(move |_binder, page, section| {
+                    let descriptions = &section.descriptions;
+
+                    settings::section()
+                        .title(&*section.title)
+                        .apply(Element::from)
+                        .map(crate::pages::Message::Appearance)
+                }),
+        ])
+    }
+
+    fn on_enter(&mut self) -> Task<pages::Message> {
+        self.refresh();
+        Task::none()
+    }
+
+    fn set_id(&mut self, entity: page::Entity) {
+        self.entity = entity;
+    }
+}
+
+impl AutoBind<pages::Message> for Page {
+    // fn sub_pages(page: page::Insert<pages::Message>) -> page::Insert<pages::Message> {
+    //     page.sub_page::<Page>()
+    // }
+}
+
+/// Load [`NotificationsConfig`] or return the default settings.
+fn load_config(helper: Option<&Config>) -> NotificationsConfig {
+    trace!(id = %cosmic_notifications_config::ID, "Attempting to load config");
+
+    let Some(helper) = helper else {
+        debug!(id = %cosmic_notifications_config::ID, "Missing config helper; using default settings.");
+
+        return Default::default();
+    };
+
+    NotificationsConfig::get_entry(helper).unwrap_or_else(|(errors, config)| {
+        warn!(id = %cosmic_notifications_config::ID, "Loading config failed with: ");
+        for error in errors.iter().filter(|e| e.is_err()) {
+            warn!(id = %cosmic_notifications_config::ID, "\t* {error}");
+        }
+
+        config
+    })
+}

cosmic-settings/src/pages/desktop/notifications.rs

@@ -299,6 +299,18 @@ shadow-and-corners = Window shadow and corners
 
 notifications = Notifications
     .desc = Do Not Disturb, lockscreen notifications, and per-application settings
+    .anchor = Anchor
+    .anchor-desc = Screen location to display notification
+    .max = Maximum notifications
+    .max-desc = Maximum number of notifications that can be displayed at once
+    .max-per-app = Maximum notifications per app
+    .max-per-app-desc = Maximum number of notifications that can be displayed per app if not urgent nor constrained by "maximum notifications"
+    .max-timeout-urgent = Maximum timeout (Urgent)
+    .max-timeout-urgent-desc = Max time in milliseconds that an urgent notification will be displayed
+    .max-timeout-normal = Maximum timeout (Normal)
+    .max-timeout-normal-desc = Max time in milliseconds that a normal notification will be displayed
+    .max-timeout-low = Maximum timeout (Low)
+    .max-timeout-low-desc = Max time in milliseconds that a low priority notification will be displayed
 
 ## Desktop: Panel