feat: add sorting options

Author: radioactiveorange

README.md

@@ -23,13 +23,16 @@ A cross-platform desktop application for viewing random images from folders or c
 - [🛠️ Advanced Features](#️-advanced-features)
 - [🏗️ Technical Details](#️-technical-details)
 - [🎨 Screenshots](#-screenshots)
+- [🙏 Inspiration](#-inspiration)
 - [🤝 Contributing](#-contributing)
 - [📝 License](#-license)
 
 ## ✨ Features
 
-### 🎲 **Collections & Random Viewing**
+### 🎲 **Collections & Smart Sorting**
 - Organize multiple folders into collections
+- **Flexible sorting options**: Random (shuffle), Alphabetical (name), Full path, File size, Date modified
+- **Ascending/descending order** for all sort methods except random
 - Quick shuffle mode for single folders
 - History navigation with thumbnail panel
 
@@ -149,6 +152,8 @@ Alternatively, use "Quick Shuffle Folder" to browse any folder immediately.
 
 ### Collection Management
 - Professional startup dialog with ShuffleBird-inspired design
+- **Smart sorting system**: Choose between random shuffle or organized viewing (name, path, size, date)
+- **Flexible sort orders**: Ascending/descending options for structured browsing
 - Edit collections (rename, manage folders) 
 - Delete collections with confirmation
 - Auto-sorted by recent usage
@@ -209,6 +214,20 @@ Alternatively, use "Quick Shuffle Folder" to browse any folder immediately.
 
 ---
 
+## 🙏 Inspiration
+
+This project was inspired by and references several excellent applications:
+
+### Primary Inspirations
+- **[ShuffleBird](https://github.com/AvantinumCode/ShuffleBird)** - Random image viewer with clean interface design. Glimpse's startup dialog and professional UI aesthetic draw inspiration from ShuffleBird's polished approach to image collection management.
+
+- **[GestureSesh](https://github.com/AvantinumCode/GestureSesh)** - Figure drawing application with timer functionality. The timer system and media-style controls in Glimpse were influenced by GestureSesh's focus on timed practice sessions.
+
+### Design Philosophy
+We believe in building upon the excellent work of the open source community. These projects provided valuable insights into user experience design for image viewing applications and helped shape Glimpse's approach to collection management and viewing workflows.
+
+---
+
 ## 🤝 Contributing
 
 This project was built collaboratively with Claude Code. We welcome:

TODO.md

@@ -1,7 +1,10 @@
+## Code refactoring
+- [ ] refactor code so it will be easier to maintain
+
 ## Build and releasing
 - [x] update keyboard shortcuts; add more if needed
 - [x] update screenshots with all the new UI
-- [ ] setup github pipelines so we can create builds and releases and versioning and changelog. make it all automatic using semantic versioning. we need to build for windows, linux and mac if possible.
+- [x] setup github pipelines so we can create builds and releases and versioning and changelog. make it all automatic using semantic versioning. we need to build for windows, linux and mac if possible.
 
 ## Phase 1: Foundation & Code Quality
 - [x] Refactor the main.py and make it modular - easier to maintain

icons/sort_asc.svg

@@ -2,6 +2,7 @@
 
 import os
 import json
+import re
 from datetime import datetime
 from typing import List, Dict, Optional
 from PySide6.QtCore import QStandardPaths
@@ -13,12 +14,15 @@ class Collection:
     """Represents a collection of image folders."""
 
     def __init__(self, name: str, paths: List[str], created_date: Optional[str] = None, 
-                 last_used: Optional[str] = None, image_count: int = 0):
+                 last_used: Optional[str] = None, image_count: int = 0,
+                 sort_method: str = "random", sort_descending: bool = False):
         self.name = name
         self.paths = paths
         self.created_date = created_date or datetime.now().isoformat()
         self.last_used = last_used
         self.image_count = image_count
+        self.sort_method = sort_method  # "random", "name", "path", "size", "date"
+        self.sort_descending = sort_descending
 
     def to_dict(self) -> Dict:
         """Convert collection to dictionary for JSON serialization."""
@@ -27,7 +31,9 @@ def to_dict(self) -> Dict:
             'paths': self.paths,
             'created_date': self.created_date,
             'last_used': self.last_used,
-            'image_count': self.image_count
+            'image_count': self.image_count,
+            'sort_method': self.sort_method,
+            'sort_descending': self.sort_descending
         }
 
     @classmethod
@@ -38,7 +44,9 @@ def from_dict(cls, data: Dict) -> 'Collection':
             paths=data['paths'],
             created_date=data.get('created_date'),
             last_used=data.get('last_used'),
-            image_count=data.get('image_count', 0)
+            image_count=data.get('image_count', 0),
+            sort_method=data.get('sort_method', 'random'),
+            sort_descending=data.get('sort_descending', False)
         )
 
     def get_all_images(self) -> List[str]:
@@ -49,6 +57,68 @@ def get_all_images(self) -> List[str]:
                 all_images.extend(get_images_in_folder(path))
         return all_images
 
+    def get_sorted_images(self) -> List[str]:
+        """Get all images sorted according to the collection's sort method."""
+        images = self.get_all_images()
+        
+        if self.sort_method == "random":
+            import random
+            random.shuffle(images)
+        elif self.sort_method == "name":
+            def natural_sort_key(path):
+                """Generate a key for natural/human sorting of filenames.
+                
+                Converts 'image1.jpg', 'image10.jpg', 'image2.jpg' to sort as:
+                'image1.jpg', 'image2.jpg', 'image10.jpg'
+                """
+                name = os.path.basename(path).lower()
+                # Split the filename into text and number parts
+                parts = re.split(r'(\d+)', name)
+                # Convert numeric parts to integers for proper sorting
+                result = []
+                for part in parts:
+                    if part.isdigit():
+                        result.append(int(part))
+                    else:
+                        result.append(part)
+                return result
+            
+            images.sort(key=natural_sort_key, reverse=self.sort_descending)
+        elif self.sort_method == "path":
+            def natural_sort_key_path(path):
+                """Generate a key for natural/human sorting of full paths."""
+                name = path.lower()
+                # Split the path into text and number parts
+                parts = re.split(r'(\d+)', name)
+                # Convert numeric parts to integers for proper sorting
+                result = []
+                for part in parts:
+                    if part.isdigit():
+                        result.append(int(part))
+                    else:
+                        result.append(part)
+                return result
+            
+            images.sort(key=natural_sort_key_path, reverse=self.sort_descending)
+        elif self.sort_method == "size":
+            # Sort by file size, handling missing files gracefully
+            def get_size(path):
+                try:
+                    return os.path.getsize(path)
+                except (OSError, FileNotFoundError):
+                    return 0
+            images.sort(key=get_size, reverse=self.sort_descending)
+        elif self.sort_method == "date":
+            # Sort by modification date, handling missing files gracefully
+            def get_mtime(path):
+                try:
+                    return os.path.getmtime(path)
+                except (OSError, FileNotFoundError):
+                    return 0
+            images.sort(key=get_mtime, reverse=self.sort_descending)
+        
+        return images
+    
     def update_image_count(self):
         """Update the cached image count."""
         self.image_count = len(self.get_all_images())
@@ -142,12 +212,13 @@ def collection_exists(self, collection_name: str) -> bool:
         file_path = self._get_collection_file_path(collection_name)
         return os.path.exists(file_path)
 
-    def create_collection(self, name: str, paths: List[str]) -> Optional[Collection]:
-        """Create a new collection with the given paths."""
+    def create_collection(self, name: str, paths: List[str], sort_method: str = "random", 
+                         sort_descending: bool = False) -> Optional[Collection]:
+        """Create a new collection with the given paths and sorting options."""
         if self.collection_exists(name):
             return None  # Collection already exists
 
-        collection = Collection(name, paths)
+        collection = Collection(name, paths, sort_method=sort_method, sort_descending=sort_descending)
         collection.update_image_count()  # Calculate initial image count
 
         if self.save_collection(collection):

icons/sort_desc.svg

@@ -450,5 +450,63 @@ def _create_coded_icon(icon_type, size=24, color="#ffffff"):
         tab_y = folder_y - tab_height // 2
         painter.drawRoundedRect(margin, tab_y, tab_width, tab_height, 1, 1)
 
+    elif icon_type == "sort_asc":
+        # Sort ascending icon (triangle pointing up with lines)
+        painter.setBrush(Qt.NoBrush)
+        painter.setPen(pen)
+        
+        # Three horizontal lines getting shorter going up (representing sorted data)
+        line_spacing = size // 6
+        base_width = size - 2 * margin
+        
+        for i in range(3):
+            y = margin + size // 4 + i * line_spacing
+            width = base_width - (i * base_width // 4)  # Each line gets shorter
+            x = margin + (base_width - width) // 2  # Center the line
+            painter.drawLine(x, y, x + width, y)
+        
+        # Small triangle pointing up (indicating ascending direction)
+        triangle_size = size // 6
+        triangle_x = center
+        triangle_y = margin + size // 8
+        
+        points = [
+            QPoint(triangle_x, triangle_y),  # Top point
+            QPoint(triangle_x - triangle_size//2, triangle_y + triangle_size),  # Bottom left
+            QPoint(triangle_x + triangle_size//2, triangle_y + triangle_size)   # Bottom right
+        ]
+        painter.setBrush(brush)
+        painter.setPen(Qt.NoPen)
+        painter.drawPolygon(QPolygon(points))
+    
+    elif icon_type == "sort_desc":
+        # Sort descending icon (triangle pointing down with lines)
+        painter.setBrush(Qt.NoBrush)
+        painter.setPen(pen)
+        
+        # Three horizontal lines getting longer going down (representing sorted data)
+        line_spacing = size // 6
+        base_width = size - 2 * margin
+        
+        for i in range(3):
+            y = margin + size // 4 + i * line_spacing
+            width = base_width - ((2-i) * base_width // 4)  # Each line gets longer
+            x = margin + (base_width - width) // 2  # Center the line
+            painter.drawLine(x, y, x + width, y)
+        
+        # Small triangle pointing down (indicating descending direction)
+        triangle_size = size // 6
+        triangle_x = center
+        triangle_y = size - margin - size // 8
+        
+        points = [
+            QPoint(triangle_x - triangle_size//2, triangle_y - triangle_size),  # Top left
+            QPoint(triangle_x + triangle_size//2, triangle_y - triangle_size),  # Top right
+            QPoint(triangle_x, triangle_y)  # Bottom point
+        ]
+        painter.setBrush(brush)
+        painter.setPen(Qt.NoPen)
+        painter.drawPolygon(QPolygon(points))
+    
     painter.end()
     return QIcon(pixmap)