Sniffly Toolbar Feature Targets

Vision

Redesign the Sniffly toolbar to match SpaceSniffer's usability while maintaining clean, intuitive design. Focus on most-used operations with clear iconography.

---

Phase 1: Core Toolbar Redesign (PRIORITY)

Remove

• Quit button - Defer to OS window close button (red X on macOS, X on Windows/Linux)

Add/Reorganize

Left Section

1. Open Directory Button (Filing Cabinet Icon)

   • Opens OS native file picker (GtkFileChooserDialog)
   • Allows user to select directory to scan
   • Keyboard shortcut: Cmd+O / Ctrl+O

2. Path Display (Read-only text entry or label)

   • Shows current scan root path
   • Click filing cabinet icon next to it to trigger Open Directory
   • Should support text selection for copy/paste

3. Scan Button (Magnifying Glass Icon)

   • Positioned immediately after path display
   • Triggers rescan of current directory
   • Keyboard shortcut: F5 or Cmd+R

4. Progress Bar

   • Keep current implementation
   • Expands to fill remaining space
   • Shows scan progress with percentage

Right Section (floated right)

1. Open in Finder/Explorer Button (File with Arrow Icon)

   • Opens currently selected item in OS file browser
   • macOS: open -R <path> (reveals in Finder)
   • Linux: xdg-open <path> or nautilus <path>
   • Windows: explorer /select,<path>
   • Disabled when no selection
   • Keyboard shortcut: Cmd+Shift+R / Ctrl+Shift+R

2. Delete Button (Red Trash/X Icon)

   • Deletes currently selected item
   • Priority: System trash → rm command as fallback
   • Shows confirmation dialog
   • Disabled when no selection
   • Keyboard shortcut: d or Delete
   • Right-click context menu also triggers this

---

Phase 2: Enhanced File Operations

Additional Toolbar Buttons

1. Copy Path Button (Clipboard Icon)

   • Copies full path of selected item to clipboard
   • Keyboard shortcut: Cmd+Shift+C / Ctrl+Shift+C

2. Properties/Details Button (Info Icon)

   • Opens side panel or dialog with file/folder details:
     • Full path
     • Size (human-readable + bytes)
     • Item count (for directories)
     • Created/modified dates
     • Permissions
     • File type
   • Keyboard shortcut: i or Cmd+I

3. Refresh Button (Circular Arrow Icon)

   • Forces rescan without cache
   • Clears directory cache before scanning
   • Keyboard shortcut: Cmd+Shift+R / Ctrl+Shift+R

---

Phase 3: Search & Filter Features

Filter Toolbar (Second Row, Collapsible)

1. Search/Filter Entry

   • Filter by filename pattern (wildcards: *.txt, *cache*)
   • Live filtering as you type
   • Keyboard shortcut: Cmd+F / Ctrl+F to focus

2. File Type Filter Dropdown

   • Quick filters: All, Documents, Images, Videos, Audio, Archives, Code
   • Based on file extensions
   • Multiple selection support

3. Size Filter Range

   • Min/max size sliders or entry fields
   • Quick presets: "Large files (>100MB)", "Tiny files (<1MB)"

4. Date Filter

   • Filter by modified date: Last day, week, month, year, custom range
   • "Old files" (not modified in 1+ years) preset

5. Show Hidden Files Toggle

   • Toggle visibility of hidden files/folders (starting with .)
   • Keyboard shortcut: Cmd+Shift+H

---

Phase 4: Navigation & History

1. Back/Forward Buttons (Arrow Icons)

   • Navigate through directory history
   • Like a web browser
   • Keyboard shortcuts: Cmd+[ / Cmd+] or Alt+Left / Alt+Right

2. Up to Parent Button (Up Arrow Icon)

   • Navigate to parent directory
   • Alternative to Backspace key
   • Shows parent path in tooltip

3. Breadcrumb Navigation (Already implemented!)

   • Enhance: Make each path segment clickable
   • Click any segment to jump to that level

---

Phase 5: Advanced Features (SpaceSniffer Parity)

View Options

1. Toggle File Extensions

   • Show/hide file extensions in labels
   • Keyboard shortcut: e

2. Age-based Coloring

   • Color files by modification date:
     • Blue = Recent (< 1 month)
     • Yellow = Medium (1-12 months)
     • Red = Old (> 1 year)
   • Toggle on/off

3. Size Display Mode

   • Toggle between actual size vs. allocated size (disk usage)
   • Useful for showing real disk space usage

Export & Reporting

1. Export to CSV/JSON

   • Export directory tree with sizes
   • Useful for archiving or analysis

2. Copy File List

   • Copy list of all files matching current filter
   • Plain text format, one path per line

Multi-Selection

1. Multiple Selection Support

   • Cmd+Click / Ctrl+Click to select multiple items
   • Shift+Click to select range
   • Show total size of selection in status bar
   • Bulk delete support

2. Select All Matching Pattern

   • Select all items matching a wildcard pattern
   • Example: "Select all *.log files"

Comparison Mode

1. Compare Two Scans
   • Scan directory, then scan again later
   • Highlight differences (new, deleted, grown, shrunk files)
   • Useful for tracking disk usage changes over time

---

Implementation Notes

Icon Sources

• Use GTK stock icons where possible (gtk_image_new_from_icon_name)
• Common icon names:
  • folder-open - Open directory
  • view-refresh - Rescan/refresh
  • edit-find - Search
  • edit-delete - Delete
  • edit-copy - Copy path
  • document-properties - Properties/info
  • go-up - Navigate up
  • go-previous / go-next - Back/forward
  • document-open - Open in Finder

GTK Components Needed

• GtkFileChooserDialog - For directory picker
• GtkPopover or GtkDialog - For properties panel
• GtkEntry - For search/filter input
• GtkComboBox - For filter dropdowns
• GtkSwitch - For toggles (hidden files, etc.)
• GtkClipboard - For copy path functionality

Platform-Specific Code

• Open in Finder/Explorer: Use system commands via iso_c_binding
• Delete to Trash:
  • macOS: osascript -e 'tell app "Finder" to delete POSIX file "..."'
  • Linux: gio trash <path> or trash-put <path>
  • Fallback: rm -rf with confirmation
• Copy to Clipboard: Use GTK clipboard API

Keyboard Shortcuts Summary

Shortcut	Action
Cmd+O / Ctrl+O	Open directory picker
F5 / Cmd+R	Rescan current directory
Cmd+Shift+R	Open in Finder/Explorer
d / Delete	Delete selected item
Cmd+Shift+C	Copy path to clipboard
i / Cmd+I	Show properties
Cmd+F	Focus search/filter
Cmd+Shift+H	Toggle hidden files
Cmd+[ / Cmd+]	Back/forward in history
Backspace	Navigate to parent
q	Quit (already implemented)
Space	Select item (already implemented)
Enter	Navigate into item (already implemented)
Arrow keys	Navigate treemap (already implemented)

---

Current Status (Updated 2025-11-05)

• ✅ Basic toolbar with Scan button
• ✅ Progress bar (moved to toolbar)
• ✅ Breadcrumb display (path only, not clickable yet)
• ✅ Keyboard navigation (arrows, enter, backspace, space)
• ✅ Mouse hover and selection
• ✅ Directory caching for fast re-scans
• ✅ Phase 1 Complete: Open Directory, Path Display, Scan, Open in Finder, Copy Path, Delete buttons
• ✅ Tooltips: Hover shows filename, size, item count
• ✅ Status Bar Stats: Shows "N items (M files) - X.XX GB"
• ✅ Color by File Type: Images, videos, audio, documents, code, archives colored
• ✅ Size Labels: Shows formatted sizes on rectangles (when space permits)
• ✅ Copy Path to Clipboard: Toolbar button + Cmd+Shift+C shortcut
• ✅ Cushioned Treemap: Van Wijk algorithm for 3D shading effect

Next Steps

1. ✅ Implement Phase 1 core toolbar redesign DONE
2. ✅ Add GtkFileChooserDialog for directory picker DONE
3. ✅ Implement "Open in Finder" functionality DONE
4. ✅ Add delete functionality with system trash support DONE
5. Enhance breadcrumb bar to be clickable (navigate to parent levels)
6. Add keyboard shortcut handler for Copy Path (Cmd+Shift+C)
7. Implement context menu (right-click)
8. Add Properties/Info dialog
9. Implement Back/Forward navigation history

---

Design Decisions (CONFIRMED)

• ✅ Drag-and-drop: YES - Drag directory onto app window to initiate scan
• ✅ Filter toolbar: Always visible (we have plenty of header space)
• ✅ Context menu: YES - Right-click context menu on selections
• ✅ Undo for delete: YES - Implement Cmd/Ctrl+Z undo for delete operations
• ✅ Settings dialog: Defer to later phases

Priority: ALL FEATURES - Full SpaceSniffer parity!