pxv 1.0.0__tar.gz

pxv-1.0.0/LICENSE

@@ -0,0 +1,116 @@
+CC0 1.0 Universal
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator and
+subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for the
+purpose of contributing to a commons of creative, cultural and scientific
+works ("Commons") that the public can reliably and without fear of later
+claims of infringement build upon, modify, incorporate in other works, reuse
+and redistribute as freely as possible in any form whatsoever and for any
+purposes, including without limitation commercial purposes. These owners may
+contribute to the Commons to promote the ideal of a free culture and the
+further production of creative, cultural and scientific works, or to gain
+reputation or greater distribution for their Work in part through the use and
+efforts of others.
+
+For these and/or other purposes and motivations, and without any expectation
+of additional consideration or compensation, the person associating CC0 with a
+Work (the "Affirmer"), to the extent that he or she is an owner of Copyright
+and Related Rights in the Work, voluntarily elects to apply CC0 to the Work
+and publicly distribute the Work under its terms, with knowledge of his or her
+Copyright and Related Rights in the Work and the meaning and intended legal
+effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not limited
+to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display, communicate,
+  and translate a Work;
+
+  ii. moral rights retained by the original author(s) and/or performer(s);
+
+  iii. publicity and privacy rights pertaining to a person's image or likeness
+  depicted in a Work;
+
+  iv. rights protecting against unfair competition in regards to a Work,
+  subject to the limitations in paragraph 4(a), below;
+
+  v. rights protecting the extraction, dissemination, use and reuse of data in
+  a Work;
+
+  vi. database rights (such as those arising under Directive 96/9/EC of the
+  European Parliament and of the Council of 11 March 1996 on the legal
+  protection of databases, and under any national implementation thereof,
+  including any amended or successor version of such directive); and
+
+  vii. other similar, equivalent or corresponding rights throughout the world
+  based on applicable law or treaty, and any national implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention of,
+applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and
+unconditionally waives, abandons, and surrenders all of Affirmer's Copyright
+and Related Rights and associated claims and causes of action, whether now
+known or unknown (including existing as well as future claims and causes of
+action), in the Work (i) in all territories worldwide, (ii) for the maximum
+duration provided by applicable law or treaty (including future time
+extensions), (iii) in any current or future medium and for any number of
+copies, and (iv) for any purpose whatsoever, including without limitation
+commercial, advertising or promotional purposes (the "Waiver"). Affirmer makes
+the Waiver for the benefit of each member of the public at large and to the
+detriment of Affirmer's heirs and successors, fully intending that such Waiver
+shall not be subject to revocation, rescission, cancellation, termination, or
+any other legal or equitable action to disrupt the quiet enjoyment of the Work
+by the public as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason be
+judged legally invalid or ineffective under applicable law, then the Waiver
+shall be preserved to the maximum extent permitted taking into account
+Affirmer's express Statement of Purpose. In addition, to the extent the Waiver
+is so judged Affirmer hereby grants to each affected person a royalty-free,
+non transferable, non sublicensable, non exclusive, irrevocable and
+unconditional license to exercise Affirmer's Copyright and Related Rights in
+the Work (i) in all territories worldwide, (ii) for the maximum duration
+provided by applicable law or treaty (including future time extensions), (iii)
+in any current or future medium and for any number of copies, and (iv) for any
+purpose whatsoever, including without limitation commercial, advertising or
+promotional purposes (the "License"). The License shall be deemed effective as
+of the date CC0 was applied by Affirmer to the Work. Should any part of the
+License for any reason be judged legally invalid or ineffective under
+applicable law, such partial invalidity or ineffectiveness shall not invalidate
+the remainder of the License, and in such case Affirmer hereby affirms that he
+or she will not (i) exercise any of his or her remaining Copyright and Related
+Rights in the Work or (ii) assert any associated claims and causes of action
+with respect to the Work, in either case contrary to Affirmer's express
+Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+  a. No trademark or patent rights held by Affirmer are waived, abandoned,
+  surrendered, licensed or otherwise affected by this document.
+
+  b. Affirmer offers the Work as-is and makes no representations or warranties
+  of any kind concerning the Work, express, implied, statutory or otherwise,
+  including without limitation warranties of title, merchantability, fitness
+  for a particular purpose, non infringement, or the absence of latent or
+  other defects, accuracy, or the present or absence of errors, whether or not
+  discoverable, all to the greatest extent permissible under applicable law.
+
+  c. Affirmer disclaims responsibility for clearing rights of other persons
+  that may apply to the Work or any use thereof, including without limitation
+  any person's Copyright and Related Rights in the Work. Further, Affirmer
+  disclaims responsibility for obtaining any necessary consents, permissions or
+  other rights required for any use of the Work.
+
+  d. Affirmer understands and acknowledges that Creative Commons is not a
+  party to this document and has no duty or obligation with respect to this CC0
+  or use of the Work.
+
+For more information, please see
+<https://creativecommons.org/publicdomain/zero/1.0/>

pxv-1.0.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: pxv
+Version: 1.0.0
+Summary: A Python clone of the classic Unix xv image viewer
+Keywords: image,viewer,xv,pillow,tkinter,graphics
+Author: Sean Reifschneider
+Author-email: Sean Reifschneider <sean@realgo.com>
+License-Expression: CC0-1.0
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics :: Viewers
+Requires-Dist: pillow>=12.0
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/linsomniac/pxv
+Project-URL: Repository, https://github.com/linsomniac/pxv
+Project-URL: Issues, https://github.com/linsomniac/pxv/issues
+Description-Content-Type: text/markdown
+
+# pxv
+
+A simple image viewer and manipulator built with Python/Pillow/Tkinter that takes inspiration from
+the classic Unix [xv](http://www.trilon.com/xv/) image viewer.
+
+## Quickstart
+
+Run directly from the GitHub repo (requires [uv](https://docs.astral.sh/uv/)):
+
+```sh
+uvx --from git+https://github.com/linsomniac/pxv pxv photo.jpg
+```
+
+Or install locally:
+
+```sh
+uv pip install git+https://github.com/linsomniac/pxv
+pxv photo.jpg
+```
+
+Pass files, directories, or nothing (opens a file dialog):
+
+```sh
+pxv image.png              # single file
+pxv *.jpg                  # multiple files
+pxv ~/Photos/              # all images in a directory
+pxv                        # open file dialog
+```
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `>` | Zoom in |
+| `<` | Zoom out |
+| `n` | Zoom to 1:1 (normal) |
+| `Space` / `Right` | Next image |
+| `Backspace` / `Left` | Previous image |
+| `c` | Crop to selection |
+| `e` | Enhancement dialog |
+| `Ctrl+s` | Save as |
+| `Escape` | Clear selection |
+| `q` | Quit |
+
+Right-click for additional options: rotate, flip, resize, grab (screenshot), print, and more.
+
+## Enhancements
+
+The enhancement dialog (`e`) provides real-time adjustment of:
+
+- Brightness, contrast, gamma
+- Sharpen, blur
+- Saturation, hue rotation
+- Per-channel RGB color balance
+
+## Features
+
+- XV-style window sizing: window grows/shrinks to fit the displayed image, capped at the current monitor's bounds
+- Multi-monitor aware: detects per-monitor geometry via xrandr so windows don't span displays
+- EXIF-aware orientation
+- Rubber-band selection for cropping
+- Wrap-around file navigation
+- Supports PNG, JPEG, BMP, TIFF, GIF, WebP, PPM, PGM, PBM, ICO
+
+## Requirements
+
+- Python 3.10+
+- Tkinter (usually included with Python; on Debian/Ubuntu: `sudo apt install python3-tk`)
+- Pillow 12+
+
+## Development
+
+```sh
+git clone https://github.com/linsomniac/pxv
+cd pxv
+uv sync
+uv run pxv test_images/
+```
+
+Lint and type-check:
+
+```sh
+uv run ruff check src/
+uv run ruff format --check src/
+uv run mypy src/pxv/
+```

pxv-1.0.0/README.md

@@ -0,0 +1,86 @@
+# pxv
+
+A simple image viewer and manipulator built with Python/Pillow/Tkinter that takes inspiration from
+the classic Unix [xv](http://www.trilon.com/xv/) image viewer.
+
+## Quickstart
+
+Run directly from the GitHub repo (requires [uv](https://docs.astral.sh/uv/)):
+
+```sh
+uvx --from git+https://github.com/linsomniac/pxv pxv photo.jpg
+```
+
+Or install locally:
+
+```sh
+uv pip install git+https://github.com/linsomniac/pxv
+pxv photo.jpg
+```
+
+Pass files, directories, or nothing (opens a file dialog):
+
+```sh
+pxv image.png              # single file
+pxv *.jpg                  # multiple files
+pxv ~/Photos/              # all images in a directory
+pxv                        # open file dialog
+```
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `>` | Zoom in |
+| `<` | Zoom out |
+| `n` | Zoom to 1:1 (normal) |
+| `Space` / `Right` | Next image |
+| `Backspace` / `Left` | Previous image |
+| `c` | Crop to selection |
+| `e` | Enhancement dialog |
+| `Ctrl+s` | Save as |
+| `Escape` | Clear selection |
+| `q` | Quit |
+
+Right-click for additional options: rotate, flip, resize, grab (screenshot), print, and more.
+
+## Enhancements
+
+The enhancement dialog (`e`) provides real-time adjustment of:
+
+- Brightness, contrast, gamma
+- Sharpen, blur
+- Saturation, hue rotation
+- Per-channel RGB color balance
+
+## Features
+
+- XV-style window sizing: window grows/shrinks to fit the displayed image, capped at the current monitor's bounds
+- Multi-monitor aware: detects per-monitor geometry via xrandr so windows don't span displays
+- EXIF-aware orientation
+- Rubber-band selection for cropping
+- Wrap-around file navigation
+- Supports PNG, JPEG, BMP, TIFF, GIF, WebP, PPM, PGM, PBM, ICO
+
+## Requirements
+
+- Python 3.10+
+- Tkinter (usually included with Python; on Debian/Ubuntu: `sudo apt install python3-tk`)
+- Pillow 12+
+
+## Development
+
+```sh
+git clone https://github.com/linsomniac/pxv
+cd pxv
+uv sync
+uv run pxv test_images/
+```
+
+Lint and type-check:
+
+```sh
+uv run ruff check src/
+uv run ruff format --check src/
+uv run mypy src/pxv/
+```

pxv-1.0.0/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "pxv"
+version = "1.0.0"  #  NOTE: Also update in src/pxv/__init__.py
+description = "A Python clone of the classic Unix xv image viewer"
+readme = "README.md"
+license = "CC0-1.0"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Sean Reifschneider", email = "sean@realgo.com" }
+]
+requires-python = ">=3.10"
+dependencies = [
+    "pillow>=12.0",
+]
+keywords = ["image", "viewer", "xv", "pillow", "tkinter", "graphics"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: X11 Applications",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Graphics :: Viewers",
+]
+
+[project.urls]
+Homepage = "https://github.com/linsomniac/pxv"
+Repository = "https://github.com/linsomniac/pxv"
+Issues = "https://github.com/linsomniac/pxv/issues"
+
+[project.scripts]
+pxv = "pxv:main"
+
+[build-system]
+requires = ["uv_build>=0.11.1,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.ruff]
+line-length = 99
+
+[tool.mypy]
+strict = true
+
+[[tool.mypy.overrides]]
+module = "PIL.*"
+ignore_missing_imports = true
+
+[dependency-groups]
+dev = [
+    "mypy>=1.20.0",
+    "ruff>=0.15.9",
+]

pxv-1.0.0/src/pxv/__init__.py

@@ -0,0 +1,7 @@
+"""pxv - A Python clone of the classic Unix xv image viewer."""
+
+__version__ = "1.0.0"
+
+from pxv.app import main
+
+__all__ = ["main"]

pxv-1.0.0/src/pxv/app.py

@@ -0,0 +1,276 @@
+"""Main application: creates the Tk root, wires all components together.
+
+AIDEV-NOTE: All keyboard bindings are on the root window so they work regardless
+of which widget has focus. The enhancement dialog binds its own widget-level events.
+"""
+
+from __future__ import annotations
+
+import argparse
+import re
+import subprocess
+import tkinter as tk
+from typing import TYPE_CHECKING
+
+from pxv import commands
+from pxv.canvas_view import CanvasView
+from pxv.context_menu import ContextMenu
+from pxv.enhancements import EnhancementParams
+from pxv.file_list import FileList, expand_paths
+from pxv.image_model import ImageModel
+
+if TYPE_CHECKING:
+    from pxv.enhancement_dialog import EnhancementDialog
+
+
+# AIDEV-NOTE: Tkinter's winfo_screenwidth/height returns the total virtual desktop
+# across all monitors. These helpers use xrandr to detect individual monitor
+# geometry so windows don't span multiple displays.
+
+_cached_monitors: list[tuple[int, int, int, int]] | None = None
+
+
+def _parse_monitors() -> list[tuple[int, int, int, int]]:
+    """Parse xrandr output to get connected monitor geometries.
+
+    Returns list of (width, height, x_offset, y_offset) tuples.
+    Result is cached for the process lifetime.
+    """
+    global _cached_monitors
+    if _cached_monitors is not None:
+        return _cached_monitors
+    try:
+        output = subprocess.check_output(
+            ["xrandr"], text=True, timeout=5, stderr=subprocess.DEVNULL
+        )
+        pattern = r"\bconnected\s+(?:primary\s+)?(\d+)x(\d+)\+(\d+)\+(\d+)"
+        _cached_monitors = [
+            (int(m.group(1)), int(m.group(2)), int(m.group(3)), int(m.group(4)))
+            for m in re.finditer(pattern, output)
+        ]
+    except Exception:
+        _cached_monitors = []
+    return _cached_monitors
+
+
+def _get_monitor_size(root: tk.Tk) -> tuple[int, int]:
+    """Get pixel dimensions of the monitor containing the window's center.
+
+    Falls back to winfo_screenwidth/height if xrandr is unavailable.
+    """
+    monitors = _parse_monitors()
+    if monitors:
+        root.update_idletasks()
+        cx = root.winfo_x() + root.winfo_width() // 2
+        cy = root.winfo_y() + root.winfo_height() // 2
+        for mw, mh, mx, my in monitors:
+            if mx <= cx < mx + mw and my <= cy < my + mh:
+                return (mw, mh)
+        # Window center not in any monitor — use first
+        return (monitors[0][0], monitors[0][1])
+    return (root.winfo_screenwidth(), root.winfo_screenheight())
+
+
+class PxvApp:
+    """Top-level application coordinator."""
+
+    def __init__(self, root: tk.Tk, file_list: FileList) -> None:
+        self.root = root
+        self.file_list = file_list
+        self.image_model = ImageModel()
+        self.enhancement_params = EnhancementParams()
+
+        # Will be set if the enhancement dialog is open
+        self.enhancement_dialog: EnhancementDialog | None = None
+        # AIDEV-NOTE: Toggles transparent-area compositing between white and black.
+        # Only affects display; saving always uses the true alpha channel.
+        self.dark_background: bool = False
+
+        # Create canvas view (passes right-click handler)
+        self.canvas_view = CanvasView(root, on_right_click=self._on_right_click)
+
+        # Context menu
+        self.context_menu = ContextMenu(root, self)
+
+        # Debounce for configure events
+        self._configure_after_id: str | None = None
+        # AIDEV-NOTE: Guard flag to prevent <Configure> feedback loop when we
+        # programmatically resize the window to match the image.
+        self._resizing_programmatically = False
+        self._deco_size: tuple[int, int] | None = None
+
+        self._bind_keys()
+        self._bind_configure()
+
+    def _get_decoration_size(self) -> tuple[int, int]:
+        """Measure window decoration overhead (borders + title bar).
+
+        Caches the result after first successful measurement.
+        Returns conservative defaults if the window isn't mapped yet.
+        """
+        if self._deco_size is not None:
+            return self._deco_size
+        self.root.update_idletasks()
+        border = self.root.winfo_rootx() - self.root.winfo_x()
+        titlebar = self.root.winfo_rooty() - self.root.winfo_y()
+        if border > 0 or titlebar > 0:
+            self._deco_size = (border * 2, titlebar + border)
+            return self._deco_size
+        # Conservative defaults for typical Linux WMs
+        return (8, 48)
+
+    def _get_max_image_size(self) -> tuple[int, int]:
+        """Maximum image display size that fits on the current monitor."""
+        mon_w, mon_h = _get_monitor_size(self.root)
+        deco_w, deco_h = self._get_decoration_size()
+        return (mon_w - deco_w, mon_h - deco_h)
+
+    def _bind_keys(self) -> None:
+        self.root.bind("<Key-q>", lambda _: commands.cmd_quit(self))
+        self.root.bind("<Key-c>", lambda _: commands.cmd_crop(self))
+        self.root.bind("<Key-A>", lambda _: commands.cmd_autocrop(self))
+        self.root.bind("<Key-u>", lambda _: commands.cmd_uncrop(self))
+        self.root.bind("<Key-n>", lambda _: commands.cmd_zoom_normal(self))
+        self.root.bind("<Key-e>", lambda _: commands.cmd_enhancement_dialog(self))
+        self.root.bind("<Key-comma>", lambda _: commands.cmd_zoom_reduce(self))
+        self.root.bind("<Key-period>", lambda _: commands.cmd_zoom_increase(self))
+        self.root.bind("<greater>", lambda _: commands.cmd_zoom_double(self))
+        self.root.bind("<less>", lambda _: commands.cmd_zoom_halve(self))
+        self.root.bind("<Key-M>", lambda _: commands.cmd_zoom_max(self))
+        self.root.bind("<Key-D>", lambda _: commands.cmd_toggle_background(self))
+        self.root.bind("<Key-t>", lambda _: commands.cmd_rotate(self, 270))
+        self.root.bind("<Key-T>", lambda _: commands.cmd_rotate(self, 90))
+        self.root.bind("<Control-s>", lambda _: commands.cmd_save_as(self))
+        self.root.bind("<space>", lambda _: commands.cmd_next_image(self))
+        self.root.bind("<Right>", lambda _: commands.cmd_next_image(self))
+        self.root.bind("<BackSpace>", lambda _: commands.cmd_prev_image(self))
+        self.root.bind("<Left>", lambda _: commands.cmd_prev_image(self))
+        self.root.bind("<Escape>", lambda _: self.canvas_view.clear_selection())
+        self.root.bind("<question>", lambda _: commands.cmd_help(self))
+
+    def _bind_configure(self) -> None:
+        """Debounced handler for window resize events."""
+        self.canvas_view.canvas.bind("<Configure>", self._on_configure)
+
+    def _on_configure(self, _event: tk.Event) -> None:
+        if self._resizing_programmatically:
+            return
+        if self._configure_after_id is not None:
+            self.root.after_cancel(self._configure_after_id)
+        self._configure_after_id = self.root.after(50, self._handle_resize)
+
+    def _handle_resize(self) -> None:
+        self._configure_after_id = None
+        if self.image_model.working_image is not None:
+            self._update_display()
+
+    def _on_right_click(self, event: tk.Event) -> None:
+        self.context_menu.show(event)
+
+    def load_current(self) -> None:
+        """Load the current file from the file list."""
+        path = self.file_list.current()
+        if path is None:
+            return
+        try:
+            self.image_model.load(path)
+        except Exception as e:
+            from tkinter import messagebox
+
+            messagebox.showerror("Open Error", f"Could not open {path.name}:\n{e}")
+            return
+
+        self.enhancement_params.reset()
+        if self.enhancement_dialog is not None:
+            self.enhancement_dialog.sync_sliders_from_params()
+        self.canvas_view.clear_selection()
+
+        # Fit to current monitor on load
+        max_w, max_h = self._get_max_image_size()
+        img_size = self.image_model.get_working_size()
+        self.canvas_view.zoom_fit(img_size, (max_w, max_h))
+
+        self.refresh_display()
+
+    def _bg_color(self) -> tuple[int, int, int]:
+        return (0, 0, 0) if self.dark_background else (255, 255, 255)
+
+    def refresh_display(self) -> None:
+        """Re-render the image with current zoom and enhancement params."""
+        display_img = self.image_model.get_display_image(
+            zoom=self.canvas_view.zoom,
+            params=self.enhancement_params,
+            bg_color=self._bg_color(),
+        )
+        if display_img is not None:
+            # AIDEV-NOTE: Resize window BEFORE display() so the canvas has correct
+            # dimensions when centering the image.
+            self._resize_window_to_image(display_img.width, display_img.height)
+            self.canvas_view.display(display_img)
+        self._update_title()
+
+    def _resize_window_to_image(self, img_w: int, img_h: int) -> None:
+        """Resize the window to fit the displayed image, capped at monitor bounds."""
+        max_w, max_h = self._get_max_image_size()
+        win_w = min(img_w, max_w)
+        win_h = min(img_h, max_h)
+        self._resizing_programmatically = True
+        self.root.geometry(f"{win_w}x{win_h}")
+        self.root.update_idletasks()
+        self._resizing_programmatically = False
+
+    def _update_display(self) -> None:
+        """Refresh display without changing zoom or window size (for resize events)."""
+        display_img = self.image_model.get_display_image(
+            zoom=self.canvas_view.zoom,
+            params=self.enhancement_params,
+            bg_color=self._bg_color(),
+        )
+        if display_img is not None:
+            self.canvas_view.display(display_img)
+        self._update_title()
+
+    def _update_title(self) -> None:
+        path = self.image_model.current_path
+        if path is not None:
+            name = path.name
+            pos = self.file_list.position_str()
+            w, h = self.image_model.get_working_size()
+            zoom_pct = int(self.canvas_view.zoom * 100)
+            self.root.title(f"pxv: {name} [{pos}] {w}x{h} ({zoom_pct}%)")
+        else:
+            self.root.title("pxv")
+
+
+def main() -> None:
+    """Entry point: parse args, create app, run main loop."""
+    parser = argparse.ArgumentParser(description="pxv - A Python xv image viewer")
+    parser.add_argument("paths", nargs="*", help="Image files or directories to open")
+    args = parser.parse_args()
+
+    root = tk.Tk(className="pxv")
+    root.title("pxv")
+    root.configure(bg="black")
+
+    # Set initial window size — 75% of current monitor, capped at reasonable max
+    mon_w, mon_h = _get_monitor_size(root)
+    win_w = min(int(mon_w * 0.75), 1200)
+    win_h = min(int(mon_h * 0.75), 900)
+    root.geometry(f"{win_w}x{win_h}")
+
+    paths = expand_paths(args.paths)
+    file_list = FileList(paths)
+    app = PxvApp(root, file_list)
+
+    if file_list.count() > 0:
+        # Delay loading until after mainloop starts so canvas has real dimensions
+        root.after(50, app.load_current)
+    else:
+        # No files: show open dialog after startup
+        root.after(100, lambda: commands.cmd_open(app))
+
+    root.mainloop()
+
+
+if __name__ == "__main__":
+    main()