[Feature]: Filter Images by Search Term #79

Closed
opened 2026-06-13 16:41:48 +00:00 by ValleyGeek · 2 comments
Owner

Problem or use case

There's no means to filter images by file or directory name

Proposed solution

To the left of the Sort into folders button add

  • a new text input for search term
  • an 'x' button to clear the search box
  • a symbol button for search options
    • This opens a small menu, similar to the Tag Filter button
    • Toggles the menu to open and close.
  • A Vertical separator

Search Option Menu

  • Checkbox: File Name
    • True by default
    • Searches anywhere in the file name for the entered term
  • Checkbox: Directory Name
    • True by default
    • Searches anywhere in the relative directory path for the entered term
  • Checkbox: Image Meta Data (slow)
    • Searches tags and metadata from the image
    • Discover the data ad-hoc when checked and a search term is entered
      • cache image metadata in memory on first search, for faster second search
      • clear in-memory cache if box is unchecked
    • Perform search in background, adding images to the active filter as they are discovered

Alternatives considered

No response

### Problem or use case There's no means to filter images by file or directory name ### Proposed solution To the left of the `Sort into folders` button add - a new text input for search term - an 'x' button to clear the search box - a symbol button for search options - This opens a small menu, similar to the `Tag Filter` button - Toggles the menu to open and close. - A Vertical separator #### Search Option Menu - Checkbox: File Name - True by default - Searches anywhere in the file name for the entered term - Checkbox: Directory Name - True by default - Searches anywhere in the relative directory path for the entered term - Checkbox: Image Meta Data (slow) - Searches tags and metadata from the image - Discover the data ad-hoc when checked and a search term is entered - cache image metadata in memory on first search, for faster second search - clear in-memory cache if box is unchecked - Perform search in background, adding images to the active filter as they are discovered ### Alternatives considered _No response_
ValleyGeek changed title from [Feature]: Searching to [Feature]: Filtering Images by Search Term 2026-06-13 16:43:44 +00:00
ValleyGeek changed title from [Feature]: Filtering Images by Search Term to [Feature]: Filter Images by Search Term 2026-06-13 16:43:51 +00:00
Member

Implemented on branch 0.1.30/issue-79-search-filter (dev version 0.1.30-feature.79).

UI (main toolbar, left of Sort into Folders):

  • Search text field with × clear button
  • Options toggle button opening a popup (same interaction model as Tag Filter)
  • Vertical separator before Sort into Folders

Search options (defaults per issue):

  • File Name — on
  • Directory Name — on
  • Image Meta Data (slow) — off

Filter behavior:

  • Filename/directory/tag and DB-cached metadata fields match synchronously in ImageFilterProxy
  • When Image Meta Data is enabled, SearchMetadataWorker opens files in the background, caches extracted Pillow/EXIF text in memory, and incrementally adds matches via signals (threading contract: plain data only)
  • Cache clears when the metadata option is unchecked
  • Search term and options persist in session state

Tests: tests/test_search_filter.py (core helpers + proxy integration)

Ready for review; PR to main on request.

Implemented on branch `0.1.30/issue-79-search-filter` (dev version `0.1.30-feature.79`). **UI (main toolbar, left of Sort into Folders):** - Search text field with × clear button - Options toggle button opening a popup (same interaction model as Tag Filter) - Vertical separator before Sort into Folders **Search options (defaults per issue):** - File Name — on - Directory Name — on - Image Meta Data (slow) — off **Filter behavior:** - Filename/directory/tag and DB-cached metadata fields match synchronously in `ImageFilterProxy` - When Image Meta Data is enabled, `SearchMetadataWorker` opens files in the background, caches extracted Pillow/EXIF text in memory, and incrementally adds matches via signals (threading contract: plain data only) - Cache clears when the metadata option is unchecked - Search term and options persist in session state **Tests:** `tests/test_search_filter.py` (core helpers + proxy integration) Ready for review; PR to `main` on request.
Member

Resolved in PR for 0.1.31:

  • Main-toolbar search with clear and options controls
  • Tag filter precedence; search narrows within tag-filtered results
  • Search clears on directory open
  • Background metadata search with in-memory cache
  • Session persistence for search term and options

Branch 0.1.30/issue-79-search-filter is ready for merge.

Resolved in PR for `0.1.31`: - Main-toolbar search with clear and options controls - Tag filter precedence; search narrows within tag-filtered results - Search clears on directory open - Background metadata search with in-memory cache - Session persistence for search term and options Branch `0.1.30/issue-79-search-filter` is ready for merge.
Grok closed this issue 2026-06-14 15:47:14 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
ai-collab/bulk-image-organizer#79
No description provided.