schenesort 2.2.0__py3-none-any.whl → 2.4.0__py3-none-any.whl

schenesort/tui/widgets/thumbnail_grid.py

@@ -0,0 +1,291 @@
+"""Thumbnail grid widget for gallery view."""
+
+from pathlib import Path
+
+from textual.app import ComposeResult
+from textual.binding import Binding
+from textual.containers import Container, VerticalScroll
+from textual.message import Message
+from textual.widgets import Static
+from textual_image.widget import Image
+
+from schenesort.thumbnails import get_thumbnail_path, thumbnail_exists
+
+
+class ThumbnailText(Static):
+    """Text fallback for when no thumbnail exists."""
+
+    DEFAULT_CSS = """
+    ThumbnailText {
+        width: 32;
+        height: 14;
+        content-align: center middle;
+        text-align: center;
+        color: $text-muted;
+        background: $surface;
+    }
+
+    ThumbnailText.selected {
+        border: solid $primary;
+    }
+    """
+
+    def __init__(self, image_path: Path, index: int, **kwargs) -> None:
+        name = image_path.stem
+        if len(name) > 28:
+            name = name[:25] + "..."
+        super().__init__(name, **kwargs)
+        self.image_path = image_path
+        self.index = index
+
+
+# Type alias for cell widgets
+CellWidget = Image | ThumbnailText
+
+
+def create_thumbnail_cell(image_path: Path, index: int) -> CellWidget:
+    """Create a cell widget for the given image using its thumbnail."""
+    if thumbnail_exists(image_path):
+        thumb_path = get_thumbnail_path(image_path)
+        img = Image(thumb_path)
+        # Store metadata on the widget
+        img.image_path = image_path  # type: ignore[attr-defined]
+        img.index = index  # type: ignore[attr-defined]
+        return img
+    return ThumbnailText(image_path, index)
+
+
+class ThumbnailGrid(VerticalScroll, can_focus=True):
+    """Scrollable grid of image thumbnails with keyboard navigation."""
+
+    BINDINGS = [
+        Binding("up", "move_up", "Up", show=False),
+        Binding("down", "move_down", "Down", show=False),
+        Binding("left", "move_left", "Left", show=False),
+        Binding("right", "move_right", "Right", show=False),
+        Binding("k", "move_up", "Up", show=False),
+        Binding("j", "move_down", "Down", show=False),
+        Binding("h", "move_left", "Left", show=False),
+        Binding("l", "move_right", "Right", show=False),
+        Binding("enter", "select", "Select", show=False),
+        Binding("home", "first", "First", show=False),
+        Binding("end", "last", "Last", show=False),
+        Binding("g", "first", "First", show=False),
+        Binding("G", "last", "Last", show=False, key_display="shift+g"),
+    ]
+
+    class ImageSelected(Message):
+        """Emitted when an image is selected (Enter pressed)."""
+
+        def __init__(self, image_path: Path, index: int) -> None:
+            self.image_path = image_path
+            self.index = index
+            super().__init__()
+
+    class SelectionChanged(Message):
+        """Emitted when the selection changes."""
+
+        def __init__(self, image_path: Path, index: int) -> None:
+            self.image_path = image_path
+            self.index = index
+            super().__init__()
+
+    DEFAULT_CSS = """
+    ThumbnailGrid {
+        width: 100%;
+        height: 100%;
+        background: $background;
+    }
+
+    ThumbnailGrid:focus {
+        border: solid $accent;
+    }
+
+    ThumbnailGrid #grid-container {
+        layout: grid;
+        grid-gutter: 0;
+        width: 100%;
+    }
+
+    ThumbnailGrid #grid-container Image {
+        width: 32;
+        height: 14;
+        margin: 0;
+        padding: 0;
+        border: solid $background;
+    }
+
+    ThumbnailGrid #grid-container Image.selected {
+        border: solid $primary;
+    }
+
+    ThumbnailGrid .empty-message {
+        color: $text-disabled;
+        text-style: italic;
+        text-align: center;
+        width: 100%;
+        padding: 4;
+    }
+    """
+
+    CELL_WIDTH = 32
+    CELL_HEIGHT = 14
+
+    def __init__(self, images: list[Path] | None = None, **kwargs) -> None:
+        super().__init__(**kwargs)
+        self._images: list[Path] = images or []
+        self._selected_index: int = 0
+        self._columns: int = 1
+        self._cells: list[CellWidget] = []
+        self._grid_container: Container | None = None
+
+    def compose(self) -> ComposeResult:
+        self._grid_container = Container(id="grid-container")
+        yield self._grid_container
+
+    def on_mount(self) -> None:
+        """Initialize the grid on mount."""
+        # Defer initial build to after layout
+        self.call_after_refresh(self._initial_build)
+
+    def _initial_build(self) -> None:
+        """Build grid after initial layout."""
+        self._calculate_columns()
+        self._rebuild_grid()
+
+    def on_resize(self) -> None:
+        """Recalculate columns when resized."""
+        old_columns = self._columns
+        self._calculate_columns()
+        if old_columns != self._columns:
+            self._rebuild_grid()
+
+    def _calculate_columns(self) -> None:
+        """Calculate number of columns based on container width."""
+        available_width = max(self.size.width - 2, self.CELL_WIDTH)
+        self._columns = max(1, available_width // self.CELL_WIDTH)
+
+    def _rebuild_grid(self) -> None:
+        """Rebuild the grid with current images and column count."""
+        if self._grid_container is None:
+            return
+
+        container = self._grid_container
+
+        # Clear all children from container
+        container.remove_children()
+        self._cells.clear()
+
+        if not self._images:
+            container.mount(Static("No images to display", classes="empty-message"))
+            return
+
+        # Update grid columns CSS
+        container.styles.grid_size_columns = self._columns
+
+        # Calculate and set container height based on rows
+        # (textual-image needs explicit height, not height: auto, to render in scroll containers)
+        num_rows = (len(self._images) + self._columns - 1) // self._columns
+        container_height = num_rows * self.CELL_HEIGHT
+        container.styles.height = container_height
+
+        # Create cells
+        for idx, image_path in enumerate(self._images):
+            cell = create_thumbnail_cell(image_path, idx)
+            self._cells.append(cell)
+            container.mount(cell)
+
+        # Update selection
+        self._update_selection()
+
+    def set_images(self, images: list[Path]) -> None:
+        """Update the images displayed in the grid."""
+        self._images = images
+        self._selected_index = 0 if images else -1
+        self._calculate_columns()
+        self._rebuild_grid()
+
+    def _update_selection(self) -> None:
+        """Update the visual selection state."""
+        for idx, cell in enumerate(self._cells):
+            if idx == self._selected_index:
+                cell.add_class("selected")
+            else:
+                cell.remove_class("selected")
+
+        # Scroll selected cell into view
+        if 0 <= self._selected_index < len(self._cells):
+            self._cells[self._selected_index].scroll_visible()
+
+    def _move_selection(self, delta: int) -> None:
+        """Move selection by delta amount."""
+        if not self._images:
+            return
+
+        new_index = self._selected_index + delta
+        new_index = max(0, min(len(self._images) - 1, new_index))
+
+        if new_index != self._selected_index:
+            self._selected_index = new_index
+            self._update_selection()
+            self.post_message(
+                self.SelectionChanged(self._images[self._selected_index], self._selected_index)
+            )
+
+    def action_move_up(self) -> None:
+        """Move selection up by one row."""
+        self._move_selection(-self._columns)
+
+    def action_move_down(self) -> None:
+        """Move selection down by one row."""
+        self._move_selection(self._columns)
+
+    def action_move_left(self) -> None:
+        """Move selection left by one cell."""
+        self._move_selection(-1)
+
+    def action_move_right(self) -> None:
+        """Move selection right by one cell."""
+        self._move_selection(1)
+
+    def action_first(self) -> None:
+        """Move selection to first image."""
+        if self._images:
+            self._selected_index = 0
+            self._update_selection()
+            self.post_message(
+                self.SelectionChanged(self._images[self._selected_index], self._selected_index)
+            )
+
+    def action_last(self) -> None:
+        """Move selection to last image."""
+        if self._images:
+            self._selected_index = len(self._images) - 1
+            self._update_selection()
+            self.post_message(
+                self.SelectionChanged(self._images[self._selected_index], self._selected_index)
+            )
+
+    def action_select(self) -> None:
+        """Select the current image (open in detail view)."""
+        if 0 <= self._selected_index < len(self._images):
+            self.post_message(
+                self.ImageSelected(self._images[self._selected_index], self._selected_index)
+            )
+
+    @property
+    def selected_image(self) -> Path | None:
+        """Get the currently selected image path."""
+        if 0 <= self._selected_index < len(self._images):
+            return self._images[self._selected_index]
+        return None
+
+    @property
+    def selected_index(self) -> int:
+        """Get the currently selected index."""
+        return self._selected_index
+
+    @property
+    def image_count(self) -> int:
+        """Get the number of images in the grid."""
+        return len(self._images)

{schenesort-2.2.0.dist-info → schenesort-2.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: schenesort
-Version: 2.2.0
+Version: 2.4.0
 Summary: Wallpaper collection management CLI tool
 License-File: LICENSE
 Requires-Python: >=3.13
@@ -12,12 +12,14 @@ Requires-Dist: textual>=0.95.0
 Requires-Dist: typer>=0.21.1
 Description-Content-Type: text/markdown
 
-# Schenesort v2.2.0
+# Schenesort v2.4.0
 
-A CLI tool for managing wallpaper collections with model generated metadata, terminal UI browsing, and SQLite-based
-querying.
+![Collage example](docs/collage.png)
+
+A cli tool for managing wallpaper collections with model generated metadata, sweet tui, and sql metadata querying.
+
+schenesort takes a directory of random wallpapers, with random filenames, and uses olama with a decent vision model to:
 
-schenesort takes a directory of random wallpapers, with random filenames, and uses olama with a decent vision model to
 - look at each wallpaper
 - rename the wallpaper to something sensible
 - drop a XMP sidecar with metadata about the file
@@ -26,7 +28,7 @@ Once you have a collection of wallpapers re-named with metadata sidecars, run th
 that can be queried to retrieve suggestions based on tags, colours, names and the like. Then use `get` to get a
 wallpaper path `feh $(schenesort get -1 -p)` or `hyprctl hyprpaper wallpaper "eDP-1,$(schenesort get -1 -p)"`
 
-schenesort also provides a bunch of utility commands to satisfy a gooner collection.
+![Browse example - Autumn](docs/browse-destruction.png)
 
 ## Installation
 
@@ -44,16 +46,25 @@ uv sync
 
 ## Quick Start
 
+To generate metadata you need a olama server serving llava nearby, it takes a minute to set one up see [ollama
+setup](./ollama-setup.md).
+
 ```bash
 # Generate metadata for images
 schenesort metadata generate ~/wallpapers -r
 
-# Browse with TUI
-schenesort browse ~/wallpapers
-
 # Index the collection
 schenesort index ~/wallpapers
 
+# Generate thumbnails for gallery
+schenesort thumbnail ~/wallpapers -r
+
+# Browse with gallery (thumbnail grid with filters)
+schenesort gallery
+
+# Browse single images with TUI
+schenesort browse ~/wallpapers
+
 # Query wallpapers
 schenesort get --mood peaceful --screen 4K
 schenesort get -1 -p | xargs feh  # random wallpaper
@@ -64,6 +75,8 @@ schenesort get -1 -p | xargs feh  # random wallpaper
 | Command                      | Description                                         |
 |------------------------------|-----------------------------------------------------|
 | `browse`                     | Terminal UI browser with image preview and metadata |
+| `gallery`                    | Thumbnail grid browser with filters                 |
+| `thumbnail`                  | Generate thumbnail cache for gallery                |
 | `index`                      | Build SQLite index for fast querying                |
 | `get`                        | Query wallpapers by metadata attributes             |
 | `stats`                      | Show collection statistics from index               |
@@ -74,6 +87,7 @@ schenesort get -1 -p | xargs feh  # random wallpaper
 | `info`                       | Show collection file statistics                     |
 | `describe`                   | AI-rename images based on content (Ollama)          |
 | `models`                     | List available Ollama models                        |
+| `collage`                    | Create a collage grid from matching wallpapers      |
 | `metadata show`              | Display XMP sidecar metadata                        |
 | `metadata set`               | Manually set metadata fields                        |
 | `metadata generate`          | Generate metadata with AI (Ollama)                  |
@@ -91,13 +105,12 @@ schenesort browse                  # uses paths.wallpaper from config
 schenesort get --mood peaceful -b  # browse query results
 ```
 
-![Browse example - Greek](docs/browse-greek.png)
-
 ![Browse example - Autumn](docs/browse-autumn.png)
 
 ![Browse example - Stallman](docs/browse-stallman.png)
 
 **Keyboard shortcuts:**
+
 | Key          | Action         |
 |--------------|----------------|
 | `j` / `Down` | Next image     |
@@ -109,6 +122,63 @@ schenesort get --mood peaceful -b  # browse query results
 
 The TUI uses textual-image for rendering, which auto-detects terminal graphics support (Sixel, iTerm2, Kitty).
 
+## Gallery Browser
+
+Browse your indexed collection with a thumbnail grid and filter panel:
+
+```bash
+# Open gallery browser
+schenesort gallery
+
+# Pre-filter results
+schenesort gallery --mood peaceful
+schenesort gallery --tag nature --style photography
+```
+
+The gallery requires an indexed collection (`schenesort index`) and cached thumbnails for fast loading.
+
+### Generate Thumbnails
+
+```bash
+# Generate thumbnails for a directory
+schenesort thumbnail ~/wallpapers
+
+# Recursive with progress bar
+schenesort thumbnail ~/wallpapers -r
+
+# Force regenerate all thumbnails
+schenesort thumbnail ~/wallpapers --force
+
+# Clear thumbnail cache
+schenesort thumbnail ~/wallpapers --clear
+```
+
+Thumbnails are cached at `~/.cache/schenesort/thumbnails/` (320x200 JPEG).
+
+**Gallery keyboard shortcuts:**
+
+| Key              | Action                |
+|------------------|-----------------------|
+| `j` / `Down`     | Move down             |
+| `k` / `Up`       | Move up               |
+| `h` / `Left`     | Move left             |
+| `l` / `Right`    | Move right            |
+| `g` / `Home`     | First image           |
+| `G` / `End`      | Last image            |
+| `Enter`          | Open detail view      |
+| `Tab`            | Switch panel          |
+| `Escape`         | Clear filters         |
+| `r`              | Refresh               |
+| `q` / `Ctrl+C`   | Quit                  |
+
+**Detail view shortcuts:**
+
+| Key              | Action                |
+|------------------|-----------------------|
+| `j` / `Down`     | Next image            |
+| `k` / `Up`       | Previous image        |
+| `Escape` / `q`   | Back to grid          |
+
 ## Collection Indexing and Querying
 
 Build a SQLite index for fast querying across your entire collection:
@@ -147,6 +217,38 @@ schenesort stats
 
 The database is stored at `$XDG_DATA_HOME/schenesort/index.db` (default: `~/.local/share/schenesort/index.db`).
 
+## Collage Generation
+
+Create a collage grid (up to 4x4) from wallpapers matching query criteria:
+
+```bash
+# Create a 2x2 collage (default)
+schenesort collage output.png --mood peaceful
+
+# Create a 4x4 collage of landscape images
+schenesort collage wall.png --subject landscape --cols 4 --rows 4
+
+# Custom tile size (default: 480x270)
+schenesort collage collage.png --tile-width 640 --tile-height 360
+
+# Combine filters
+schenesort collage night_cities.png --time night --subject urban --cols 3 --rows 2
+```
+
+`schenesort collage landscape.png --cols 4 --rows 4 --tile-width 640 --tile-height 360 --tag landscape`
+
+![Collage example](docs/landscape.png)
+
+| Option          | Description                          | Default |
+|-----------------|--------------------------------------|---------|
+| `--cols`        | Number of columns (1-4)              | 2       |
+| `--rows`        | Number of rows (1-4)                 | 2       |
+| `--tile-width`  | Width of each tile in pixels         | 480     |
+| `--tile-height` | Height of each tile in pixels        | 270     |
+| `--random`      | Select images randomly               | True    |
+
+All `get` query filters are supported: `--tag`, `--mood`, `--color`, `--style`, `--subject`, `--time`, `--screen`, `--min-width`, `--min-height`, `--search`.
+
 ## Metadata Management
 
 Store metadata in XMP sidecar files (`.xmp`) alongside images without modifying the original files.
@@ -168,7 +270,7 @@ Store metadata in XMP sidecar files (`.xmp`) alongside images without modifying
 | `source`             | Source URL or info                                       |
 | `ai_model`           | Model used for metadata generation                       |
 
-### Generate Metadata with AI
+### Generate Metadata using ollama
 
 ```bash
 # Preview what would be generated
@@ -245,6 +347,7 @@ schenesort cleanup ~/wallpapers -r
 ## Configuration
 
 Schenesort follows XDG Base Directory spec:
+
 - Config: `$XDG_CONFIG_HOME/schenesort/config.toml` (default: `~/.config/schenesort/config.toml`)
 - Data: `$XDG_DATA_HOME/schenesort/index.db` (default: `~/.local/share/schenesort/index.db`)
 
@@ -322,7 +425,7 @@ See [schenesort.yazi/README.md](schenesort.yazi/README.md) for details.
 
 ## XMP Sidecar Format
 
-```
+```text
 ~/wallpapers/
 ├── mountain_sunset.jpg
 ├── mountain_sunset.jpg.xmp   ← metadata stored here

schenesort-2.4.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+schenesort/__init__.py,sha256=Z7bmXIWiFUCKj1j4JRlPZvmfzc4RC10Lh1WCKNsJn20,61
+schenesort/cli.py,sha256=TFq_AjH-PSJYAr7b14rXdXl7xEKovqNnt7SQAZ7psZE,55702
+schenesort/config.py,sha256=8EuYv2nma3QKnLPSAgAsaOHZlORzinHjy-Bj_LKPfJA,2739
+schenesort/db.py,sha256=RbfZN6d5O5MkTRPbu51fA7tQLOJf1huIjxFdoT4sESk,11398
+schenesort/thumbnails.py,sha256=-B4vlh2w_NdUkO0tshcpZPUSs6M8S6G_abiBPp3xVOY,3631
+schenesort/xmp.py,sha256=1VS_I4akY8Dv_KLPOdzPgBCFy0280oSCsMmo-_A9cNE,9749
+schenesort/tui/__init__.py,sha256=BsOc1PedYBguvYBpnny_T9ST-dIa_52xYWlLdNemha4,449
+schenesort/tui/app.py,sha256=HGKBnszTJXtLu9Mo7eJY4wiO2qkB7dFftBoM4GC_js4,6202
+schenesort/tui/grid_app.py,sha256=hrS-dEwQ9wFmcQz2ZT7jy6lYOdSCidEY5Zlfmpv8sI8,10032
+schenesort/tui/widgets/__init__.py,sha256=3cm7vfXG5-xC_UhIbgEtuMxq5I5tXg6okokJ4ecjGIE,202
+schenesort/tui/widgets/filter_panel.py,sha256=BZf8T1H4u4eTUj2bt6ILvQ3m_hwx20DRfc02YVJ4zQk,7273
+schenesort/tui/widgets/image_preview.py,sha256=j_KTQBJk0vbO18FzTo-GYkRlgerBe1K3VGQwMPbEuUw,2846
+schenesort/tui/widgets/metadata_panel.py,sha256=8DnsvDdKf3jzqHOo7dDmxJxL0Mjx5mX7HNwwcMUcJn0,4860
+schenesort/tui/widgets/thumbnail_grid.py,sha256=-81CL4pBI7Q7J_PD2MbeaI-SNckEdfuNZdA14m7q348,9407
+schenesort-2.4.0.dist-info/METADATA,sha256=rIqVFt9JgHlVGSbsG1irhOllNWNzD0zEGMUjduxXhWc,14698
+schenesort-2.4.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+schenesort-2.4.0.dist-info/entry_points.txt,sha256=J5lS-N6KgmzjutFi5bG1jv-4Wszbz3MfcOHcbznBVcw,50
+schenesort-2.4.0.dist-info/licenses/LICENSE,sha256=sMw3SMb9ec9dbM2twEMVeunsGwuljza-9kEXg4kSJpg,1070
+schenesort-2.4.0.dist-info/RECORD,,

schenesort-2.2.0.dist-info/RECORD

@@ -1,15 +0,0 @@
-schenesort/__init__.py,sha256=Z7bmXIWiFUCKj1j4JRlPZvmfzc4RC10Lh1WCKNsJn20,61
-schenesort/cli.py,sha256=lGbQ5nJ5TjusG7XlZfOVmdaCeef9eRO_a9JL1I-V_Fc,46291
-schenesort/config.py,sha256=8EuYv2nma3QKnLPSAgAsaOHZlORzinHjy-Bj_LKPfJA,2739
-schenesort/db.py,sha256=RbfZN6d5O5MkTRPbu51fA7tQLOJf1huIjxFdoT4sESk,11398
-schenesort/xmp.py,sha256=1VS_I4akY8Dv_KLPOdzPgBCFy0280oSCsMmo-_A9cNE,9749
-schenesort/tui/__init__.py,sha256=bqSyRlefPfsYhUxsub4Rltz7yjCQVPXvhzj9n2bn370,141
-schenesort/tui/app.py,sha256=HGKBnszTJXtLu9Mo7eJY4wiO2qkB7dFftBoM4GC_js4,6202
-schenesort/tui/widgets/__init__.py,sha256=3cm7vfXG5-xC_UhIbgEtuMxq5I5tXg6okokJ4ecjGIE,202
-schenesort/tui/widgets/image_preview.py,sha256=j_KTQBJk0vbO18FzTo-GYkRlgerBe1K3VGQwMPbEuUw,2846
-schenesort/tui/widgets/metadata_panel.py,sha256=8DnsvDdKf3jzqHOo7dDmxJxL0Mjx5mX7HNwwcMUcJn0,4860
-schenesort-2.2.0.dist-info/METADATA,sha256=FOfxFWXroyg2RtZxMCrHL1Bf5qC5d8OPeMb_3cHmK7M,11251
-schenesort-2.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-schenesort-2.2.0.dist-info/entry_points.txt,sha256=J5lS-N6KgmzjutFi5bG1jv-4Wszbz3MfcOHcbznBVcw,50
-schenesort-2.2.0.dist-info/licenses/LICENSE,sha256=sMw3SMb9ec9dbM2twEMVeunsGwuljza-9kEXg4kSJpg,1070
-schenesort-2.2.0.dist-info/RECORD,,