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

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 Note

This app is open source and safe to use. Since it is not notarized by Apple, macOS Gatekeeper may block it by default. To run FinderSnap, remove the quarantine attribute:

xattr -cr /path/to/FinderSnap.app

Alternatively, build from source to avoid Gatekeeper restrictions.

Usage

1. Launch FinderSnap - The app icon appears in the menu bar
2. Grant Accessibility Permission - Required for window manipulation (prompted on first launch)
3. Configure Settings - Click the menu bar icon and select "Settings"
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>/
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