schenesort 2.1.1__tar.gz → 2.2.0__tar.gz

{schenesort-2.1.1 → schenesort-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: schenesort
-Version: 2.1.1
+Version: 2.2.0
 Summary: Wallpaper collection management CLI tool
 License-File: LICENSE
 Requires-Python: >=3.13
@@ -12,20 +12,40 @@ Requires-Dist: textual>=0.95.0
 Requires-Dist: typer>=0.21.1
 Description-Content-Type: text/markdown
 
-# Schenesort v2.1.1
+# Schenesort v2.2.0
 
-A CLI tool for managing wallpaper collections with AI-powered metadata, terminal UI browsing, and fast SQLite-based querying.
+A CLI tool for managing wallpaper collections with model generated metadata, terminal UI browsing, and SQLite-based
+querying.
+
+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
+
+Once you have a collection of wallpapers re-named with metadata sidecars, run the indexer over it to create a sqlitedb
+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.
 
 ## Installation
 
 ```bash
+uv tool install schenesort
+```
+
+For development:
+
+```bash
+git clone https://github.com/sthysel/schenesort.git
+cd schenesort
 uv sync
 ```
 
 ## Quick Start
 
 ```bash
-# Generate AI metadata for images
+# Generate metadata for images
 schenesort metadata generate ~/wallpapers -r
 
 # Browse with TUI
@@ -67,8 +87,16 @@ Browse your wallpaper collection with image preview and metadata display:
 ```bash
 schenesort browse ~/wallpapers
 schenesort browse ~/wallpapers -r  # recursive
+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         |
 |--------------|----------------|
@@ -104,6 +132,10 @@ schenesort get --random -n 10             # 10 random wallpapers
 schenesort get -1                         # single random wallpaper
 schenesort get -1 --mood dramatic         # random with filter
 
+# Browse results in TUI
+schenesort get --mood peaceful --browse   # open matches in browser
+schenesort get --style photography -b     # short form
+
 # For scripting (paths only)
 schenesort get -1 -p                      # just the path
 feh $(schenesort get -1 -p)               # set random wallpaper
@@ -304,15 +336,15 @@ Metadata is stored in standard XMP format, compatible with digiKam, darktable, a
 
 Images are tagged with recommended screen sizes based on resolution:
 
-| Screen | Resolution |
-|--------|------------|
-| 8K | 7680x4320 |
-| 5K | 5120x2880 |
-| 4K | 3840x2160 |
-| Ultrawide 4K | 5120x2160 |
-| Ultrawide 1440p | 3440x1440 |
-| 1440p | 2560x1440 |
-| 1080p | 1920x1080 |
-| 720p | 1280x720 |
+| Screen          | Resolution |
+|-----------------|------------|
+| 8K              | 7680x4320  |
+| 5K              | 5120x2880  |
+| 4K              | 3840x2160  |
+| Ultrawide 4K    | 5120x2160  |
+| Ultrawide 1440p | 3440x1440  |
+| 1440p           | 2560x1440  |
+| 1080p           | 1920x1080  |
+| 720p            | 1280x720   |
 
 An image is recommended for a screen size if it can cover the screen without upscaling.

{schenesort-2.1.1 → schenesort-2.2.0}/README.md

@@ -1,17 +1,37 @@
-# Schenesort v2.1.1
+# Schenesort v2.2.0
 
-A CLI tool for managing wallpaper collections with AI-powered metadata, terminal UI browsing, and fast SQLite-based querying.
+A CLI tool for managing wallpaper collections with model generated metadata, terminal UI browsing, and SQLite-based
+querying.
+
+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
+
+Once you have a collection of wallpapers re-named with metadata sidecars, run the indexer over it to create a sqlitedb
+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.
 
 ## Installation
 
 ```bash
+uv tool install schenesort
+```
+
+For development:
+
+```bash
+git clone https://github.com/sthysel/schenesort.git
+cd schenesort
 uv sync
 ```
 
 ## Quick Start
 
 ```bash
-# Generate AI metadata for images
+# Generate metadata for images
 schenesort metadata generate ~/wallpapers -r
 
 # Browse with TUI
@@ -53,8 +73,16 @@ Browse your wallpaper collection with image preview and metadata display:
 ```bash
 schenesort browse ~/wallpapers
 schenesort browse ~/wallpapers -r  # recursive
+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         |
 |--------------|----------------|
@@ -90,6 +118,10 @@ schenesort get --random -n 10             # 10 random wallpapers
 schenesort get -1                         # single random wallpaper
 schenesort get -1 --mood dramatic         # random with filter
 
+# Browse results in TUI
+schenesort get --mood peaceful --browse   # open matches in browser
+schenesort get --style photography -b     # short form
+
 # For scripting (paths only)
 schenesort get -1 -p                      # just the path
 feh $(schenesort get -1 -p)               # set random wallpaper
@@ -290,15 +322,15 @@ Metadata is stored in standard XMP format, compatible with digiKam, darktable, a
 
 Images are tagged with recommended screen sizes based on resolution:
 
-| Screen | Resolution |
-|--------|------------|
-| 8K | 7680x4320 |
-| 5K | 5120x2880 |
-| 4K | 3840x2160 |
-| Ultrawide 4K | 5120x2160 |
-| Ultrawide 1440p | 3440x1440 |
-| 1440p | 2560x1440 |
-| 1080p | 1920x1080 |
-| 720p | 1280x720 |
+| Screen          | Resolution |
+|-----------------|------------|
+| 8K              | 7680x4320  |
+| 5K              | 5120x2880  |
+| 4K              | 3840x2160  |
+| Ultrawide 4K    | 5120x2160  |
+| Ultrawide 1440p | 3440x1440  |
+| 1440p           | 2560x1440  |
+| 1080p           | 1920x1080  |
+| 720p            | 1280x720   |
 
 An image is recommended for a screen size if it can cover the screen without upscaling.

{schenesort-2.1.1 → schenesort-2.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "schenesort"
-version = "2.1.1"
+version = "2.2.0"
 description = "Wallpaper collection management CLI tool"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -56,7 +56,7 @@ testpaths = ["tests"]
 pythonpath = ["src"]
 
 [tool.bumpversion]
-current_version = "2.1.1"
+current_version = "2.2.0"
 commit = true
 tag = true
 tag_name = "v{new_version}"

{schenesort-2.1.1 → schenesort-2.2.0}/src/schenesort/cli.py

@@ -444,6 +444,9 @@ def get(
     paths_only: Annotated[
         bool, typer.Option("--paths-only", "-p", help="Output only file paths (for scripting)")
     ] = False,
+    browse: Annotated[
+        bool, typer.Option("--browse", "-b", help="Open results in TUI browser")
+    ] = False,
 ) -> None:
     """Query wallpapers by metadata attributes."""
     from schenesort.db import WallpaperDB
@@ -472,7 +475,13 @@ def get(
             typer.echo("No wallpapers found matching criteria.", err=True)
             raise typer.Exit(1)
 
-        if paths_only:
+        if browse:
+            from schenesort.tui import WallpaperBrowser
+
+            files = [Path(r["path"]) for r in results]
+            app_instance = WallpaperBrowser(files=files)
+            app_instance.run()
+        elif paths_only:
             for r in results:
                 typer.echo(r["path"])
         else:
@@ -542,7 +551,10 @@ def stats() -> None:
 
 @app.command()
 def browse(
-    path: Annotated[Path, typer.Argument(help="Directory or file to browse")],
+    path: Annotated[
+        Path | None,
+        typer.Argument(help="Directory or file to browse (default: config wallpaper path)"),
+    ] = None,
     recursive: Annotated[
         bool, typer.Option("--recursive", "-r", help="Browse directories recursively")
     ] = False,
@@ -550,6 +562,15 @@ def browse(
     """Browse wallpapers in a terminal UI with image preview and metadata display."""
     from schenesort.tui import WallpaperBrowser
 
+    if path is None:
+        cfg = load_config()
+        if cfg.wallpaper_path:
+            path = Path(cfg.wallpaper_path).expanduser()
+        else:
+            typer.echo("Error: No path provided and no wallpaper path configured.", err=True)
+            typer.echo("Set paths.wallpaper in config or provide a path argument.", err=True)
+            raise typer.Exit(1)
+
     path = path.resolve()
 
     if not path.exists():
@@ -572,22 +593,17 @@ def config(
     config_path = get_config_path()
 
     if create:
+        already_existed = config_path.exists()
         path = create_default_config()
-        if path.exists():
-            typer.echo(f"Config file: {path}")
-            if path == config_path:
-                typer.echo("(already existed)" if not create else "(created)")
-    else:
+        typer.echo(f"Config file: {path}")
+        typer.echo("(already existed)" if already_existed else "(created)")
+
+    if config_path.exists():
+        typer.echo(f"Config file: {config_path}\n")
+        typer.echo(config_path.read_text())
+    elif not create:
         typer.echo(f"Config file: {config_path}")
-        if config_path.exists():
-            typer.echo("\nCurrent settings:")
-            cfg = load_config()
-            typer.echo(f"  ollama.host: {cfg.ollama_host or '(default: localhost:11434)'}")
-            typer.echo(f"  ollama.model: {cfg.ollama_model}")
-            if cfg.wallpaper_path:
-                typer.echo(f"  paths.wallpaper: {cfg.wallpaper_path}")
-        else:
-            typer.echo("(file does not exist, use --create to create)")
+        typer.echo("(file does not exist, use --create to create)")
 
 
 DEFAULT_MODEL = "llava"
@@ -1108,20 +1124,27 @@ def metadata_generate(
             metadata = existing
             metadata.description = str(description)
             metadata.ai_model = effective_model
-            if isinstance(result.get("scene"), str):
-                metadata.scene = result["scene"]
-            if isinstance(result.get("tags"), list):
-                metadata.tags = result["tags"]
-            if isinstance(result.get("mood"), list):
-                metadata.mood = result["mood"]
-            if isinstance(result.get("style"), str):
-                metadata.style = result["style"]
-            if isinstance(result.get("colors"), list):
-                metadata.colors = result["colors"]
-            if isinstance(result.get("time"), str):
-                metadata.time_of_day = result["time"]
-            if isinstance(result.get("subject"), str):
-                metadata.subject = result["subject"]
+            scene = result.get("scene")
+            if isinstance(scene, str):
+                metadata.scene = scene
+            tags = result.get("tags")
+            if isinstance(tags, list):
+                metadata.tags = tags
+            mood = result.get("mood")
+            if isinstance(mood, list):
+                metadata.mood = mood
+            style = result.get("style")
+            if isinstance(style, str):
+                metadata.style = style
+            colors = result.get("colors")
+            if isinstance(colors, list):
+                metadata.colors = colors
+            time_val = result.get("time")
+            if isinstance(time_val, str):
+                metadata.time_of_day = time_val
+            subject = result.get("subject")
+            if isinstance(subject, str):
+                metadata.subject = subject
 
             # Add image dimensions
             width, height = get_image_dimensions(target_path)

{schenesort-2.1.1 → schenesort-2.2.0}/src/schenesort/config.py

@@ -73,7 +73,15 @@ def load_config() -> Config:
 
         return config
 
-    except Exception:
+    except tomllib.TOMLDecodeError as e:
+        import sys
+
+        print(f"Warning: Failed to parse config file: {e}", file=sys.stderr)
+        return Config()
+    except Exception as e:
+        import sys
+
+        print(f"Warning: Failed to load config file: {e}", file=sys.stderr)
         return Config()
 
 

{schenesort-2.1.1 → schenesort-2.2.0}/src/schenesort/tui/app.py

@@ -73,10 +73,16 @@ class WallpaperBrowser(App):
         Binding("end", "last_image", "Last", show=False),
     ]
 
-    def __init__(self, path: Path, recursive: bool = False) -> None:
+    def __init__(
+        self,
+        path: Path | None = None,
+        recursive: bool = False,
+        files: list[Path] | None = None,
+    ) -> None:
         super().__init__()
         self._base_path = path
         self._recursive = recursive
+        self._files = files  # Pre-specified file list (from query results)
         self._images: list[Path] = []
         self._current_index: int = 0
 
@@ -99,7 +105,15 @@ class WallpaperBrowser(App):
             self._update_status("No images found", "")
 
     def _load_images(self) -> None:
-        """Load list of images from the specified path."""
+        """Load list of images from the specified path or file list."""
+        # If files were provided directly (e.g., from query results), use them
+        if self._files:
+            self._images = [f for f in self._files if f.exists()]
+            return
+
+        if self._base_path is None:
+            return
+
         if self._base_path.is_file():
             if self._base_path.suffix.lower() in VALID_IMAGE_EXTENSIONS:
                 self._images = [self._base_path]
@@ -128,12 +142,11 @@ class WallpaperBrowser(App):
         panel.update_metadata(metadata, current_image.name)
 
         # Update status
-        self._update_status(
-            str(current_image.relative_to(self._base_path))
-            if current_image.is_relative_to(self._base_path)
-            else current_image.name,
-            f"{self._current_index + 1}/{len(self._images)}",
-        )
+        if self._base_path and current_image.is_relative_to(self._base_path):
+            display_path = str(current_image.relative_to(self._base_path))
+        else:
+            display_path = current_image.name
+        self._update_status(display_path, f"{self._current_index + 1}/{len(self._images)}")
 
     def _update_status(self, left: str, right: str) -> None:
         """Update the status bar."""

{schenesort-2.1.1 → schenesort-2.2.0}/src/schenesort/tui/widgets/image_preview.py

@@ -20,8 +20,10 @@ class ImagePreview(Container):
     }
 
     ImagePreview Image {
-        width: 100%;
-        height: 100%;
+        width: auto;
+        height: auto;
+        max-width: 100%;
+        max-height: 100%;
     }
 
     ImagePreview .no-image {