From 69150b2025acdd808d39307e6cf68325c2771b0a Mon Sep 17 00:00:00 2001 From: tanyar09 Date: Tue, 7 Oct 2025 15:04:32 -0400 Subject: [PATCH] Enhance Search GUI with detailed features and improved workflow This commit updates the README to reflect significant enhancements in the Search GUI, including new functionalities for photo selection, tagging, and sorting. Users can now view and manage tags through a dedicated popup, select multiple photos for bulk tagging, and utilize sortable columns for better navigation. The workflow for searching and managing photos has been clarified, providing a comprehensive guide for users to efficiently utilize the updated features. --- README.md | 34 ++++++++++++++++++++++++++++------ 1 file changed, 28 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 5d29458..9d6c64f 100644 --- a/README.md +++ b/README.md @@ -356,12 +356,34 @@ python3 photo_tagger.py search "Joh" python3 photo_tagger.py search-gui ``` -Search GUI features: -- Person column shows the matched person's full name -- 📁 column: click to open the file's folder (tooltip: "Open file location") -- 📷 column: click to open the photo (tooltip: "Open photo") -- Path column shows the absolute photo path -- Press Enter in the name field to trigger search +**🔍 Enhanced Search GUI Features:** +- **Person Column**: Shows the matched person's full name +- **📁 Column**: Click to open the file's folder (tooltip: "Open file location") +- **🏷️ Column**: Click to show photo tags in popup, hover for tag tooltip +- **Photo Path Column**: Click to open the photo (tooltip: "Open photo") +- **☑ Column**: Click to select/deselect photos for bulk tagging +- **Tag Selected Photos**: Button to open linkage dialog for selected photos +- **Clear All Selected**: Button to deselect all checkboxes +- **Enter Key**: Press Enter in the name field to trigger search +- **Sortable Columns**: Click column headers to sort by person name or photo path +- **Wider Window**: Optimized size to show all columns including checkbox column + +**🎯 Search GUI Workflow:** +1. **Search for Photos**: Enter a person's name and press Enter or click Search +2. **View Results**: See all photos containing that person in a sortable table +3. **Select Photos**: Click checkboxes (☑) to select photos for bulk operations +4. **View Tags**: Click 🏷️ icon to see all tags for a photo, or hover for quick preview +5. **Open Photos**: Click the photo path to open the photo in your default viewer +6. **Bulk Tagging**: Select multiple photos and click "Tag selected photos" to add tags +7. **Clear Selection**: Use "Clear all selected" to deselect all photos at once + +**🏷️ Tag Management in Search GUI:** +- **Tag Popup**: Click 🏷️ icon to see all tags for a photo in a scrollable popup +- **Tag Tooltip**: Hover over 🏷️ icon for quick tag preview (shows up to 5 tags) +- **Bulk Tag Dialog**: Select multiple photos and use "Tag selected photos" button +- **Add New Tags**: Type new tag names in the linkage dialog (auto-saves to database) +- **Remove Tags**: Use checkboxes in the linkage dialog to remove existing tags +- **Enter Key Support**: Press Enter in tag input field to quickly add tags ### Statistics ```bash