fix: improve snap support and installation instructions

  - Add SNAP_REAL_HOME for tilde expansion in snap environments
  - Add snap connect commands for home and removable-media permissions
  - Add hash -r to refresh shell path cache after installation

Author: NDXDeveloper

.github/workflows/ci.yml

@@ -991,19 +991,26 @@ jobs:
           ```bash
           wget https://github.com/NDXDeveloper/slashsum/releases/download/${{ github.ref_name }}/slashsum_${{ github.ref_name }}_amd64.deb
           sudo apt install ./slashsum_${{ github.ref_name }}_amd64.deb
+          hash -r
           slashsum --version
           ```
 
           #### Linux (Snap Store - Recommended)
           ```bash
           sudo snap install slashsum
+          sudo snap connect slashsum:home
+          sudo snap connect slashsum:removable-media
+          hash -r  # Refresh shell path cache
           slashsum --version
           ```
 
           #### Linux (Snap from GitHub Release)
           ```bash
           wget https://github.com/NDXDeveloper/slashsum/releases/download/${{ github.ref_name }}/slashsum_${{ github.ref_name }}_amd64.snap
           sudo snap install --dangerous slashsum_${{ github.ref_name }}_amd64.snap
+          sudo snap connect slashsum:home
+          sudo snap connect slashsum:removable-media
+          hash -r  # Refresh shell path cache
           slashsum --version
           ```
 

INSTALL

@@ -36,6 +36,7 @@ usermod -aG wheel your_username
 # =============================================================================
 
 sudo apt install ./slashsum_*_amd64.deb
+hash -r
 
 # Or with dpkg
 sudo dpkg -i slashsum_*_amd64.deb
@@ -87,6 +88,9 @@ sudo ln -s /var/lib/snapd/snap /snap
 
 ## Install from Snap Store (recommended - auto-updates)
 sudo snap install slashsum
+sudo snap connect slashsum:home
+sudo snap connect slashsum:removable-media
+hash -r
 
 ## Run
 slashsum --version
@@ -98,6 +102,9 @@ slashsum --version
 
 ## Install the snap package from release file
 sudo snap install --dangerous slashsum_*_amd64.snap
+sudo snap connect slashsum:home
+sudo snap connect slashsum:removable-media
+hash -r
 
 ## Run
 slashsum --version

src/main.rs

@@ -261,14 +261,20 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
 
 /// Expands tilde (~) to home directory in file paths
 /// Handles both "~" and "~/path" patterns
+/// Supports snap confinement (SNAP_REAL_HOME), standard Unix (HOME), and Windows (USERPROFILE)
 fn expand_tilde(path: &str) -> PathBuf {
-    if path.starts_with("~/") {
-        if let Some(home) = env::var_os("HOME").or_else(|| env::var_os("USERPROFILE")) {
-            return PathBuf::from(home).join(&path[2..]);
-        }
-    } else if path == "~" {
-        if let Some(home) = env::var_os("HOME").or_else(|| env::var_os("USERPROFILE")) {
-            return PathBuf::from(home);
+    if path.starts_with("~/") || path == "~" {
+        // Priority: SNAP_REAL_HOME (snap), HOME (Unix), USERPROFILE (Windows)
+        let home = env::var_os("SNAP_REAL_HOME")
+            .or_else(|| env::var_os("HOME"))
+            .or_else(|| env::var_os("USERPROFILE"));
+
+        if let Some(home_dir) = home {
+            if path == "~" {
+                return PathBuf::from(home_dir);
+            } else {
+                return PathBuf::from(home_dir).join(&path[2..]);
+            }
         }
     }
     PathBuf::from(path)