commandertui 1.3.0__tar.gz → 1.4.0__tar.gz

{commandertui-1.3.0 → commandertui-1.4.0}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: commandertui
-Version: 1.3.0
+Version: 1.4.0
 Summary: Dual-pane retro terminal file manager: compare, sync, copy and move folders
 Author: Humberto Barchini
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/juniorbarchini-oss/commandertui
 Classifier: Environment :: Console
+Classifier: Operating System :: MacOS
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: System :: Filesystems
@@ -22,7 +23,7 @@ Dual-pane terminal file manager: compare two folders, sync them, or move
 files/folders between them (and to USB/SMB/any mounted path) — with a
 phosphor-green 80s-terminal look and a short modem-style boot animation.
 
-Status: **v1.3.0** — 119/119 tests passing. MIT licensed.
+Status: **v1.4.0** — 153/153 tests passing. MIT licensed.
 
 ---
 
@@ -32,7 +33,7 @@ A safe, simple alternative to heavier dual-pane file managers. It was
 written after an earlier attempt of the same idea had to be scrapped for
 running an unauthenticated local HTTP server. This project deliberately:
 
-- **Never opens a network port.** Pure terminal UI (Textual), no HTTP server (the only outgoing request is the daily update check, which you can turn off),
+- **Never opens a network port.** Pure terminal UI (Textual), no HTTP server (the only outgoing request is the update check on startup, which you can turn off),
   no webview.
 - **Never does a raw `rm -rf`.** Deletes always go through the desktop trash
   (`send2trash` → `gio trash` → manual move into `~/.local/share/Trash`, in
@@ -123,7 +124,7 @@ o.window("^commandertui$", { float = true, center = true, size = { 1174, 637 } }
 | Key | Action |
 |---|---|
 | `Tab` | Switch active pane |
-| `↑`/`↓`, `Enter` | Navigate, open directory |
+| `↑`/`↓`, `Enter` | Navigate, open directory (or sort column when header is focused with `↑` beyond row 0) |
 | `Backspace` | Go to parent directory |
 | `Space` | Mark/unmark item under cursor |
 | `F2` | Rename the item under the cursor (never overwrites an existing name) |
@@ -134,11 +135,12 @@ o.window("^commandertui$", { float = true, center = true, size = { 1174, 637 } }
 | `F8` / `Delete` | Delete marked (to trash) |
 | `/` | Filter the active pane by name (contains, ignores case) as you type; `Enter` keeps it, `Esc` clears it |
 | `+` / `-` / `*` | Mark / unmark by pattern (`*.iso`, or plain text = contains) / invert marks, over the rows shown |
-| `u` | Update: shows the pending new version (see *Updates*) |
+| `u` | Check for updates now (also the **Updates** button): asks PyPI right away and offers the new version if there is one |
+| `v` | Quick Look file preview (macOS only): opens `qlmanage -p` for the file under cursor; press `v` again or close the window to dismiss |
 | `i` | Size: file/folder count and total bytes of marked items (background, `Esc` stops it) |
 | `h` | Show/hide hidden (dot) files in both panes |
 | `t` | Color theme: Phosphor green (default), Phosphor amber, Nord, Gruvbox, Dracula, Tokyo Night, Catppuccin Mocha, Solarized Dark, Monokai, Textual Dark. Previews as you move, Enter keeps it (saved in `~/.config/commandertui/settings.json`), Esc goes back |
-| `p` | Places: jump to a mounted drive (USB/SMB/rclone), saved bookmark or saved network location. Inside: `a` add a network location, `s` save the active pane's folder as a bookmark, `d` delete a saved one |
+| `p` | Places: jump to a mounted drive (USB/SMB/rclone), saved bookmark or saved network location. Inside: `a` add a network location, `s` save the active pane's folder as a bookmark, `d` delete a saved one, `e` unmount a mounted SMB share |
 | `c` | Compare: full recursive diff between the two panes' current folders, with size and date of both sides (and which is newer when a file changed) |
 | `r` | Refresh both panes |
 | `q` | Quit |
@@ -153,13 +155,13 @@ half-written), and a move never removes a source it didn't fully copy.
 on-demand mount point doesn't show), GVFS/Nautilus network shares, FUSE
 mounts inside `$HOME` (e.g. `rclone mount`), and saved bookmarks.
 
-**Network locations (Linux, needs `gio`/GVFS):** in Places press `a`, pick
+**Network locations (Linux, needs `gio`/GVFS; macOS supports SMB via `smbutil`/`osascript` and `/Volumes`):** in Places press `a`, pick
 SMB, SFTP or FTP and type the server's IP or name. For SMB the app lists the
-shares on the server and you pick one; SFTP/FTP connect straight in. The
-location is saved in `~/.config/commandertui/network.json` (protocol, host
-and share only -- never a password) and reappears in Places, mounting itself
+shares on the server and you pick one; SFTP/FTP connect straight in (Linux only). The
+location is saved in `~/.config/commandertui/network.json` (protocol, host,
+share and user only -- never a password) and reappears in Places, mounting itself
 when picked. If the server asks for a login, `gio` asks for it in the
-terminal and can remember it in the system keyring, exactly like Nautilus.
+terminal and can remember it in the system keyring, exactly like Nautilus (on macOS, the system login dialog asks and saves it in Keychain).
 
 Every key also has a clickable box on the bottom bar: one row on wide windows
 (168+ columns), two rows when narrower (120 columns is the practical minimum).
@@ -168,7 +170,8 @@ shows the free space of that disk, and the marked count and total size.
 
 ## Updates
 
-Once a day, in the background and only after the start-up animation, the app
+On every launch, in the background while the start-up animation plays (its
+CHECKING UPDATES line shows the result), the app
 asks PyPI for the latest version (a plain GET, nothing about you is sent). If
 a newer one exists you get a dialog -- **Update now / Later / Skip this
 version** -- and the header keeps saying `update X available (press u)`.

{commandertui-1.3.0 → commandertui-1.4.0}/README.md

@@ -4,7 +4,7 @@ Dual-pane terminal file manager: compare two folders, sync them, or move
 files/folders between them (and to USB/SMB/any mounted path) — with a
 phosphor-green 80s-terminal look and a short modem-style boot animation.
 
-Status: **v1.3.0** — 119/119 tests passing. MIT licensed.
+Status: **v1.4.0** — 153/153 tests passing. MIT licensed.
 
 ---
 
@@ -14,7 +14,7 @@ A safe, simple alternative to heavier dual-pane file managers. It was
 written after an earlier attempt of the same idea had to be scrapped for
 running an unauthenticated local HTTP server. This project deliberately:
 
-- **Never opens a network port.** Pure terminal UI (Textual), no HTTP server (the only outgoing request is the daily update check, which you can turn off),
+- **Never opens a network port.** Pure terminal UI (Textual), no HTTP server (the only outgoing request is the update check on startup, which you can turn off),
   no webview.
 - **Never does a raw `rm -rf`.** Deletes always go through the desktop trash
   (`send2trash` → `gio trash` → manual move into `~/.local/share/Trash`, in
@@ -105,7 +105,7 @@ o.window("^commandertui$", { float = true, center = true, size = { 1174, 637 } }
 | Key | Action |
 |---|---|
 | `Tab` | Switch active pane |
-| `↑`/`↓`, `Enter` | Navigate, open directory |
+| `↑`/`↓`, `Enter` | Navigate, open directory (or sort column when header is focused with `↑` beyond row 0) |
 | `Backspace` | Go to parent directory |
 | `Space` | Mark/unmark item under cursor |
 | `F2` | Rename the item under the cursor (never overwrites an existing name) |
@@ -116,11 +116,12 @@ o.window("^commandertui$", { float = true, center = true, size = { 1174, 637 } }
 | `F8` / `Delete` | Delete marked (to trash) |
 | `/` | Filter the active pane by name (contains, ignores case) as you type; `Enter` keeps it, `Esc` clears it |
 | `+` / `-` / `*` | Mark / unmark by pattern (`*.iso`, or plain text = contains) / invert marks, over the rows shown |
-| `u` | Update: shows the pending new version (see *Updates*) |
+| `u` | Check for updates now (also the **Updates** button): asks PyPI right away and offers the new version if there is one |
+| `v` | Quick Look file preview (macOS only): opens `qlmanage -p` for the file under cursor; press `v` again or close the window to dismiss |
 | `i` | Size: file/folder count and total bytes of marked items (background, `Esc` stops it) |
 | `h` | Show/hide hidden (dot) files in both panes |
 | `t` | Color theme: Phosphor green (default), Phosphor amber, Nord, Gruvbox, Dracula, Tokyo Night, Catppuccin Mocha, Solarized Dark, Monokai, Textual Dark. Previews as you move, Enter keeps it (saved in `~/.config/commandertui/settings.json`), Esc goes back |
-| `p` | Places: jump to a mounted drive (USB/SMB/rclone), saved bookmark or saved network location. Inside: `a` add a network location, `s` save the active pane's folder as a bookmark, `d` delete a saved one |
+| `p` | Places: jump to a mounted drive (USB/SMB/rclone), saved bookmark or saved network location. Inside: `a` add a network location, `s` save the active pane's folder as a bookmark, `d` delete a saved one, `e` unmount a mounted SMB share |
 | `c` | Compare: full recursive diff between the two panes' current folders, with size and date of both sides (and which is newer when a file changed) |
 | `r` | Refresh both panes |
 | `q` | Quit |
@@ -135,13 +136,13 @@ half-written), and a move never removes a source it didn't fully copy.
 on-demand mount point doesn't show), GVFS/Nautilus network shares, FUSE
 mounts inside `$HOME` (e.g. `rclone mount`), and saved bookmarks.
 
-**Network locations (Linux, needs `gio`/GVFS):** in Places press `a`, pick
+**Network locations (Linux, needs `gio`/GVFS; macOS supports SMB via `smbutil`/`osascript` and `/Volumes`):** in Places press `a`, pick
 SMB, SFTP or FTP and type the server's IP or name. For SMB the app lists the
-shares on the server and you pick one; SFTP/FTP connect straight in. The
-location is saved in `~/.config/commandertui/network.json` (protocol, host
-and share only -- never a password) and reappears in Places, mounting itself
+shares on the server and you pick one; SFTP/FTP connect straight in (Linux only). The
+location is saved in `~/.config/commandertui/network.json` (protocol, host,
+share and user only -- never a password) and reappears in Places, mounting itself
 when picked. If the server asks for a login, `gio` asks for it in the
-terminal and can remember it in the system keyring, exactly like Nautilus.
+terminal and can remember it in the system keyring, exactly like Nautilus (on macOS, the system login dialog asks and saves it in Keychain).
 
 Every key also has a clickable box on the bottom bar: one row on wide windows
 (168+ columns), two rows when narrower (120 columns is the practical minimum).
@@ -150,7 +151,8 @@ shows the free space of that disk, and the marked count and total size.
 
 ## Updates
 
-Once a day, in the background and only after the start-up animation, the app
+On every launch, in the background while the start-up animation plays (its
+CHECKING UPDATES line shows the result), the app
 asks PyPI for the latest version (a plain GET, nothing about you is sent). If
 a newer one exists you get a dialog -- **Update now / Later / Skip this
 version** -- and the header keeps saying `update X available (press u)`.

commandertui-1.4.0/commandertui/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.4.0"

{commandertui-1.3.0 → commandertui-1.4.0}/commandertui/app.py

@@ -4,7 +4,7 @@ import os
 
 from textual.app import App
 
-from . import settings, theme, updater
+from . import preview, settings, theme, updater
 from .boot import BootScreen
 from .main_screen import MainScreen
 
@@ -26,11 +26,15 @@ class CommanderApp(App):
         self.theme = saved if saved in self.available_themes else theme.DEFAULT_THEME
         self.check_updates = check_updates and not updater.updates_disabled()
         self.update_info: updater.UpdateInfo | None = None
+        # What the boot screen's CHECKING UPDATES line shows.
+        self.update_state = "pending" if self.check_updates else "off"
+        self.update_latest = ""
         self.update_prompted = False
         self.left_path = os.path.abspath(left_path or os.path.expanduser("~"))
         self.right_path = os.path.abspath(right_path or os.path.expanduser("~"))
 
     def on_unmount(self) -> None:
+        preview.close_preview()
         # Whatever theme is showing when the app closes is the one to reopen
         # with -- covers the picker (t) and Textual's own palette (ctrl+p).
         settings.save_theme(self.theme)
@@ -40,18 +44,21 @@ class CommanderApp(App):
 
     def on_mount(self) -> None:
         self.push_screen(MainScreen(self.left_path, self.right_path))
-        self.push_screen(BootScreen(), self._after_boot)
-
-    def _after_boot(self, _result=None) -> None:
-        # Looked up only once the boot animation is over, so a quick answer
-        # can never pop a dialog over it.
+        self.push_screen(BootScreen())
+        # Looked up while the boot animation plays (it shows the result); the
+        # dialog itself waits for the main screen, so it never covers the boot.
         if self.check_updates:
             self.run_worker(self._look_for_update, thread=True)
 
     def _look_for_update(self) -> None:
-        info = updater.check()
+        info, status = updater.check_status()
+        self.call_from_thread(self._update_checked, info, status)
+
+    def _update_checked(self, info: updater.UpdateInfo | None, status: str) -> None:
+        self.update_state = status
         if info:
-            self.call_from_thread(self.update_found, info)
+            self.update_latest = info.latest
+            self.update_found(info)
 
     def update_found(self, info: updater.UpdateInfo) -> None:
         """Remember the newer version and say so in the header; the dialog

{commandertui-1.3.0 → commandertui-1.4.0}/commandertui/ascii_font.py

@@ -17,11 +17,14 @@ _FONT: dict[str, list[str]] = {
 BLOCK = "█"  # solid block, swapped in for the '#' placeholders above
 
 
-def banner(word: str, gap: int = 1) -> str:
-    """Render `word` as 5 lines of block letters."""
+def banner(word: str, gap: int = 1, scale: int = 1) -> str:
+    """Render `word` as block letters, 5 rows tall at scale 1; a larger scale
+    makes every block `scale` cells wide and tall."""
     letters = [_FONT[ch] for ch in word.upper()]
     sep = " " * gap
     rows = []
     for row_index in range(5):
-        rows.append(sep.join(letter[row_index] for letter in letters).replace("#", BLOCK))
+        row = sep.join(letter[row_index] for letter in letters).replace("#", BLOCK)
+        row = "".join(ch * scale for ch in row)
+        rows.extend([row] * scale)
     return "\n".join(rows)

{commandertui-1.3.0 → commandertui-1.4.0}/commandertui/boot.py

@@ -8,16 +8,25 @@ from textual.widgets import Static
 from .ascii_font import banner
 
 CURSOR = "█"  # solid block, like a CRT text cursor
+SPINNER = "|/-\\"
+LINE_WIDTH = 44  # fixed, so a status changing later never moves the box
+WIDE_ENOUGH = 114  # terminal columns for the double-size title (110 wide with its box)
 
 
-def _build_art() -> str:
-    title_lines = banner("COMMANDER").split("\n")
+def _line(label: str, status: str) -> str:
+    dots = "." * (LINE_WIDTH - len(label) - len(status) - 2)
+    return f"{label} {dots} {status}"
+
+
+def _build_art(scale: int = 1, update_status: str = "OK") -> str:
+    title_lines = banner("COMMANDER", scale=scale).split("\n")
     body_lines = [
         "",
         "T U I  --  dual-pane file manager",
         "",
-        "CONNECT 2400 ...................... OK",
-        "LOADING PANELS ..................... OK",
+        _line("CONNECT 2400", "OK"),
+        _line("LOADING PANELS", "OK"),
+        _line("CHECKING UPDATES", update_status),
         "READY.",
     ]
     content = title_lines + body_lines
@@ -31,6 +40,11 @@ def _build_art() -> str:
     return "\n".join(boxed)
 
 
+def update_status_text(state: str, latest: str = "") -> str:
+    """What the CHECKING UPDATES line says for an app update state."""
+    return {"ok": "OK", "off": "OFF", "offline": "OFFLINE", "skipped": "SKIPPED"}.get(state, f"NEW {latest}")
+
+
 ART = _build_art()
 
 
@@ -63,13 +77,16 @@ class BootScreen(Screen):
 
     def __init__(
         self,
-        art: str = ART,
+        art: str | None = None,
         chars_per_tick: int = 3,
         tick_seconds: float = 0.035,
         bell: bool = True,
     ) -> None:
         super().__init__()
-        self.art = art
+        self.fixed_art = art  # tests/tools can pass a fixed picture; normally built live
+        self.art = art or ART
+        self._scale = 1
+        self._frame = 0
         self.chars_per_tick = chars_per_tick
         self.tick_seconds = tick_seconds
         self.bell = bell
@@ -87,10 +104,35 @@ class BootScreen(Screen):
         yield Static("", id="boot-hint")
 
     def on_mount(self) -> None:
+        # Double-size title when the window is wide enough for it.
+        self._scale = 2 if self.app.size.width >= WIDE_ENOUGH else 1
         self._timer = self.set_interval(self.tick_seconds, self._tick)
 
+    def _pending(self) -> bool:
+        return self.fixed_art is None and getattr(self.app, "update_state", "off") == "pending"
+
+    def _current_art(self) -> str:
+        if self.fixed_art is not None:
+            return self.fixed_art
+        state = getattr(self.app, "update_state", "off")
+        if state == "pending":
+            status = SPINNER[self._frame % 4]
+        else:
+            status = update_status_text(state, getattr(self.app, "update_latest", ""))
+        return _build_art(self._scale, status)
+
+    def _limit(self) -> int:
+        """How far the reveal may go: while the update check is still running
+        it waits just before the READY. row."""
+        if not self._pending():
+            return len(self.art)
+        ready = self.art.index("READY.")
+        return self.art.rfind("\n", 0, ready) + 1
+
     def _tick(self) -> None:
-        self._pos = min(len(self.art), self._pos + self.chars_per_tick)
+        self._frame += 1
+        self.art = self._current_art()
+        self._pos = min(self._limit(), self._pos + self.chars_per_tick)
         widget = self.query_one("#boot-text", Static)
         visible = self.art[: self._pos]
         cursor = CURSOR if self._pos < len(self.art) else ""
@@ -102,13 +144,19 @@ class BootScreen(Screen):
                 self._timer.stop()
             if self.bell:
                 self.app.bell()
-            self.query_one("#boot-hint", Static).update("[ENTER] to continue")
+            self.query_one("#boot-hint", Static).update("\\[ENTER] to continue")
 
     def action_continue_(self) -> None:
-        if not self._done:
-            # Not drawn yet: Enter fast-forwards straight to the final frame
-            # instead of doing nothing, in case someone doesn't want to wait.
-            self._pos = len(self.art)
+        if self._pos < self._limit():
+            # Not drawn yet: Enter fast-forwards as far as it can go instead
+            # of doing nothing, in case someone doesn't want to wait.
+            self._pos = self._limit()
             self._tick()
             return
+        if self._pending() and self._pos < len(self.art):
+            # Reveal is parked waiting on the update check: don't make the
+            # user wait for the network; a newer version still gets offered
+            # when it arrives.
+            self.dismiss()
+            return
         self.dismiss()

{commandertui-1.3.0 → commandertui-1.4.0}/commandertui/main_screen.py

@@ -10,7 +10,7 @@ from textual.screen import Screen
 from textual.widgets import DataTable, Header
 
 from .compare_screen import CompareScreen
-from . import editor, netlocations, theme, updater
+from . import __version__, editor, netlocations, preview, theme, updater
 from .modals import (
     ADD_NETWORK,
     ChoiceScreen,
@@ -44,6 +44,10 @@ class MainScreen(Screen):
     BINDINGS = [
         Binding("tab", "switch_pane", "Switch pane", priority=True),
         Binding("enter", "enter_dir", "Open", priority=True),
+        Binding("up", "nav_up", "Up", priority=True),
+        Binding("down", "nav_down", "Down", priority=True),
+        Binding("left", "nav_left", "Left", priority=True),
+        Binding("right", "nav_right", "Right", priority=True),
         Binding("backspace", "up_dir", "Up", priority=True),
         Binding("space", "toggle_mark", "Mark", priority=True),
         Binding("t", "pick_theme", "Theme", priority=True),
@@ -64,6 +68,7 @@ class MainScreen(Screen):
         Binding("r", "refresh_both", "Refresh", priority=True),
         Binding("h", "toggle_hidden", "Hidden", priority=True),
         Binding("i", "show_size", "Size", priority=True),
+        Binding("v", "preview_file", "Preview", priority=True),
         # "app.quit", not "quit": this binding lives on the Screen, and a bare
         # "quit" resolves against the Screen's own (nonexistent) action_quit
         # rather than bubbling to the App, so it silently did nothing.
@@ -131,13 +136,91 @@ class MainScreen(Screen):
 
     # -------------------------------------------------------------- nav
     def action_switch_pane(self) -> None:
+        panel = self._active_panel()
+        if panel.header_active:
+            panel.header_active = False
+            panel.update_header_labels()
         self._set_active("right" if self.active_side == "left" else "left")
 
     def action_enter_dir(self) -> None:
-        self._active_panel().enter_selected()
+        panel = self._active_panel()
+        if panel.header_active:
+            col_name = ["Name", "Size", "Modified"][panel.header_selected_index]
+            panel.toggle_sort(col_name)
+        else:
+            panel.enter_selected()
+
+    def action_nav_up(self) -> None:
+        panel = self._active_panel()
+        table = panel.query_one(f"#{panel.side}-table", DataTable)
+        if panel.header_active:
+            return
+        if table.cursor_row == 0:
+            panel.header_active = True
+            panel.update_header_labels()
+        else:
+            table.action_cursor_up()
+
+    def action_nav_down(self) -> None:
+        panel = self._active_panel()
+        table = panel.query_one(f"#{panel.side}-table", DataTable)
+        if panel.header_active:
+            panel.header_active = False
+            panel.update_header_labels()
+        else:
+            table.action_cursor_down()
+
+    def action_nav_left(self) -> None:
+        panel = self._active_panel()
+        if panel.header_active:
+            panel.header_selected_index = max(0, panel.header_selected_index - 1)
+            panel.update_header_labels()
+        else:
+            table = panel.query_one(f"#{panel.side}-table", DataTable)
+            table.action_cursor_left()
+
+    def action_nav_right(self) -> None:
+        panel = self._active_panel()
+        if panel.header_active:
+            panel.header_selected_index = min(2, panel.header_selected_index + 1)
+            panel.update_header_labels()
+        else:
+            table = panel.query_one(f"#{panel.side}-table", DataTable)
+            table.action_cursor_right()
+
+    def on_data_table_header_selected(self, event: DataTable.HeaderSelected) -> None:
+        # Col 0: " ", Col 1: Name, Col 2: Size, Col 3: Modified (Date)
+        if event.column_index < 1:
+            return
+        col_names = {1: "Name", 2: "Size", 3: "Modified"}
+        col_name = col_names.get(event.column_index)
+        if not col_name:
+            return
+        panel = None
+        if isinstance(event.data_table.parent, FilePanel):
+            panel = event.data_table.parent
+        elif event.data_table.id and "left" in event.data_table.id:
+            panel = self._panel("left")
+        elif event.data_table.id and "right" in event.data_table.id:
+            panel = self._panel("right")
+        else:
+            panel = self._active_panel()
+
+        if self.active_side != panel.side:
+            active = self._active_panel()
+            if active.header_active:
+                active.header_active = False
+                active.update_header_labels()
+            self._set_active(panel.side)
+
+        panel.header_selected_index = event.column_index - 1
+        panel.toggle_sort(col_name)
 
     def action_up_dir(self) -> None:
         panel = self._active_panel()
+        if panel.header_active:
+            panel.header_active = False
+            panel.update_header_labels()
         panel.path = os.path.dirname(panel.path)
         panel.marked.clear()
         panel.refresh_listing()
@@ -220,16 +303,33 @@ class MainScreen(Screen):
 
     # ------------------------------------------------------------ updates
     def action_update_app(self) -> None:
-        if self.app.update_info is None:
-            self.notify("CommanderTUI is up to date.")
+        if self.app.update_info is not None:
+            self.app.update_prompted = False
+            self.prompt_update()
             return
-        self.app.update_prompted = False
-        self.prompt_update()
+        # Nothing known yet: ask PyPI right now instead of trusting the daily check.
+        self.notify("Checking for updates...")
+        self.run_worker(self._check_now, thread=True)
+
+    def _check_now(self) -> None:
+        info, reachable = updater.check_now()
+        self.app.call_from_thread(self._check_done, info, reachable)
+
+    def _check_done(self, info, reachable: bool) -> None:
+        if info is not None:
+            self.app.update_prompted = False
+            self.app.update_found(info)
+        elif not reachable:
+            self.notify("Could not reach PyPI. Check the connection and try again.", severity="warning")
+        else:
+            self.notify(f"CommanderTUI {__version__} is up to date.")
 
     def prompt_update(self) -> None:
         info = self.app.update_info
         if info is None or self.app.update_prompted:
             return
+        if self.app.screen is not self:
+            return  # the boot animation (or a dialog) is on top: resume will call us again
         self.app.update_prompted = True
 
         def on_choice(choice: str | None) -> None:
@@ -337,6 +437,20 @@ class MainScreen(Screen):
         panel.refresh_listing()
         panel.move_cursor_to(name)
 
+    def action_preview_file(self) -> None:
+        if not preview.is_macos():
+            return
+        panel = self._active_panel()
+        name = panel.selected_name()
+        if not name or name == PARENT_MARK:
+            self.app.push_screen(MessageScreen("Preview works on files only"))
+            return
+        path = os.path.join(panel.path, name)
+        if os.path.isdir(path):
+            self.app.push_screen(MessageScreen("Preview works on files only"))
+            return
+        preview.toggle_preview(path)
+
     def action_copy(self) -> None:
         self._run_marked_op(OpKind.COPY, "Copy")
 
@@ -423,29 +537,41 @@ class MainScreen(Screen):
             self.app.push_screen(MessageScreen("Network locations need `gio` (GVFS) installed."))
             return
 
+        def on_user(host: str, user: str | None) -> None:
+            if not user or not user.strip():
+                return
+            self._pick_share(host, user=user.strip())
+
         def on_host(scheme: str, host: str | None) -> None:
             if not host or not host.strip():
                 return
+            host_clean = host.strip()
             if scheme == "smb":
-                self._pick_share(host.strip())
+                if netlocations.is_macos():
+                    self.app.push_screen(InputScreen("SMB user:"), lambda u: on_user(host_clean, u))
+                else:
+                    self._pick_share(host_clean)
             else:
-                self._connect(netlocations.build_uri(scheme, host), save=True)
+                self._connect(netlocations.build_uri(scheme, host_clean), save=True)
 
         def on_scheme(choice: str | None) -> None:
             if not choice:
                 return
             scheme = choice.lower()
+            if netlocations.is_macos() and scheme != "smb":
+                self.app.push_screen(MessageScreen(netlocations.MACOS_UNSUPPORTED_MSG))
+                return
             self.app.push_screen(
                 InputScreen(f"{choice} server (IP or name):"), lambda host: on_host(scheme, host)
             )
 
         self.app.push_screen(ChoiceScreen("Protocol", ["SMB", "SFTP", "FTP"]), on_scheme)
 
-    def _pick_share(self, host: str, retried: bool = False) -> None:
+    def _pick_share(self, host: str, retried: bool = False, user: str | None = None) -> None:
         self.notify(f"Listing shares on {host}...")
 
         def work() -> None:
-            shares, err = netlocations.list_shares(host)
+            shares, err = netlocations.list_shares(host, user=user)
             self.app.call_from_thread(done, shares, err)
 
         def done(shares: list[str] | None, err: str) -> None:
@@ -453,23 +579,30 @@ class MainScreen(Screen):
                 if retried:
                     self.app.push_screen(MessageScreen(f"Could not list shares on {host}.\n{err}"))
                     return
-                # Most likely a login is needed: let gio ask for it on the real
-                # terminal (and offer to remember it in the keyring).
-                with self.app.suspend():
-                    netlocations.mount(netlocations.build_uri("smb", host), interactive=True)
-                self._pick_share(host, retried=True)
+                if netlocations.is_macos():
+                    netlocations.mount(netlocations.build_uri("smb", host, user=user), interactive=True)
+                else:
+                    # Most likely a login is needed: let gio ask for it on the real
+                    # terminal (and offer to remember it in the keyring).
+                    with self.app.suspend():
+                        netlocations.mount(netlocations.build_uri("smb", host), interactive=True)
+                self._pick_share(host, retried=True, user=user)
                 return
             if not shares:
                 self.app.push_screen(MessageScreen(f"No shares found on {host}."))
                 return
             self.app.push_screen(
                 ChoiceScreen(f"Shares on {host}", shares),
-                lambda share: share and self._connect(netlocations.build_uri("smb", host, share), save=True),
+                lambda share: share
+                and self._connect(netlocations.build_uri("smb", host, share, user=user), save=True),
             )
 
         self.run_worker(work, thread=True)
 
     def _connect(self, uri: str, save: bool = False, retried: bool = False) -> None:
+        if netlocations.is_macos() and not uri.lower().startswith("smb://"):
+            self.app.push_screen(MessageScreen(netlocations.MACOS_UNSUPPORTED_MSG))
+            return
         self.notify(f"Connecting to {uri} ...")
 
         def work() -> None:
@@ -483,7 +616,7 @@ class MainScreen(Screen):
                     netlocations.save_location(uri)
                 self._go_to(path)
                 return
-            if retried:
+            if retried or netlocations.is_macos():
                 self.app.push_screen(MessageScreen(f"Could not connect to {uri}.\n{err}"))
                 return
             with self.app.suspend():