FinderSnap

Automatically resize and position new Finder windows on macOS

Features

• Automatically resize and position new Finder windows
• Center windows or place at custom coordinates
• Multi-display support (main screen or active screen)
• Smooth window transition animations
• Smart exclusions for Quick Look and DMG windows
• Automatic update checking with localized changelogs
• First-launch onboarding with guided Accessibility permission setup

Requirements

• macOS 14.0 (Sonoma) or later
• Accessibility permission (prompted on first launch)

Installation

Homebrew (Recommended)

brew tap LZhenHong/tap
brew install --cask findersnap

Download from GitHub

Download the latest release from the Releases page.

Build from Source

git clone https://github.com/LZhenHong/FinderSnap.git
cd FinderSnap
xcodebuild -project FinderSnap/FinderSnap.xcodeproj -scheme FinderSnap -configuration Release build

The built app will be located in the build/Release directory.

Code Signing

Release builds are signed with an Apple Developer ID certificate and notarized by Apple, so FinderSnap opens directly without Gatekeeper warnings — no quarantine removal needed.

Alternatively, build from source to run your own copy.

Usage

1. Launch FinderSnap - The app icon appears in the menu bar
2. Complete Onboarding - On first launch, a guided onboarding walks you through:
   • Welcome overview of FinderSnap
   • Granting Accessibility Permission (required for window manipulation)
   • Quick setup with recommended defaults (resize to 1200×800, center on main screen, smooth animation)
3. Configure Settings - Click the menu bar icon and select "Settings" to customize behavior
4. Enjoy - New Finder windows will automatically be resized and positioned

Development

Prerequisites

• Xcode 15.0+
• macOS 14.0+

Build & Run

# Debug build
xcodebuild -project FinderSnap/FinderSnap.xcodeproj -scheme FinderSnap -configuration Debug build

# Release build
xcodebuild -project FinderSnap/FinderSnap.xcodeproj -scheme FinderSnap -configuration Release build

Release Process

# Configure API key for AI-powered changelog generation
cp .env.example .env
# Edit .env and add your DEEPSEEK_API_KEY

# Full release (changelog + build + tag)
make release

# Or run steps individually
make changelog       # Generate changelog from git log
make changelog-diff  # Generate changelog from git diff (more accurate)
make build           # Build and package app to releases/<version>/ (ad-hoc signed)
make notarize        # Build, notarize and package with Developer ID (distribution builds)
make tag             # Create git tag
make clean           # Clean build artifacts

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• StorageMacro - Swift macro for UserDefaults persistence
• SettingsKit - SwiftUI settings window framework
• MarkdownUI - Markdown rendering in SwiftUI

---

Made with ❤️ by Eden