linux-desktop-manager 1.0.0__py3-none-any.whl

linux_desktop_manager/__init__.py

@@ -0,0 +1,29 @@
+"""
+Linux Desktop Manager by Shashan Lumbhani.
+All-In-One Linux Desktop Environment & Remote Ingress Orchestrator.
+"""
+
+from .server_env import ServerEnv
+from .desktop_env import DesktopEnvManager
+from .remote_services import RemoteServiceManager
+from .tunnels import TunnelManager
+from .users import UserManager
+from .firewall import FirewallManager
+from .interactive import run_interactive_menu
+from .cli import main
+
+__version__ = "1.0.0"
+__author__ = "Shashan Lumbhani"
+__license__ = "MIT"
+
+__all__ = [
+    "ServerEnv",
+    "DesktopEnvManager",
+    "RemoteServiceManager",
+    "TunnelManager",
+    "UserManager",
+    "FirewallManager",
+    "run_interactive_menu",
+    "main",
+    "__version__"
+]

linux_desktop_manager/__main__.py

@@ -0,0 +1,7 @@
+"""
+Executable module entry point for `python3 -m linux_desktop_manager`.
+"""
+from linux_desktop_manager.cli import main
+
+if __name__ == "__main__":
+    main()

linux_desktop_manager/cli.py

@@ -0,0 +1,216 @@
+"""
+Command-Line Interface (CLI) entry point for linux-desktop-manager.
+"""
+
+from __future__ import annotations
+
+import os
+import shutil
+import argparse
+import sys
+from .formatting import console, print_banner, print_services_table, print_desktops_table, print_connection_card
+from .server_env import ServerEnv
+from .desktop_env import DesktopEnvManager
+from .remote_services import RemoteServiceManager
+from .tunnels import TunnelManager
+from .firewall import FirewallManager
+from .users import UserManager
+from .interactive import run_interactive_menu
+
+
+def ensure_system_symlinks() -> None:
+    """Ensure /usr/local/bin/ldm and /usr/local/bin/linux-desktop-manager wrappers exist so 'sudo ldm' works directly."""
+    if os.geteuid() != 0:
+        return
+
+    wrapper_content = f"""#!/usr/bin/env bash
+# Auto-generated by Linux Desktop Manager Orchestrator
+# Preserves user site-packages and editable installs when running under sudo.
+if [ -n "$SUDO_USER" ] && [ "$SUDO_USER" != "root" ]; then
+    USER_HOME=$(getent passwd "$SUDO_USER" 2>/dev/null | cut -d: -f6)
+    [ -z "$USER_HOME" ] && USER_HOME="/home/$SUDO_USER"
+    for pdir in "$USER_HOME"/.local/lib/python*/site-packages; do
+        if [ -d "$pdir" ]; then
+            export PYTHONPATH="$pdir:$PYTHONPATH"
+            for pth in "$pdir"/*.pth; do
+                if [ -f "$pth" ]; then
+                    while IFS= read -r line || [ -n "$line" ]; do
+                        [[ "$line" =~ ^[#] ]] && continue
+                        [ -d "$line" ] && export PYTHONPATH="$line:$PYTHONPATH"
+                    done < "$pth"
+                fi
+            done
+        fi
+    done
+fi
+
+exec {sys.executable} -m linux_desktop_manager "$@"
+"""
+
+    for name in ["ldm", "linux-desktop-manager"]:
+        usr_bin_target = f"/usr/local/bin/{name}"
+        try:
+            needs_write = True
+            if os.path.exists(usr_bin_target) and not os.path.islink(usr_bin_target):
+                try:
+                    with open(usr_bin_target, "r") as f:
+                        content = f.read()
+                        if "linux_desktop_manager" in content and "pth" in content:
+                            needs_write = False
+                except Exception:
+                    pass
+
+            if needs_write:
+                if os.path.islink(usr_bin_target) or os.path.exists(usr_bin_target):
+                    os.remove(usr_bin_target)
+                with open(usr_bin_target, "w") as f:
+                    f.write(wrapper_content)
+                os.chmod(usr_bin_target, 0o755)
+        except Exception:
+            pass
+
+
+def check_elevation() -> None:
+    """Auto-elevates with sudo preserving user site-packages and editable paths if not root."""
+    if any(arg in sys.argv for arg in ["-h", "--help"]):
+        return
+
+    # If already root, ensure system wrappers exist in /usr/local/bin
+    if os.geteuid() == 0:
+        ensure_system_symlinks()
+        return
+
+    # Non-root user: Auto-elevate via sudo preserving all non-system sys.path entries
+    if shutil.which("sudo"):
+        console.print("[dim cyan]⚡ Elevated privileges required. Elevating with sudo...[/dim cyan]")
+        try:
+            user_paths = [p for p in sys.path if p and not p.startswith("/usr/lib") and os.path.isdir(p)]
+            pythonpath = ":".join(user_paths) if user_paths else ""
+
+            cmd = ["sudo", "env"]
+            if pythonpath:
+                cmd.append(f"PYTHONPATH={pythonpath}")
+            cmd.extend([sys.executable, "-m", "linux_desktop_manager"] + sys.argv[1:])
+
+            os.execvp("sudo", cmd)
+        except Exception as e:
+            console.print(f"[bold red]Elevation failed: {e}. Please run with sudo.[/bold red]")
+            sys.exit(1)
+    else:
+        console.print("[bold red]Root privileges are required to manage desktop environments and services.[/bold red]")
+        sys.exit(1)
+
+
+def main() -> None:
+    check_elevation()
+    parser = argparse.ArgumentParser(
+        prog="linux-desktop-manager",
+        description="⚡ Linux Desktop Environment & Remote Access Manager (CLI & Interactive TUI)",
+        epilog="""
+Examples:
+  sudo linux-desktop-manager                 # Launch full interactive Arrow-Key TUI menu
+  sudo linux-desktop-manager --status        # View current status of services and ports
+  sudo linux-desktop-manager --install-de xfce4
+  sudo linux-desktop-manager --start xrdp
+  sudo linux-desktop-manager --tunnel cf     # Expose Browser Desktop via TunnelMate
+        """
+    )
+    parser.add_argument("--tui", action="store_true", help="Launch interactive Arrow-Key TUI menu (default if no flags)")
+    parser.add_argument("--status", action="store_true", help="Print live service, desktop, and port status table")
+    parser.add_argument("--install-wizard", action="store_true", help="Launch step-by-step installation wizard")
+    parser.add_argument("--install-de", metavar="NAME", help="Install a desktop environment (e.g. xfce4, plasma, i3, gnome)")
+    parser.add_argument("--uninstall-de", metavar="NAME", help="Uninstall a desktop environment")
+    parser.add_argument("--set-de", metavar="NAME", help="Set default desktop session for target user")
+    parser.add_argument("--start", metavar="SERVICE", help="Start service (xrdp, openssh, tigervnc, novnc, x2go, cockpit)")
+    parser.add_argument("--stop", metavar="SERVICE", help="Stop service")
+    parser.add_argument("--restart", metavar="SERVICE", help="Restart service")
+    parser.add_argument("--install-service", metavar="SERVICE", help="Install and configure service")
+    parser.add_argument("--uninstall-service", metavar="SERVICE", help="Uninstall service")
+    parser.add_argument("--tunnel", choices=["cf", "rdp", "stop"], help="Manage public tunnels: cf (browser), rdp (TunnelMate TCP RDP), stop")
+    parser.add_argument("--allow-ports", action="store_true", help="Allow all remote desktop ports in firewall")
+    parser.add_argument("--purge-all", action="store_true", help="Purge all remote desktop services and configs")
+    parser.add_argument("--user", metavar="USERNAME", help="Specify target user (default: current/sudo user)")
+
+    args = parser.parse_args()
+
+    # If no flags passed or --tui, run the interactive arrow-key TUI menu
+    if len(sys.argv) == 1 or args.tui or args.install_wizard:
+        run_interactive_menu()
+        return
+
+    # CLI automated actions
+    server_env = ServerEnv()
+    desktop_mgr = DesktopEnvManager(server_env)
+    service_mgr = RemoteServiceManager(server_env)
+    tunnel_mgr = TunnelManager()
+    firewall_mgr = FirewallManager()
+    target_user = args.user or server_env.get_invoking_user()
+
+    if args.status:
+        print_banner()
+        print_services_table(service_mgr.get_all_services_status())
+        cf_url = tunnel_mgr.get_cloudflare_url()
+        rdp_tcp_url = tunnel_mgr.get_rdp_tcp_url()
+        local_ips = server_env.get_local_ips()
+        pub_ip = server_env.get_public_ip()
+        active_de = desktop_mgr.get_active_session(target_user) or "None"
+        print_connection_card(
+            user=target_user,
+            de_name=active_de,
+            local_ip=local_ips[0] if local_ips else "127.0.0.1",
+            public_ip=pub_ip,
+            cf_url=cf_url,
+            rdp_tcp_url=rdp_tcp_url
+        )
+    elif args.install_de:
+        console.print(f"[bold cyan]Installing desktop environment: {args.install_de}...[/bold cyan]")
+        desktop_mgr.install_desktop(args.install_de, target_user, set_as_default=True, live_callback=console.print)
+    elif args.uninstall_de:
+        console.print(f"[bold red]Uninstalling desktop environment: {args.uninstall_de}...[/bold red]")
+        desktop_mgr.uninstall_desktop(args.uninstall_de, live_callback=console.print)
+    elif args.set_de:
+        if desktop_mgr.set_default_session(args.set_de, target_user):
+            console.print(f"[bold green]✔ Default session for '{target_user}' set to {args.set_de}.[/bold green]")
+        else:
+            console.print("[bold red]Failed to set session.[/bold red]")
+    elif args.start:
+        service_mgr.start_service(args.start, target_user=target_user)
+        console.print(f"[bold green]✔ Started {args.start}.[/bold green]")
+    elif args.stop:
+        service_mgr.stop_service(args.stop)
+        console.print(f"[bold yellow]Stopped {args.stop}.[/bold yellow]")
+    elif args.restart:
+        service_mgr.restart_service(args.restart, target_user=target_user)
+        console.print(f"[bold green]✔ Restarted {args.restart}.[/bold green]")
+    elif args.install_service:
+        console.print(f"[bold cyan]Installing remote service: {args.install_service}...[/bold cyan]")
+        service_mgr.install_service(args.install_service, target_user=target_user, live_callback=console.print)
+    elif args.uninstall_service:
+        service_mgr.uninstall_service(args.uninstall_service, purge_configs=True, live_callback=console.print)
+    elif args.tunnel:
+        if args.tunnel == "cf":
+            url = tunnel_mgr.start_cloudflare_tunnel(port=6080, live_callback=console.print)
+            if url:
+                console.print(f"[bold green]✔ Cloudflare Browser URL: {url}/vnc.html[/bold green]")
+        elif args.tunnel == "rdp":
+            url = tunnel_mgr.start_rdp_tcp_tunnel(port=3389, live_callback=console.print)
+            if url:
+                clean_host = url.replace("https://", "").replace("http://", "").strip("/")
+                console.print(f"[bold green]✔ TunnelMate Cloudflare TCP RDP Assigned: {url}[/bold green]")
+                console.print(f"[dim cyan]Client Command: cloudflared access rdp --hostname {clean_host} --url localhost:3389[/dim cyan]")
+                console.print(f"[dim]Then open Windows mstsc to: localhost:3389[/dim]")
+        elif args.tunnel == "stop":
+            tunnel_mgr.stop_all_tunnels()
+            console.print("[yellow]All tunnels stopped.[/yellow]")
+    elif args.allow_ports:
+        firewall_mgr.allow_all_remote_ports()
+        console.print("[bold green]✔ All remote desktop ports allowed in firewall.[/bold green]")
+    elif args.purge_all:
+        for sid in ["novnc", "tigervnc", "xrdp", "x2go", "cockpit"]:
+            service_mgr.uninstall_service(sid, purge_configs=True, live_callback=console.print)
+        tunnel_mgr.stop_all_tunnels()
+        console.print("[bold green]✔ Clean wipe completed.[/bold green]")
+
+
+if __name__ == "__main__":
+    main()

linux_desktop_manager/desktop_env.py

@@ -0,0 +1,420 @@
+"""
+Desktop Environment and Window Manager Manager for Linux.
+Supports 14 full desktop environments and lightweight tiling/floating window managers.
+Handles installation, uninstallation, active session switching, and ~/.xsession configuration.
+"""
+
+import os
+import shutil
+import subprocess
+from typing import Dict, List, Optional, Callable
+from .server_env import ServerEnv
+
+class DesktopEnvManager:
+    """Manages 14 Linux Desktop Environments and Window Managers across multiple distributions."""
+
+    DESKTOPS = {
+        "xfce4": {
+            "name": "XFCE4",
+            "category": "Full Desktop",
+            "recommended": True,
+            "cpu": "1 Core (1.0+ GHz)",
+            "ram": "~400MB",
+            "desc": "Fast, lightweight, rock-solid stability over remote RDP & VNC",
+            "session_bin": "startxfce4",
+            "session_cmd": "startxfce4",
+            "xsession_rc": "export XDG_SESSION_DESKTOP=xfce\nexport XDG_CURRENT_DESKTOP=XFCE",
+            "pkgs": {
+                "apt": ["xfce4", "xfce4-goodies", "xfce4-terminal", "dbus-x11"],
+                "dnf": ["@xfce-desktop-environment", "xfce4-session", "xfce4-panel", "xfce4-terminal"],
+                "pacman": ["xfce4", "xfce4-goodies"],
+                "zypper": ["xfce4-session", "xfce4-panel", "xfce4-terminal"],
+                "apk": ["xfce4", "xfce4-terminal"]
+            }
+        },
+        "plasma": {
+            "name": "KDE Plasma",
+            "category": "Full Desktop",
+            "recommended": False,
+            "cpu": "2+ Cores (2.0+ GHz)",
+            "ram": "~700MB",
+            "desc": "Modern, sleek, Windows-like layout with deep customization",
+            "session_bin": "startplasma-x11",
+            "session_cmd": "startplasma-x11",
+            "xsession_rc": "export XDG_SESSION_DESKTOP=KDE\nexport DESKTOP_SESSION=plasma",
+            "pkgs": {
+                "apt": ["kde-plasma-desktop", "plasma-workspace-x11", "konsole"],
+                "dnf": ["plasma-workspace-x11", "konsole"],
+                "pacman": ["plasma-meta", "plasma-x11-session", "konsole"],
+                "zypper": ["plasma5-session"],
+                "apk": ["plasma-desktop", "konsole"]
+            }
+        },
+        "gnome": {
+            "name": "GNOME Shell",
+            "category": "Full Desktop",
+            "recommended": False,
+            "cpu": "2+ Cores (2.0+ GHz)",
+            "ram": "~900MB",
+            "desc": "Default Ubuntu/Fedora workstation desktop, modern & feature-complete",
+            "session_bin": "gnome-session",
+            "session_cmd": "gnome-session",
+            "xsession_rc": "export XDG_SESSION_TYPE=x11\nexport XDG_CURRENT_DESKTOP=GNOME\nexport GNOME_SHELL_SESSION_MODE=ubuntu",
+            "pkgs": {
+                "apt": ["gnome-core", "gnome-session", "gnome-terminal"],
+                "dnf": ["gnome-shell", "gnome-session", "gnome-terminal"],
+                "pacman": ["gnome", "gnome-extra"],
+                "zypper": ["gnome-session", "gnome-terminal"],
+                "apk": ["gnome", "gnome-terminal"]
+            }
+        },
+        "mate": {
+            "name": "MATE",
+            "category": "Full Desktop",
+            "recommended": False,
+            "cpu": "1 Core (1.2+ GHz)",
+            "ram": "~450MB",
+            "desc": "Classic GNOME 2 layout, traditional and very responsive over RDP",
+            "session_bin": "mate-session",
+            "session_cmd": "mate-session",
+            "xsession_rc": "export XDG_SESSION_DESKTOP=mate\nexport XDG_CURRENT_DESKTOP=MATE",
+            "pkgs": {
+                "apt": ["mate-desktop-environment", "mate-desktop-environment-extras"],
+                "dnf": ["@mate-desktop"],
+                "pacman": ["mate", "mate-extra"],
+                "zypper": ["mate-session"],
+                "apk": ["mate-desktop-environment"]
+            }
+        },
+        "cinnamon": {
+            "name": "Cinnamon",
+            "category": "Full Desktop",
+            "recommended": False,
+            "cpu": "2 Cores (1.5+ GHz)",
+            "ram": "~600MB",
+            "desc": "Linux Mint flagship desktop, polished Windows 7/10 feel",
+            "session_bin": "cinnamon-session",
+            "session_cmd": "cinnamon-session",
+            "xsession_rc": "export XDG_SESSION_DESKTOP=cinnamon\nexport XDG_CURRENT_DESKTOP=X-Cinnamon",
+            "pkgs": {
+                "apt": ["cinnamon-desktop-environment"],
+                "dnf": ["@cinnamon-desktop", "cinnamon"],
+                "pacman": ["cinnamon", "nemo-fileroller", "gnome-terminal"],
+                "zypper": ["cinnamon"],
+                "apk": ["cinnamon"]
+            }
+        },
+        "lxqt": {
+            "name": "LXQt",
+            "category": "Full Desktop",
+            "recommended": False,
+            "cpu": "1 Core (800+ MHz)",
+            "ram": "~300MB",
+            "desc": "Lightweight Qt-based desktop, ideal for low-RAM cloud VMs",
+            "session_bin": "startlxqt",
+            "session_cmd": "startlxqt",
+            "xsession_rc": "export XDG_SESSION_DESKTOP=LXQt\nexport XDG_CURRENT_DESKTOP=LXQt",
+            "pkgs": {
+                "apt": ["lxqt", "openbox", "qterminal"],
+                "dnf": ["@lxqt-desktop", "lxqt-session", "openbox"],
+                "pacman": ["lxqt", "openbox", "breeze-icons", "qterminal"],
+                "zypper": ["lxqt-session", "openbox"],
+                "apk": ["lxqt-desktop", "openbox"]
+            }
+        },
+        "lxde": {
+            "name": "LXDE",
+            "category": "Full Desktop",
+            "recommended": False,
+            "cpu": "1 Core (600+ MHz)",
+            "ram": "~250MB",
+            "desc": "Classic GTK lightweight desktop, minimal overhead",
+            "session_bin": "startlxde",
+            "session_cmd": "startlxde",
+            "xsession_rc": "export XDG_SESSION_DESKTOP=LXDE\nexport XDG_CURRENT_DESKTOP=LXDE",
+            "pkgs": {
+                "apt": ["lxde"],
+                "dnf": ["@lxde-desktop"],
+                "pacman": ["lxde"],
+                "zypper": ["lxde-common"],
+                "apk": ["lxde"]
+            }
+        },
+        "budgie": {
+            "name": "Budgie",
+            "category": "Full Desktop",
+            "recommended": False,
+            "cpu": "1-2 Cores (1.5+ GHz)",
+            "ram": "~550MB",
+            "desc": "Sleek modern desktop with Raven notification sidebar",
+            "session_bin": "budgie-desktop",
+            "session_cmd": "budgie-desktop",
+            "xsession_rc": "export XDG_CURRENT_DESKTOP=Budgie:GNOME",
+            "pkgs": {
+                "apt": ["budgie-desktop", "gnome-terminal"],
+                "dnf": ["budgie-desktop", "gnome-terminal"],
+                "pacman": ["budgie-desktop", "gnome-terminal", "nemo"],
+                "zypper": ["budgie-desktop"],
+                "apk": ["budgie-desktop"]
+            }
+        },
+        "deepin": {
+            "name": "Deepin (DDE)",
+            "category": "Full Desktop",
+            "recommended": False,
+            "cpu": "2+ Cores (2.0+ GHz)",
+            "ram": "~800MB",
+            "desc": "Elegant macOS-style interface with fluid dock and blur effects",
+            "session_bin": "startdde",
+            "session_cmd": "startdde",
+            "xsession_rc": "export XDG_CURRENT_DESKTOP=Deepin",
+            "pkgs": {
+                "apt": ["ubuntudde-dde", "startdde", "deepin-terminal"],
+                "dnf": ["deepin-desktop"],
+                "pacman": ["deepin", "deepin-extra"],
+                "zypper": ["deepin-session-ui"],
+                "apk": ["deepin-desktop"]
+            }
+        },
+        "enlightenment": {
+            "name": "Enlightenment",
+            "category": "Full Desktop",
+            "recommended": False,
+            "cpu": "1 Core (1.0+ GHz)",
+            "ram": "~300MB",
+            "desc": "Fast compositing desktop with modular gadgets and low memory footprint",
+            "session_bin": "enlightenment_start",
+            "session_cmd": "enlightenment_start",
+            "xsession_rc": "export XDG_CURRENT_DESKTOP=Enlightenment",
+            "pkgs": {
+                "apt": ["enlightenment", "terminology"],
+                "dnf": ["enlightenment", "terminology"],
+                "pacman": ["enlightenment", "terminology"],
+                "zypper": ["enlightenment"],
+                "apk": ["enlightenment"]
+            }
+        },
+        "i3": {
+            "name": "i3wm",
+            "category": "Tiling WM",
+            "recommended": False,
+            "cpu": "1 Core (500+ MHz)",
+            "ram": "~150MB",
+            "desc": "Keyboard-driven tiling window manager for power users and programmers",
+            "session_bin": "i3",
+            "session_cmd": "i3",
+            "xsession_rc": "export XDG_SESSION_DESKTOP=i3",
+            "pkgs": {
+                "apt": ["i3", "i3status", "dmenu", "rxvt-unicode", "xterm"],
+                "dnf": ["i3", "i3status", "dmenu", "rxvt-unicode", "xterm"],
+                "pacman": ["i3-wm", "i3status", "dmenu", "rxvt-unicode", "xterm"],
+                "zypper": ["i3", "i3status", "dmenu", "xterm"],
+                "apk": ["i3wm", "i3status", "dmenu", "xterm"]
+            }
+        },
+        "openbox": {
+            "name": "Openbox",
+            "category": "Floating WM",
+            "recommended": False,
+            "cpu": "1 Core (500+ MHz)",
+            "ram": "~120MB",
+            "desc": "Ultra-lightweight floating window manager, highly extensible",
+            "session_bin": "openbox-session",
+            "session_cmd": "openbox-session",
+            "xsession_rc": "export XDG_SESSION_DESKTOP=openbox",
+            "pkgs": {
+                "apt": ["openbox", "obconf", "tint2", "pcmanfm", "xterm"],
+                "dnf": ["openbox", "obconf", "tint2", "pcmanfm", "xterm"],
+                "pacman": ["openbox", "obconf", "tint2", "pcmanfm", "xterm"],
+                "zypper": ["openbox", "tint2", "pcmanfm", "xterm"],
+                "apk": ["openbox", "tint2", "pcmanfm", "xterm"]
+            }
+        },
+        "icewm": {
+            "name": "IceWM",
+            "category": "Lightweight WM",
+            "recommended": False,
+            "cpu": "1 Core (400+ MHz)",
+            "ram": "~100MB",
+            "desc": "Classic Windows 95 look, blazing fast with minimal CPU/RAM",
+            "session_bin": "icewm-session",
+            "session_cmd": "icewm-session",
+            "xsession_rc": "export XDG_SESSION_DESKTOP=icewm",
+            "pkgs": {
+                "apt": ["icewm", "xterm", "pcmanfm"],
+                "dnf": ["icewm", "xterm", "pcmanfm"],
+                "pacman": ["icewm", "xterm", "pcmanfm"],
+                "zypper": ["icewm", "xterm", "pcmanfm"],
+                "apk": ["icewm", "xterm", "pcmanfm"]
+            }
+        },
+        "fluxbox": {
+            "name": "Fluxbox",
+            "category": "Lightweight WM",
+            "recommended": False,
+            "cpu": "1 Core (400+ MHz)",
+            "ram": "~100MB",
+            "desc": "Super-fast stacking window manager with tabs and taskbar",
+            "session_bin": "startfluxbox",
+            "session_cmd": "startfluxbox",
+            "xsession_rc": "export XDG_SESSION_DESKTOP=fluxbox",
+            "pkgs": {
+                "apt": ["fluxbox", "xterm", "pcmanfm"],
+                "dnf": ["fluxbox", "xterm", "pcmanfm"],
+                "pacman": ["fluxbox", "xterm", "pcmanfm"],
+                "zypper": ["fluxbox", "xterm", "pcmanfm"],
+                "apk": ["fluxbox", "xterm", "pcmanfm"]
+            }
+        }
+    }
+
+    def __init__(self, server_env: ServerEnv):
+        self.env = server_env
+
+    def get_desktop_info(self, de_id: str) -> Optional[Dict]:
+        return self.DESKTOPS.get(de_id)
+
+    def is_installed(self, de_id: str) -> bool:
+        info = self.DESKTOPS.get(de_id)
+        if not info:
+            return False
+        return shutil.which(info["session_bin"]) is not None
+
+    def get_user_home(self, username: str) -> str:
+        if username == "root":
+            return "/root"
+        import pwd
+        try:
+            return pwd.getpwnam(username).pw_dir
+        except Exception:
+            return f"/home/{username}"
+
+    def get_active_session(self, username: str) -> Optional[str]:
+        """Detects which Desktop Environment is currently set in target user's ~/.xsession."""
+        home = self.get_user_home(username)
+        xsession_path = os.path.join(home, ".xsession")
+        if not os.path.exists(xsession_path):
+            return None
+        try:
+            with open(xsession_path, "r", encoding="utf-8", errors="ignore") as f:
+                content = f.read()
+                for de_id, info in self.DESKTOPS.items():
+                    if info["session_cmd"] in content:
+                        return de_id
+        except Exception:
+            pass
+        return None
+
+    def list_desktops(self, target_user: Optional[str] = None) -> List[Dict]:
+        """Returns all 14 desktop environments with installed and active status flags."""
+        active_de = self.get_active_session(target_user) if target_user else None
+        res = []
+        for de_id, data in self.DESKTOPS.items():
+            installed = self.is_installed(de_id)
+            res.append({
+                "id": de_id,
+                "name": data["name"],
+                "category": data["category"],
+                "recommended": data.get("recommended", False),
+                "cpu": data.get("cpu", "1 Core (1.0+ GHz)"),
+                "ram": data["ram"],
+                "desc": data["desc"],
+                "installed": installed,
+                "is_active": (de_id == active_de)
+            })
+        return res
+
+    def set_default_session(self, de_id: str, username: str) -> bool:
+        """Configures target user's ~/.xsession and ~/.xsessionrc to launch the specified DE."""
+        info = self.DESKTOPS.get(de_id)
+        if not info:
+            return False
+        home = self.get_user_home(username)
+        os.makedirs(home, exist_ok=True)
+        xsession_file = os.path.join(home, ".xsession")
+        xsessionrc_file = os.path.join(home, ".xsessionrc")
+
+        try:
+            with open(xsession_file, "w", encoding="utf-8") as f:
+                f.write(f"{info['session_cmd']}\n")
+            os.chmod(xsession_file, 0o755)
+
+            with open(xsessionrc_file, "w", encoding="utf-8") as f:
+                f.write(f"{info['xsession_rc']}\n")
+
+            import pwd
+            user_entry = pwd.getpwnam(username)
+            os.chown(xsession_file, user_entry.pw_uid, user_entry.pw_gid)
+            os.chown(xsessionrc_file, user_entry.pw_uid, user_entry.pw_gid)
+            return True
+        except Exception:
+            return False
+
+    def install_desktop(
+        self,
+        de_id: str,
+        target_user: str,
+        set_as_default: bool = True,
+        live_callback: Optional[Callable[[str], None]] = None
+    ) -> bool:
+        """Installs selected desktop environment, applies fallbacks if missing, and configures user session."""
+        info = self.DESKTOPS.get(de_id)
+        if not info:
+            if live_callback:
+                live_callback(f"[ERROR] Unknown desktop ID: {de_id}")
+            return False
+
+        # Ensure Base X11 and DBus
+        self.env.install_base_x11(live_callback=live_callback)
+
+        # Distro specific packages
+        pkgs = info["pkgs"].get(self.env.pkg_mgr, info["pkgs"].get("apt", []))
+        if live_callback:
+            live_callback(f"Installing {info['name']} ({', '.join(pkgs)})...")
+
+        self.env.install_packages(pkgs, live_callback=live_callback)
+
+        # Fallback check
+        session_bin = info["session_bin"]
+        if not shutil.which(session_bin):
+            if live_callback:
+                live_callback(f"[WARN] '{session_bin}' not found in distro repositories! Installing rock-solid fallback XFCE4...")
+            fallback_pkgs = self.DESKTOPS["xfce4"]["pkgs"].get(self.env.pkg_mgr, ["xfce4", "xfce4-terminal"])
+            self.env.install_packages(fallback_pkgs, live_callback=live_callback)
+            de_id = "xfce4"
+
+        if set_as_default:
+            if live_callback:
+                live_callback(f"Configuring default session for user '{target_user}'...")
+            self.set_default_session(de_id, target_user)
+
+        self.env.setup_user_runtime_dir(target_user)
+        self.env.ensure_dbus()
+
+        if live_callback:
+            live_callback(f"[SUCCESS] {self.DESKTOPS[de_id]['name']} desktop is ready.")
+        return True
+
+    def uninstall_desktop(
+        self,
+        de_id: str,
+        live_callback: Optional[Callable[[str], None]] = None
+    ) -> bool:
+        """Removes packages for the specified desktop environment."""
+        info = self.DESKTOPS.get(de_id)
+        if not info:
+            return False
+
+        pkgs = info["pkgs"].get(self.env.pkg_mgr, [])
+        if not pkgs:
+            return True
+
+        if live_callback:
+            live_callback(f"Uninstalling {info['name']} packages...")
+        success = self.env.remove_packages(pkgs, purge=True, live_callback=live_callback)
+        if live_callback:
+            if success:
+                live_callback(f"[SUCCESS] Uninstalled {info['name']}.")
+            else:
+                live_callback(f"[WARN] Completed uninstallation process with warnings.")
+        return success