kryten-webqueue 0.6.3__tar.gz → 0.6.4__tar.gz

{kryten_webqueue-0.6.3 → kryten_webqueue-0.6.4}/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [0.6.4] - 2026-06-08
+
+### Changed
+
+- **Quality-weighted catalog browse ordering** — The catalog landing no longer leads with alphabetical junk (art-less, number-prefixed "02 - Episode" entries). Browse results are now ranked by signals derived entirely from existing data — no curation or featured-item maintenance required: (1) items with box art (cover or thumbnail) first, (2) then by real popularity (times queued, from `queue_history`), (3) titles beginning with a letter before number/symbol-prefixed titles, (4) then alphabetical for a stable tail. Applies to both the unfiltered landing and category-filtered browse; search continues to use full-text relevance.
+
+[0.6.4]: https://github.com/grobertson/kryten-webqueue/releases/tag/v0.6.4
+
 ## [0.6.3] - 2026-06-08
 
 ### Fixed

{kryten_webqueue-0.6.3 → kryten_webqueue-0.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kryten-webqueue
-Version: 0.6.3
+Version: 0.6.4
 Summary: Netflix/Tubi-style catalog browser and pay-to-play queue management for CyTube
 Author: grobertson
 License-Expression: MIT

{kryten_webqueue-0.6.3 → kryten_webqueue-0.6.4}/kryten_webqueue/catalog/db.py

@@ -238,7 +238,8 @@ class Database:
 
     async def browse(self, *, category: str | None = None, page: int = 1, per_page: int = 24) -> list[dict]:
         query = """
-            SELECT c.friendly_token, c.title, c.duration_sec, c.cover_art_path, c.thumbnail_url, c.manifest_url
+            SELECT c.friendly_token, c.title, c.duration_sec, c.cover_art_path, c.thumbnail_url, c.manifest_url,
+                   (SELECT COUNT(*) FROM queue_history qh WHERE qh.friendly_token = c.friendly_token) AS play_count
             FROM catalog c
             WHERE c.friendly_token NOT IN (
                 SELECT spi.media_id FROM saved_playlist_items spi
@@ -256,7 +257,22 @@ class Database:
                 )
             """
             params.append(category)
-        query += " ORDER BY c.title ASC LIMIT ? OFFSET ?"
+        # Quality-weighted ordering so the landing page leads with presentable
+        # items instead of alphabetical junk. No curation required — every signal
+        # is derived from existing data:
+        #   1. Items with box art (cover or thumbnail) first.
+        #   2. Then by real popularity (times queued).
+        #   3. Titles beginning with a letter before number/symbol-prefixed
+        #      "02 - Episode" style entries.
+        #   4. Finally alphabetical for a stable, predictable tail.
+        query += """
+            ORDER BY
+                (c.cover_art_path IS NOT NULL OR c.thumbnail_url IS NOT NULL) DESC,
+                play_count DESC,
+                (CASE WHEN c.title GLOB '[A-Za-z]*' THEN 0 ELSE 1 END) ASC,
+                c.title ASC
+            LIMIT ? OFFSET ?
+        """
         params.extend([per_page, (page - 1) * per_page])
         return await self._fetch_all(query, params)
 

{kryten_webqueue-0.6.3 → kryten_webqueue-0.6.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kryten-webqueue"
-version = "0.6.3"
+version = "0.6.4"
 description = "Netflix/Tubi-style catalog browser and pay-to-play queue management for CyTube"
 readme = "README.md"
 license = "MIT"