Add settings hub delegation and registration descriptor

Add --settings-standalone flag and smart delegation: --settings tries
cosmic-applet-settings hub first, falls back to standalone window.
Install registration JSON for discovery by cosmic-applet-settings.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: imersia

justfile

@@ -56,6 +56,10 @@ install-local:
     mkdir -p ~/.local/share/icons/hicolor/symbolic/apps
     cp resources/{{appid}}-symbolic.svg ~/.local/share/icons/hicolor/symbolic/apps/
 
+    # Install applet registration for cosmic-applet-settings
+    mkdir -p ~/.local/share/cosmic-applet-settings/applets
+    cp resources/applet-settings.json ~/.local/share/cosmic-applet-settings/applets/{{name}}.json
+
     echo "Installation complete!"
     echo "Add the applet to your COSMIC panel to use it."
 
@@ -65,6 +69,7 @@ uninstall-local:
     rm -f ~/.local/share/applications/{{appid}}.desktop
     rm -f ~/.local/share/icons/hicolor/scalable/apps/{{appid}}.svg
     rm -f ~/.local/share/icons/hicolor/symbolic/apps/{{appid}}-symbolic.svg
+    rm -f ~/.local/share/cosmic-applet-settings/applets/{{name}}.json
 
 # Build and run
 br: build-debug run

resources/applet-settings.json

@@ -0,0 +1,6 @@
+{
+    "name": "RunKat",
+    "icon": "io.github.reality2_roycdavies.cosmic-runkat-symbolic",
+    "applet_id": "io.github.reality2_roycdavies.cosmic-runkat",
+    "settings_cmd": "cosmic-runkat --settings-standalone"
+}

src/main.rs

@@ -24,6 +24,8 @@ mod theme;
 
 use std::env;
 
+const APPLET_ID: &str = "io.github.reality2_roycdavies.cosmic-runkat";
+
 /// Print command-line usage information
 fn print_help() {
     println!(
@@ -32,9 +34,10 @@ fn print_help() {
 Usage: cosmic-runkat [OPTIONS]
 
 Options:
-    -s, --settings   Open the settings window
-    -h, --help       Show this help message
-    -v, --version    Show version information
+    -s, --settings           Open settings (via hub or standalone)
+    --settings-standalone    Open standalone settings window
+    -h, --help               Show this help message
+    -v, --version            Show version information
 
 No arguments: Run as a COSMIC panel applet.
 "#
@@ -73,7 +76,11 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
                 Ok(())
             }
             "-s" | "--settings" => {
-                tracing::info!("Opening settings window");
+                tracing::info!("Opening settings (trying hub first)");
+                open_settings().map_err(|e| e.into())
+            }
+            "--settings-standalone" => {
+                tracing::info!("Opening standalone settings window");
                 settings::run_settings().map_err(|e| e.into())
             }
             arg => {
@@ -86,3 +93,17 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
         applet::run_applet().map_err(|e| e.into())
     }
 }
+
+/// Try to open settings via cosmic-applet-settings hub; fall back to standalone.
+fn open_settings() -> cosmic::iced::Result {
+    use std::process::Command;
+    if Command::new("cosmic-applet-settings")
+        .arg(APPLET_ID)
+        .spawn()
+        .is_ok()
+    {
+        Ok(())
+    } else {
+        settings::run_settings()
+    }
+}