feat: implement headless mode support with deep linking, context menu isolation, and robust OAuth process lifecycle management.

Author: Hakanbaban53

src-tauri/src/core/lifecycle/shutdown.rs

@@ -107,6 +107,14 @@ pub async fn handle_shutdown(app_handle: AppHandle) {
                 }
             }
         }
+
+        // Kill the OAuth subprocess if it's still alive.
+        let state = app_handle.state::<RcloneState>();
+        if let Some(mut child) = state.oauth_process.lock().await.take() {
+            info!("Killing OAuth process during shutdown");
+            let _ = child.kill().await;
+            let _ = child.wait().await;
+        }
     }
 
     // Clear the in-memory config password so late-spawned processes can't read it.

src-tauri/src/lib.rs

@@ -378,6 +378,12 @@ fn setup_app(
         initialization(app_handle_clone).await;
     });
 
+    #[cfg(any(target_os = "linux", all(debug_assertions, windows)))]
+    {
+        use tauri_plugin_deep_link::DeepLinkExt;
+        app.deep_link().register_all()?;
+    }
+
     #[cfg(feature = "web-server")]
     {
         use crate::server::start_web_server;

src-tauri/src/rclone/commands/remote.rs

@@ -320,7 +320,23 @@ pub async fn update_remote(
         return Err("Missing remote type".into());
     };
 
-    let mut body = json!({ "name": name, "parameters": parameters });
+    let mut params_map = parameters;
+    if !params_map.contains_key("config_template_file")
+        && !params_map.contains_key("config_template")
+    {
+        let paths_res = crate::core::paths::AppPaths::from_app_handle(&app);
+        if let Ok(paths) = paths_res {
+            let oauth_tmpl = paths.oauth_template_path();
+            if oauth_tmpl.exists() {
+                params_map.insert(
+                    "config_template_file".to_string(),
+                    Value::String(oauth_tmpl.to_string_lossy().to_string()),
+                );
+            }
+        }
+    }
+
+    let mut body = json!({ "name": name, "parameters": params_map });
 
     if let Some(ref extra) = opt {
         body["opt"] = extra.clone();

src-tauri/src/rclone/engine/process.rs

@@ -70,7 +70,7 @@ impl RcApiEngine {
 
         let mut kill_error: Option<EngineError> = None;
 
-        if self.is_running() && child.id().is_some() {
+        if child.id().is_some() {
             let state = app.state::<RcloneState>();
             let quit_request = backend.inject_auth(state.client.post(backend.url_for(core::QUIT)));
 

src-tauri/src/utils/app/send_to/linux.rs

@@ -58,8 +58,12 @@ pub fn register(
     let home = get_home_dir()?;
     let paths = LinuxPaths::new(&home);
     let exec_path = if cfg!(feature = "flatpak") {
-        let app_id = std::env::var("FLATPAK_ID")
-            .unwrap_or_else(|_| crate::utils::app::platform::APP_ID.to_string());
+        let default_app_id = if cfg!(feature = "web-server") {
+            format!("{}.headless", crate::utils::app::platform::APP_ID)
+        } else {
+            crate::utils::app::platform::APP_ID.to_string()
+        };
+        let app_id = std::env::var("FLATPAK_ID").unwrap_or(default_app_id);
         format!("flatpak run {app_id}")
     } else {
         format!("\"{}\"", current_exe.to_string_lossy())

src-tauri/src/utils/app/send_to/windows.rs

@@ -1,5 +1,19 @@
 use std::path::{Path, PathBuf};
 
+/// Display label shown in the Windows context menu submenu header.
+const CONTEXT_MENU_LABEL: &str = if cfg!(feature = "web-server") {
+    "RClone Manager Headless"
+} else {
+    "RClone Manager"
+};
+
+/// Registry sub-key name — must differ between desktop and headless so both can coexist.
+const REGISTRY_KEY: &str = if cfg!(feature = "web-server") {
+    "RCloneManagerHeadless"
+} else {
+    "RCloneManager"
+};
+
 struct WindowsPaths {
     send_to: PathBuf,
 }
@@ -25,13 +39,13 @@ fn register_context_menu_entry(
     icon_path: &str,
     command: &str,
 ) -> Result<(), String> {
-    let parent_path = format!(r"{root_path}\shell\RCloneManager");
+    let parent_path = format!(r"{root_path}\shell\{REGISTRY_KEY}");
 
     let (parent_key, _) = hkcu
         .create_subkey(&parent_path)
         .map_err(|e| format!("Failed creating registry key '{parent_path}': {e}"))?;
     parent_key
-        .set_value("MUIVerb", &"RClone Manager")
+        .set_value("MUIVerb", &CONTEXT_MENU_LABEL)
         .map_err(|e| format!("Failed creating registry key '{parent_path}': {e}"))?;
     parent_key
         .set_value("Icon", &icon_path)
@@ -61,7 +75,7 @@ fn register_context_menu_entry(
 fn unregister_context_menu_entry(hkcu: &winreg::RegKey, root_path: &str, name: &str) {
     use winreg::enums::KEY_ALL_ACCESS;
 
-    let parent_path = format!(r"{root_path}\shell\RCloneManager");
+    let parent_path = format!(r"{root_path}\shell\{REGISTRY_KEY}");
     let Ok(parent_key) = hkcu.open_subkey_with_flags(&parent_path, KEY_ALL_ACCESS) else {
         return;
     };
@@ -74,7 +88,7 @@ fn unregister_context_menu_entry(hkcu: &winreg::RegKey, root_path: &str, name: &
     if shell_key.enum_keys().count() == 0 {
         drop(shell_key);
         drop(parent_key);
-        let _ = hkcu.delete_subkey_all(&parent_path);
+        let _ = hkcu.delete_subkey_all(format!(r"{root_path}\shell\{REGISTRY_KEY}"));
     }
 }
 
@@ -189,7 +203,7 @@ pub fn is_registered(name: &str) -> Result<bool, String> {
     let hkcu = RegKey::predef(HKEY_CURRENT_USER);
 
     let registered_under = |root_path: &str| {
-        hkcu.open_subkey(format!(r"{root_path}\shell\RCloneManager\shell\{name}"))
+        hkcu.open_subkey(format!(r"{root_path}\shell\{REGISTRY_KEY}\shell\{name}"))
             .is_ok()
     };
 

src-tauri/src/utils/process/command.rs

@@ -20,7 +20,8 @@ impl Command {
 
         cmd.stdout(Stdio::piped())
             .stderr(Stdio::piped())
-            .stdin(Stdio::piped());
+            .stdin(Stdio::piped())
+            .kill_on_drop(true);
 
         #[cfg(windows)]
         {

src-tauri/windows/hooks.nsh

@@ -1,5 +1,8 @@
 !macro NSIS_HOOK_PREUNINSTALL
   Delete "$APPDATA\Microsoft\Windows\SendTo\* (RClone Manager).lnk"
+  Delete "$APPDATA\Microsoft\Windows\SendTo\* (RClone Manager Headless).lnk"
   DeleteRegKey HKCU "Software\Classes\*\shell\RCloneManager"
   DeleteRegKey HKCU "Software\Classes\Directory\shell\RCloneManager"
+  DeleteRegKey HKCU "Software\Classes\*\shell\RCloneManagerHeadless"
+  DeleteRegKey HKCU "Software\Classes\Directory\shell\RCloneManagerHeadless"
 !macroend

src-tauri/windows/wix-fragment.wxs

@@ -14,6 +14,7 @@
     <DirectoryRef Id="SendToFolder">
       <Component Id="CleanupSendToShortcuts" Guid="F90B1E63-8CA6-4DDF-9C1D-F8E3B6897EFA">
         <RemoveFile Id="RemoveSendToShortcuts" Name="* (RClone Manager).lnk" On="uninstall" />
+        <RemoveFile Id="RemoveSendToShortcutsHeadless" Name="* (RClone Manager Headless).lnk" On="uninstall" />
 
         <!-- Clean up the intermediate directories we declared under AppDataFolder -->
         <RemoveFolder Id="RemoveSendToFolder" On="uninstall" />
@@ -23,6 +24,8 @@
         <!-- Cleanup registry keys on uninstallation -->
         <RegistryKey Root="HKCU" Key="Software\Classes\*\shell\RCloneManager" ForceDeleteOnUninstall="yes" />
         <RegistryKey Root="HKCU" Key="Software\Classes\Directory\shell\RCloneManager" ForceDeleteOnUninstall="yes" />
+        <RegistryKey Root="HKCU" Key="Software\Classes\*\shell\RCloneManagerHeadless" ForceDeleteOnUninstall="yes" />
+        <RegistryKey Root="HKCU" Key="Software\Classes\Directory\shell\RCloneManagerHeadless" ForceDeleteOnUninstall="yes" />
 
         <!-- KeyPath dummy value to make the component self-contained -->
         <RegistryValue Root="HKCU" Key="Software\Classes\*\shell\RCloneManager" Name="WixCleanupHelper" Value="1" Type="integer" KeyPath="yes" />