File Filter Copier v1.1.0 - The Native macOS & Customisation Update

This release marks a significant milestone for File Filter Copier, bringing full native macOS support via Swift, a robust custom theming engine, and a polished, professional startup experience.

🎨 New Theme Engine & Customisation

• Customisable UI: You can now fully personalise the application's look and feel. Change background, text, and accent colours to suit your workflow.
• Live Preview: The new "Theme & Colours" settings tab features a mini-replica preview, so you can see your changes instantly before applying them.
• Smart Defaults: Added a "Reset to Default" option to easily restore the original Slate Light and Dark themes.
• Dynamic Icon: The application dock icon and header logo now smartly switch between Light and Dark variants based on your active theme.

🍏 Native macOS Support

• Hardened Runtime: The Python backend is now fully signed and hardened, complying with Apple's strict security standards for Notarization and Direct Distribution.
• Swift Integration: The app now runs inside a native Swift wrapper using WKWebView, providing a seamless desktop experience without the overhead of a full browser.
• Smart Splash Screen: A completely redesigned splash screen now smoothly handles backend initialisation. It features rotating status messages (in British English 🇬🇧) and ensures the backend is 100% ready before fading gently into the main interface.

🛠 Fixes & Improvements

• British English Localisation: Standardised spelling across the entire application (Colours, Organisation, Initialising, etc.).
• Routing Fixes: Switched to Hash-based routing to fully support the file:// protocol used in the native macOS wrapper.
• CORS Updates: Configuring the backend to strictly allow local frontend communication, resolving "Network Error" issues in the native wrapper.
• Stability: Fixed a race condition where the main application would attempt to load before the Python backend was fully responsive.

Photo Mode Overhaul: GPS, Metadata & Enhanced Preview

This update brings a significant upgrade to the "Photo Mode" capabilities, allowing for deeper analysis and better organisation of image files.

📸 New Photo Mode Features
Deep Metadata Extraction: Now extracts comprehensive EXIF data including Camera Model, Lens, ISO, Aperture, Shutter Speed, and Dimensions.

Offline Reverse Geocoding: Automatically converts GPS coordinates from photos into readable "City, Country" locations without needing an internet connection.

Raw & HEIC Support: Improved support for extracting metadata from modern image formats (HEIC) and professional RAW files.

🖥️ UI & Preview Improvements
Resizable Columns: The Preview Table now supports manual column resizing—drag headers to adjust widths.

Horizontal Scrolling: The table now handles extensive metadata gracefully with a fixed layout and scroll support.

Customisable View: New toggles in the Settings Panel allow you to show/hide specific metadata columns to keep your view clean.

📂 Export Enhancements
Rich Data Export: HTML, CSV, Text, and Markdown exports now include all the new metadata fields (Location, Dimensions, Camera settings).

Fixed HTML Layout: Exported HTML reports now handle wide tables correctly with horizontal scrolling.

🐛 Fixes & Polish
Fixed layout issues where the preview table could appear blank or collapsed.

Corrected .gitignore rules to ensure app icons and assets are tracked correctly.

Updated backend dependencies (reverse_geocoder, pillow-heif) for better stability.

Intial Release

FILE FILTER COPIER
Version 1.0.0

File Filter Copier is a powerful desktop utility that scans folders, filters
files using advanced criteria (size, time, types, deep content), previews
results, and optionally copies them into a structured output folder with a log.

---

USER GUIDE

1. CHOOSE FOLDERS

   • Select a Source Folder to scan.
   • Optionally set a Destination Folder and Output Name.
   • Toggle "Dry Run" to preview results without copying files.

2. CONFIGURE FILTERS

   • Quick Filters: One-click presets (e.g., Recent <7d, Large Media).
   • Extensions: specific include/exclude lists.
   • Time: Rules like <10d (last 10 days) or >2h (older than 2 hours).
   • Size: Small (<1MB), Medium, Large, or Custom ranges.
   • File Types: Semantic categories (Documents, Media, Code, Archives).
   • Folder Exclusions: Skip 'node_modules', '.git', etc.
   • Deep Scan: Search inside files for specific keywords.
   • Advanced: Regex matching, hidden files, symlinks, and more.

3. PREVIEW & RUN

   • Click "Run Preview" to see a sortable table of matching files.
   • If satisfied, run the Copy operation to organise your files.
   • Duplicate filenames are automatically handled (file_1.ext).

---

FILTERS CHEAT SHEET

SIZE EXAMPLES:

• small (< 1 MB)
• large (10–100 MB)
• huge (> 100 MB)
• custom (e.g., custom:0-5MB or custom:100MB-inf)

TIME EXAMPLES:

• <7d (Within the last 7 days)

• 30d (Older than 30 days)

• <24h (Within the last 24 hours)

ADVANCED MATCHING:

• Glob: /src/ or *.md
• Regex: (^|/)test-.*.js$

---

TROUBLESHOOTING

• Deep Scan is slow:
  Only text files are read; binary files are skipped. To speed it up,
  reduce search terms or limit the scan by file size/type first.

• Copy failed / Destination not found:
  Ensure the destination folder path exists. The app creates the
  final output folder, but the parent destination must exist.

---

Copyright (c) 2025 FCM Tech / Marc Oliff
All rights reserved.