A fast, modern macOS application for searching files in your home directory, inspired by Everything on Windows.

• Lightning-fast search: Indexes your home directory for instant file searching
• Modern UI: Clean, native macOS interface with SwiftUI
• Smart filtering: Intelligent search with exact matches prioritized
• Keyboard navigation: Use arrow keys to navigate, Enter to open files
• File metadata: Shows file size, modification date, and file type icons
• Context menu: Right-click for additional options like "Reveal in Finder"
• Background indexing: Non-blocking file indexing with progress indicator

• DMG Installer: Download McFind.dmg - Easy drag-and-drop installation
• PKG Installer: Download McFind.pkg - Professional installer package

1. DMG: Download the DMG file, open it, and drag McFind.app to your Applications folder
2. PKG: Download the PKG file and double-click to run the installer

View all available releases and download previous versions: Releases Page

• macOS 14.0 or later
• Xcode 15.0 or later (for building from source)

1. Open McFind.xcodeproj in Xcode
2. Select your target device/simulator
3. Press Cmd+R to build and run

1. Launch the app: The application will automatically start indexing your home directory
2. Search: Type in the search bar to find files instantly
3. Navigate: Use arrow keys to navigate through results
4. Open files: Press Enter or double-click to open the selected file
5. Reveal in Finder: Right-click and select "Reveal in Finder" to show the file location

• ↑ / ↓: Navigate through search results
• Enter: Open the selected file
• Escape: Clear search (when search bar is focused)

The application is built with SwiftUI and follows MVVM architecture:

• McFindApp: Main app entry point
• ContentView: Main UI view with search bar and results list
• FileItem: Model representing file metadata
• FileIndexer: Handles file system indexing and search
• SearchViewModel: Manages search state and user interactions

The app requests minimal file system permissions through sandboxing:

• Read-only access to user-selected files
• Read-only access to common directories (Downloads, Pictures, Music, Movies)
• Read-only access to home directory files

• Indexing runs in background to avoid blocking the UI
• Search results are filtered and sorted in real-time
• File system access is optimized to skip unnecessary directories (caches, logs, etc.)

This project is open source. Feel free to modify and distribute according to your needs.