souleyez 2.22.0__py3-none-any.whl → 2.26.0__py3-none-any.whl

souleyez/ui/interactive.py

@@ -130,6 +130,63 @@ def render_standard_header(title: str, width: int = None) -> None:
     click.echo()
 
 
+def parse_syslog_description(desc: str) -> str:
+    """
+    Extract meaningful message from syslog-formatted descriptions.
+
+    Syslog format: <timestamp> <host> [timestamp] <program>[pid]: <message>
+    Example input: "Jan  8 07:00:05 192.168.1.111 Jan  8 07:00:05 eyez CRON[537281]: pam_unix(cron:session): session closed for user yoda"
+    Example output: "CRON: pam_unix(cron:session): session closed for user yoda"
+    """
+    import re
+
+    if not desc:
+        return 'No description'
+
+    # Try to find the actual message after common syslog patterns
+    # Pattern 1: Look for process name with PID followed by colon (e.g., "CRON[537281]:")
+    pid_match = re.search(r'([A-Za-z_][A-Za-z0-9_-]*)\[(\d+)\]:\s*(.+)$', desc)
+    if pid_match:
+        process_name = pid_match.group(1)
+        message = pid_match.group(3)
+        return f"{process_name}: {message}"
+
+    # Pattern 2: Look for systemd-style messages (e.g., "systemd[1]: Started...")
+    systemd_match = re.search(r'(systemd(?:-[a-z]+)?)\[?\d*\]?:\s*(.+)$', desc, re.IGNORECASE)
+    if systemd_match:
+        return f"{systemd_match.group(1)}: {systemd_match.group(2)}"
+
+    # Pattern 3: Look for kernel messages
+    kernel_match = re.search(r'kernel:\s*(.+)$', desc)
+    if kernel_match:
+        return f"kernel: {kernel_match.group(1)}"
+
+    # Pattern 4: Generic - find content after last colon that has substance
+    colon_parts = desc.split(': ')
+    if len(colon_parts) > 1:
+        # Get the meaningful part (usually after the first "process:" pattern)
+        for i, part in enumerate(colon_parts):
+            # Skip parts that look like timestamps or IPs
+            if not re.match(r'^(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec|\d{1,3}\.\d{1,3}|\d{4}-\d{2})', part):
+                # Found something meaningful - join from here
+                meaningful = ': '.join(colon_parts[i:])
+                if len(meaningful) > 10:  # Ensure it's substantial
+                    return meaningful
+
+    # Pattern 5: Strip leading timestamp patterns
+    # Remove patterns like "Jan  8 07:00:05 192.168.1.111 Jan  8 07:00:05 hostname"
+    stripped = re.sub(
+        r'^(?:[A-Z][a-z]{2}\s+\d+\s+\d{2}:\d{2}:\d{2}\s+\S+\s*)+',
+        '', desc
+    ).strip()
+
+    if stripped and len(stripped) > 5:
+        return stripped
+
+    # Fallback: return original if no patterns matched
+    return desc
+
+
 def _show_upgrade_prompt(feature_name: str):
     """Show upgrade prompt when FREE user tries to access Pro feature."""
     from rich.panel import Panel
@@ -5345,7 +5402,7 @@ def view_job_detail(job_id: int):
 
         # Check if tool has a parser - if yes, hide raw logs by default
         tool = job.get('tool', '')
-        has_parser = tool in ['dnsrecon', 'nmap', 'nuclei', 'nikto', 'dalfox', 'theharvester', 'sqlmap', 'ffuf', 'gobuster', 'wpscan', 'crackmapexec', 'hydra', 'whois', 'smbmap', 'enum4linux', 'msf_auxiliary', 'searchsploit']
+        has_parser = tool in ['dnsrecon', 'nmap', 'ard', 'nuclei', 'nikto', 'dalfox', 'theharvester', 'sqlmap', 'ffuf', 'gobuster', 'wpscan', 'crackmapexec', 'hydra', 'whois', 'smbmap', 'enum4linux', 'msf_auxiliary', 'searchsploit']
 
         # Show log file if exists
         log_path = job.get('log')
@@ -5941,7 +5998,9 @@ def view_job_detail(job_id: int):
                 pass
 
         # Parse and display Nmap results if available (only when not showing raw logs)
-        if not show_raw_logs and job.get('tool') == 'nmap' and job.get('status') in ['done', 'completed'] and log_path and os.path.exists(log_path):
+        # ARD plugin uses nmap under the hood, so include it here
+        nmap_based_tools = ['nmap', 'ard']
+        if not show_raw_logs and job.get('tool') in nmap_based_tools and job.get('status') in ['done', 'completed'] and log_path and os.path.exists(log_path):
             try:
                 from souleyez.parsers.nmap_parser import parse_nmap_output
                 with open(log_path, 'r', encoding='utf-8', errors='replace') as f:
@@ -8898,7 +8957,8 @@ def _view_wazuh_alerts(engagement_id: int):
                 icon = get_level_icon(level)
                 rule_id = str(alert.get('rule_id', 'N/A'))[:10]
                 agent_name = alert.get('agent_name', 'N/A')[:15]
-                desc = (alert.get('description') or 'No description')[:45]
+                raw_desc = alert.get('description') or 'No description'
+                desc = parse_syslog_description(raw_desc)[:45]
                 ts = alert.get('timestamp', 'N/A')
                 if hasattr(ts, 'strftime'):
                     ts = ts.strftime('%Y-%m-%d %H:%M:%S')
@@ -9075,7 +9135,8 @@ def _view_alert_detail(alert: dict):
 
     # Get values from normalized format first, then fall back to raw_data
     rule_id = alert.get('rule_id') or rule.get('id', 'N/A')
-    description = alert.get('description') or rule.get('description', 'N/A')
+    raw_description = alert.get('description') or rule.get('description', 'N/A')
+    description = parse_syslog_description(raw_description)
     level = alert.get('level', 0) or rule.get('level', 0)
     severity = alert.get('severity', 'info')
 
@@ -15790,6 +15851,37 @@ def view_findings(engagement_id: int):
             summary_parts.append(f"Filters: {', '.join(active_filters)}")
 
         click.echo("  " + "  |  ".join(summary_parts))
+
+        # Show tool distribution legend
+        if findings:
+            tool_counts = {}
+            for f in findings:
+                tool = f.get('tool') or 'unknown'
+                tool_counts[tool] = tool_counts.get(tool, 0) + 1
+
+            # Sort by count (descending) and format
+            sorted_tools = sorted(tool_counts.items(), key=lambda x: x[1], reverse=True)
+            tool_parts = [f"{tool}({count})" for tool, count in sorted_tools]
+
+            # Display on one or more lines if needed
+            tool_legend = "  Tools: " + " | ".join(tool_parts)
+            if len(tool_legend) > width - 4:
+                # Wrap to multiple lines if too long
+                lines = []
+                current_line = "  Tools: "
+                for i, part in enumerate(tool_parts):
+                    test_line = current_line + part + (" | " if i < len(tool_parts) - 1 else "")
+                    if len(test_line) > width - 4 and current_line != "  Tools: ":
+                        lines.append(current_line.rstrip(" | "))
+                        current_line = "         " + part + (" | " if i < len(tool_parts) - 1 else "")
+                    else:
+                        current_line = test_line
+                lines.append(current_line.rstrip(" | "))
+                for line in lines:
+                    click.echo(click.style(line, fg='cyan'))
+            else:
+                click.echo(click.style(tool_legend, fg='cyan'))
+
         click.echo()
 
         if not findings:
@@ -29526,11 +29618,11 @@ def _check_msfdb_ready() -> bool:
         click.echo("  The Metasploit database needs to be initialized for full functionality.")
         click.echo("  Without it, you won't be able to store hosts, credentials, or loot.")
         click.echo()
-        if click.confirm("  Initialize database now? (runs: msfdb init)", default=True):
+        if click.confirm("  Initialize database now? (runs: sudo msfdb init)", default=True):
             click.echo()
-            click.echo(click.style("  Running msfdb init...", fg='cyan'))
+            click.echo(click.style("  Running sudo msfdb init...", fg='cyan'))
             try:
-                result = subprocess.run(['msfdb', 'init'], capture_output=False, text=True)
+                result = subprocess.run(['sudo', 'msfdb', 'init'], capture_output=False, text=True)
                 if result.returncode == 0:
                     click.echo(click.style("  Database initialized successfully!", fg='green'))
                     click.echo()

souleyez/ui/setup_wizard.py

@@ -95,6 +95,74 @@ def _configure_sudoers(tool_name: str, tool_path: str) -> bool:
         return False
 
 
+def _install_desktop_shortcut():
+    """
+    Install desktop shortcut for SoulEyez in Applications menu.
+
+    This runs silently during setup - any errors are ignored to not
+    disrupt the setup flow.
+    """
+    try:
+        applications_dir = Path.home() / '.local' / 'share' / 'applications'
+        icons_dir = Path.home() / '.local' / 'share' / 'icons'
+        desktop_file = applications_dir / 'souleyez.desktop'
+        icon_dest = icons_dir / 'souleyez.png'
+
+        # Skip if already installed
+        if desktop_file.exists():
+            return
+
+        # Create directories
+        applications_dir.mkdir(parents=True, exist_ok=True)
+        icons_dir.mkdir(parents=True, exist_ok=True)
+
+        # Find and copy icon
+        try:
+            # Try importlib.resources first (Python 3.9+)
+            try:
+                from importlib.resources import files
+                icon_source = files('souleyez.assets').joinpath('souleyez-icon.png')
+                with open(icon_source, 'rb') as src:
+                    icon_data = src.read()
+            except (ImportError, TypeError, FileNotFoundError):
+                # Fallback: find icon relative to this file
+                icon_source = Path(__file__).parent.parent / 'assets' / 'souleyez-icon.png'
+                with open(icon_source, 'rb') as src:
+                    icon_data = src.read()
+
+            with open(icon_dest, 'wb') as dst:
+                dst.write(icon_data)
+        except Exception:
+            icon_dest = "utilities-terminal"  # Fallback to system icon
+
+        # Create .desktop file
+        desktop_content = f"""[Desktop Entry]
+Name=SoulEyez
+Comment=AI-Powered Penetration Testing Platform
+Exec=souleyez interactive
+Icon={icon_dest}
+Terminal=true
+Type=Application
+Categories=Security;System;Network;
+Keywords=pentest;security;hacking;nmap;metasploit;
+"""
+
+        desktop_file.write_text(desktop_content)
+
+        # Update desktop database (optional)
+        try:
+            subprocess.run(['update-desktop-database', str(applications_dir)],
+                          capture_output=True, check=False, timeout=5)
+        except Exception:
+            pass
+
+        click.echo(f"  {click.style('✓', fg='green')} Desktop shortcut: Added to Applications menu")
+
+    except Exception:
+        # Silently ignore errors - desktop shortcut is nice-to-have
+        pass
+
+
 def _run_tool_installs(
     missing_tools: List[Dict],
     wrong_version_tools: List[Dict],
@@ -834,14 +902,16 @@ def _install_ollama() -> bool:
 
     click.echo()
     click.echo("  Installing Ollama...")
-    click.echo("  " + click.style("(This may take a minute)", fg='bright_black'))
+    click.echo("  " + click.style("(This may take a minute - downloading ~100MB)", fg='bright_black'))
     click.echo()
 
     try:
-        # Run the official Ollama install script - let it output directly to terminal
+        # Run the official Ollama install script with timeout
+        # Add curl timeouts to fail faster on network issues
         result = subprocess.run(
-            ['bash', '-c', 'curl -fsSL https://ollama.ai/install.sh | sh'],
-            check=False
+            ['bash', '-c', 'curl --connect-timeout 30 --max-time 300 -fsSL https://ollama.ai/install.sh | sh'],
+            check=False,
+            timeout=360  # 6 minute total timeout
         )
 
         if result.returncode == 0:
@@ -853,10 +923,25 @@ def _install_ollama() -> bool:
         else:
             click.echo()
             click.echo("  " + click.style("✗ Installation failed", fg='red'))
-            click.echo("  You can install manually from https://ollama.ai")
+            click.echo("  " + click.style("This is usually a network issue (slow connection or timeout).", fg='yellow'))
+            click.echo()
+            click.echo("  To install manually:")
+            click.echo("    curl -fsSL https://ollama.ai/install.sh | sh")
+            click.echo()
+            click.echo("  Or visit: https://ollama.ai")
             click.pause("  Press any key to continue...")
             return False
 
+    except subprocess.TimeoutExpired:
+        click.echo()
+        click.echo("  " + click.style("✗ Installation timed out", fg='red'))
+        click.echo("  " + click.style("The download took too long. Check your internet connection.", fg='yellow'))
+        click.echo()
+        click.echo("  To install manually:")
+        click.echo("    curl -fsSL https://ollama.ai/install.sh | sh")
+        click.pause("  Press any key to continue...")
+        return False
+
     except Exception as e:
         click.echo()
         click.echo(click.style(f"  ✗ Error: {e}", fg='red'))
@@ -1089,6 +1174,9 @@ def _wizard_summary(encryption_enabled, engagement_info, tool_status, ai_enabled
     click.echo("  " + click.style("You're ready to start!", bold=True, fg='cyan'))
     click.echo()
 
+    # Install desktop shortcut automatically
+    _install_desktop_shortcut()
+
     # Prompt for interactive tutorial
     click.echo("  ┌" + "─" * 56 + "┐")
     click.echo("  │" + click.style(" Would you like to run the interactive tutorial?", fg='cyan').center(65) + "│")

souleyez/ui/tool_setup.py

@@ -82,32 +82,38 @@ def _ensure_path_configured():
         os.environ["PATH"] = ":".join(new_paths) + ":" + current_path
 
 
-def _add_paths_to_bashrc():
-    """Add tool paths to ~/.bashrc if not already present."""
-    bashrc = Path.home() / ".bashrc"
+def _add_paths_to_shell_rc():
+    """Add tool paths to shell rc files (bash and zsh) if not already present."""
     paths_to_add = [
         ('export PATH="$HOME/go/bin:$PATH"', "go/bin"),
         ('export PATH="$HOME/.local/bin:$PATH"', ".local/bin"),
     ]
 
-    if not bashrc.exists():
-        return
+    # Update both .bashrc and .zshrc (Kali Linux uses zsh by default)
+    rc_files = [
+        Path.home() / ".bashrc",
+        Path.home() / ".zshrc",
+    ]
 
-    try:
-        content = bashrc.read_text()
-        additions = []
-
-        for line, marker in paths_to_add:
-            if marker not in content:
-                additions.append(line)
-
-        if additions:
-            with open(bashrc, "a") as f:
-                f.write("\n# Added by souleyez setup\n")
-                for line in additions:
-                    f.write(line + "\n")
-    except Exception:
-        pass  # Don't fail on PATH configuration issues
+    for rc_file in rc_files:
+        if not rc_file.exists():
+            continue
+
+        try:
+            content = rc_file.read_text()
+            additions = []
+
+            for line, marker in paths_to_add:
+                if marker not in content:
+                    additions.append(line)
+
+            if additions:
+                with open(rc_file, "a") as f:
+                    f.write("\n# Added by souleyez setup\n")
+                    for line in additions:
+                        f.write(line + "\n")
+        except Exception:
+            pass  # Don't fail on PATH configuration issues
 
 
 def _run_command(cmd: str, console, description: str = "", capture: bool = False) -> tuple:
@@ -319,15 +325,16 @@ def _ensure_msfdb_initialized(console):
 
     if not click.confirm("  Initialize MSF database now?", default=True):
         console.print()
-        console.print("  [yellow]Skipped.[/yellow] Run 'msfdb init' manually when needed.")
+        console.print("  [yellow]Skipped.[/yellow] Run 'sudo msfdb init' manually when needed.")
         return
 
     console.print()
     console.print("  [dim]Initializing MSF database (this may take a minute)...[/dim]")
 
     try:
+        # Use sudo for msfdb init (required on Kali and some other distros)
         result = subprocess.run(
-            [msfdb_path, 'init'],
+            ['sudo', msfdb_path, 'init'],
             capture_output=True,
             timeout=300  # 5 minute timeout
         )
@@ -392,32 +399,12 @@ def run_tool_setup(check_only: bool = False, install_all: bool = False):
     console.print(f"  Detected OS: [bold]{distro_names.get(distro, distro)}[/bold]")
     console.print()
 
+    # Show distro-specific messaging
     if distro in ('kali', 'parrot'):
         console.print("  [green]✓ You're on a pentesting distro![/green]")
-        console.print("    All tools should be available via apt install.")
+        console.print("    Most tools are available via apt. Some may use pipx or direct download.")
         console.print()
-        _show_tool_status(console)
-
-        if check_only:
-            return
-
-        missing = get_missing_tools(distro)
-        if missing:
-            console.print()
-            if install_all or click.confirm("  Install missing tools via apt?", default=True):
-                _install_apt_tools(console, missing)
-        else:
-            console.print("  [green]✓ All tools are installed![/green]")
-
-        # Configure sudoers for privileged scans
-        _configure_sudoers(console)
-
-        # Initialize MSF database if needed
-        _ensure_msfdb_initialized(console)
-        return
-
-    # Ubuntu/Debian path
-    if distro in ('ubuntu', 'debian'):
+    elif distro in ('ubuntu', 'debian'):
         console.print("  [yellow]Note:[/yellow] Some pentesting tools aren't in Ubuntu/Debian repos.")
         console.print("  This wizard will install them using pipx, go, snap, or from source.")
         console.print()
@@ -431,6 +418,8 @@ def run_tool_setup(check_only: bool = False, install_all: bool = False):
     if not missing:
         console.print()
         console.print("  [green]✓ All tools are installed![/green]")
+        # Still need to run post-install tasks (sudoers, MSF db, etc.)
+        _run_post_install_tasks(console, distro)
         return
 
     console.print()
@@ -528,8 +517,8 @@ def run_tool_setup(check_only: bool = False, install_all: bool = False):
             else:
                 failed_tools.append(tool['name'])
 
-    # Configure PATH in bashrc
-    _add_paths_to_bashrc()
+    # Configure PATH in shell rc files (bash and zsh)
+    _add_paths_to_shell_rc()
 
     # Final status
     console.print()
@@ -547,6 +536,15 @@ def run_tool_setup(check_only: bool = False, install_all: bool = False):
     _ensure_path_configured()
     _show_tool_status(console)
 
+    # Run post-install tasks
+    _run_post_install_tasks(console, distro)
+
+
+def _run_post_install_tasks(console, distro: str):
+    """Run tasks that should happen after tool installation or when all tools are present."""
+    # Ensure PATH is configured in shell rc files
+    _add_paths_to_shell_rc()
+
     # Configure passwordless sudo for privileged scans
     _configure_sudoers(console)
 
@@ -554,12 +552,14 @@ def run_tool_setup(check_only: bool = False, install_all: bool = False):
     _ensure_msfdb_initialized(console)
 
     # Remind about PATH for pipx/go tools
-    if distro in ('ubuntu', 'debian'):
-        console.print()
-        console.print("  [yellow]Important:[/yellow] To use newly installed tools, either:")
-        console.print("    1. Restart your terminal, OR")
+    console.print()
+    console.print("  [yellow]Important:[/yellow] To use newly installed tools, either:")
+    console.print("    1. Restart your terminal, OR")
+    if distro in ('kali', 'parrot'):
+        console.print("    2. Run: [cyan]source ~/.zshrc[/cyan]  (Kali uses zsh)")
+    else:
         console.print("    2. Run: [cyan]source ~/.bashrc[/cyan]")
-        console.print()
+    console.print()
 
 
 def _show_tool_status(console):

souleyez/utils/tool_checker.py

@@ -223,9 +223,9 @@ EXTERNAL_TOOLS = {
         },
         'dalfox': {
             'command': 'dalfox',
-            'install_kali': 'ARCH=$(uname -m | sed "s/x86_64/amd64/;s/aarch64/arm64/") && wget -q https://github.com/hahwul/dalfox/releases/download/v2.12.0/dalfox-linux-${ARCH}.tar.gz -O /tmp/dalfox.tar.gz && tar -xzf /tmp/dalfox.tar.gz -C /tmp && sudo mv /tmp/dalfox-linux-${ARCH} /usr/local/bin/dalfox && sudo chmod +x /usr/local/bin/dalfox && rm /tmp/dalfox.tar.gz',
-            'install_ubuntu': 'ARCH=$(uname -m | sed "s/x86_64/amd64/;s/aarch64/arm64/") && wget -q https://github.com/hahwul/dalfox/releases/download/v2.12.0/dalfox-linux-${ARCH}.tar.gz -O /tmp/dalfox.tar.gz && tar -xzf /tmp/dalfox.tar.gz -C /tmp && sudo mv /tmp/dalfox-linux-${ARCH} /usr/local/bin/dalfox && sudo chmod +x /usr/local/bin/dalfox && rm /tmp/dalfox.tar.gz',
-            'install_method': 'kali_only',
+            'install_kali': 'go install github.com/hahwul/dalfox/v2@latest',
+            'install_ubuntu': 'go install github.com/hahwul/dalfox/v2@latest',
+            'install_method': 'go',
             'description': 'XSS vulnerability scanner'
         },
     },
@@ -721,6 +721,7 @@ def check_msfdb_status() -> Dict[str, any]:
         - message: str - Human-readable status message
     """
     import subprocess
+    from pathlib import Path
 
     result = {
         'initialized': False,
@@ -734,6 +735,32 @@ def check_msfdb_status() -> Dict[str, any]:
         result['message'] = 'msfdb command not found - Metasploit may not be installed'
         return result
 
+    # Helper to check if PostgreSQL is running
+    def check_postgresql_running() -> bool:
+        try:
+            proc = subprocess.run(
+                ['systemctl', 'is-active', 'postgresql'],
+                capture_output=True,
+                text=True,
+                timeout=5
+            )
+            return proc.returncode == 0 and 'active' in proc.stdout.lower()
+        except Exception:
+            return False
+
+    # Helper to check system-wide MSF database config (Kali fallback)
+    def check_system_config() -> bool:
+        """Check if system-wide database.yml exists with valid PostgreSQL config."""
+        config_path = Path('/usr/share/metasploit-framework/config/database.yml')
+        if config_path.exists():
+            try:
+                content = config_path.read_text()
+                # Check for PostgreSQL adapter configuration
+                return 'adapter: postgresql' in content and 'database: msf' in content
+            except Exception:
+                return False
+        return False
+
     try:
         # Run msfdb status
         proc = subprocess.run(
@@ -743,10 +770,23 @@ def check_msfdb_status() -> Dict[str, any]:
             timeout=10
         )
         output = proc.stdout + proc.stderr
-
-        # Parse output for status indicators
         output_lower = output.lower()
 
+        # Check if msfdb requires root (common on Kali)
+        if 'run as root' in output_lower or (proc.returncode != 0 and 'error' in output_lower):
+            # Fall back to checking system config file and PostgreSQL status
+            result['running'] = check_postgresql_running()
+            if check_system_config():
+                result['initialized'] = True
+                if result['running']:
+                    result['connected'] = True
+                    result['message'] = 'Database initialized and running'
+                else:
+                    result['message'] = 'Database initialized but PostgreSQL not running - run: sudo systemctl start postgresql'
+            else:
+                result['message'] = 'Need sudo to verify - run: sudo msfdb status'
+            return result
+
         # Check if database is initialized
         if 'no database' in output_lower or 'not initialized' in output_lower:
             result['message'] = 'Database not initialized - run: msfdb init'

{souleyez-2.22.0.dist-info → souleyez-2.26.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: souleyez
-Version: 2.22.0
+Version: 2.26.0
 Summary: AI-Powered Penetration Testing Platform with 40+ integrated tools
 Author-email: CyberSoul Security <contact@cybersoulsecurity.com>
 Maintainer-email: CyberSoul Security <contact@cybersoulsecurity.com>
@@ -72,7 +72,7 @@ Welcome to the SoulEyez beta! Thank you for helping us test and improve this pen
 
 > ⚠️ **Important**: Only use SoulEyez on systems you have explicit authorization to test.
 
-## Version: 2.22.0
+## Version: 2.26.0
 
 ### What's Included
 
@@ -110,6 +110,17 @@ Welcome to the SoulEyez beta! Thank you for helping us test and improve this pen
 - **Python**: 3.8 or newer
 - **Storage**: ~500MB for SoulEyez + tools
 
+> **🐉 Kali Linux Recommended**
+>
+> SoulEyez performs significantly better on **Kali Linux** than other distributions:
+> - All pentesting tools pre-installed and optimized
+> - Metasploit database and RPC already configured
+> - Security-focused kernel and networking stack
+> - No dependency hunting or version conflicts
+> - Wordlists, databases, and tool configs ready to go
+>
+> While Ubuntu and other Debian-based distros are supported, you may experience slower setup times and occasional tool compatibility issues.
+
 ### Known Issues
 
 - Very large scan outputs (>10MB) may slow the interface
@@ -127,6 +138,8 @@ pipx ensurepath          # Add pipx apps to your PATH
 source ~/.bashrc         # Reload your shell (or close and reopen terminal)
 ```
 
+> **Kali Linux users:** Kali uses zsh by default. Use `source ~/.zshrc` instead of `source ~/.bashrc`
+
 > 💡 **What's pipx?** It's like `apt` but for Python command-line tools. It keeps each tool isolated so they don't conflict with each other.
 
 ### Step 2: Install SoulEyez
@@ -297,4 +310,4 @@ Happy hacking! 🛡️
 
 ---
 
-**Version**: 2.22.0 | **Release Date**: January 2026 | **Maintainer**: CyberSoul Security
+**Version**: 2.24.0 | **Release Date**: January 2026 | **Maintainer**: CyberSoul Security