Shelve

Shelve is a native macOS menu bar application designed to automatically organize the Downloads folder efficiently and seamlessly. Developed using Swift and SwiftUI, this application eliminates the need for Python or Electron, providing a lightweight solution for file management.

Key Features

• Auto-classify: Monitors the Downloads folder and automatically sorts files into categorized subfolders, enhancing file organization.
• Smart Rules: Allows for classification based on file extensions, keywords, or date conditions (e.g., sorting files older than a specified number of days).
• Auto-rename: Facilitates filename modifications by adding date prefixes, converting filenames to lowercase, replacing spaces with underscores, and appending custom prefixes or suffixes.
• Move to Trash: Offers functionality to trash files instead of moving them to folders, ideal for removing outdated installers.
• TF-IDF Search: Implements fast full-text search across all organized files, making information retrieval straightforward.
• History Mode: Tracks all actions taken by Shelve, allowing for easy review and one-click undo of previous moves.
• Setup Wizard: Provides a streamlined onboarding experience during the first launch, enabling quick configuration.
• Liquid Glass UI: Adopts the native macOS 26 design language, ensuring a visually consistent and aesthetically pleasing interface.

Functional Insights

• Rules Management: Each classification rule can include file extensions, keywords, and date conditions, with the flexibility to edit rules in the Settings menu.
• Configuration: Application settings are stored at ~/Library/Application Support/Shelve/config.json and can be modified through the app's Settings window.

Project Structure Overview

The project structure consists of various Swift files, each serving specific functionalities:

• AppDelegate.swift: Entry point and setup wizard.
• MenuBarManager.swift: Manages the menu bar icon and interactions.
• SearchPanel.swift: Handles the native search window.
• SearchEngine.swift: Implements TF-IDF search algorithms.
• Classifier.swift: Manages file classification and renaming actions.
• FileWatcher.swift: Monitors the Downloads folder for changes using FSEvents.
• Config.swift: Manages JSON configuration persistence.
• SetupWizard.swift: Guides users through initial setup.
• SettingsView.swift: Provides access to app settings, rules, and additional information.

Optimize file organization effortlessly with Shelve, the smart solution that enhances productivity by keeping your Downloads folder neat and searchable.