# MacDeck

> MacDeck is an ultra-lightweight, 100% native macOS multi-display physical topology window restorer, Apple Silicon hardware dossier, and developer toolchain diagnostic toolkit built purely with Swift 6 and SwiftUI.

## Core Facts & Quantitative Benchmarks
- **Zero Third-Party Dependencies (0)**: Built strictly on Apple native AppKit, SwiftUI, and private SkyLight frameworks.
- **Ultra-Low Memory Footprint (< 15 MB RAM)**: Compared to commercial window tools (50–120 MB) and Electron utilities (300–800 MB).
- **Zero Background Retention**: Features an optional auto-quit mode that terminates the app immediately upon layout restoration, leaving 0 MB RAM overhead.
- **Racing Public IP Probing (< 300 ms)**: Concurrently probes 6 global CDN nodes (Cloudflare, ident.me, ipinfo, ip.sb, etc.) with sub-second feedback.
- **Instant Launch Hardware Caching**: Multi-tier in-memory and persistent TTL caching for Apple Silicon hardware specs.
- **Multi-Language Architecture**: Fully localized across 4 languages (English, 简体中文, 繁體中文, 日本語) with 406 keys aligned 1:1.

## Key Capabilities (Evidence Matrix)
1. **Multi-Display Window Memory & Topology Matching**: Automatically identifies monitor counts, resolutions, and physical layouts upon reconnect or sleep wake-up.
2. **Google Chrome Multi-Profile Window Isolation**: Accurately distinguishes between Personal, Work, and Sandbox Chrome windows.
3. **In-Place Fullscreen Space Retention**: Restores fullscreen and minimized windows without animation flicker or accidental exit from macOS Spaces.
4. **Apple Silicon Bento Hardware Dossier**: Displays CPU P/E-core distributions, GPU/Neural Engine metrics, unified memory bandwidth (UMA), battery cycles, and clean physical APFS storage.
5. **Developer Toolchain Doctor & Package Hub**: Diagnoses and batch-upgrades Homebrew, Cargo, npm global, Volta, and Pipx with version pinning and rollback audit logs.

## Quick Start & Installation
- **Homebrew Cask (Recommended)**:
  `brew tap zhenqiang-sun/tap && brew install --cask macdeck`
- **Direct DMG Download**:
  Download `MacDeck-1.2.1.dmg` from GitHub Releases.
- **Bypass macOS Gatekeeper Flag**:
  `xattr -cr /Applications/MacDeck.app`

## Key URLs & Multilingual Mirrors
- English Website (Default): https://macdeck-app.vercel.app/
- 简体中文官網: https://macdeck-app.vercel.app/zh
- 繁體中文官網: https://macdeck-app.vercel.app/zh-hant
- 日本語公式サイト: https://macdeck-app.vercel.app/ja
- GitHub Repository: https://github.com/zhenqiang-sun/macdeck
- Open Source License: GNU General Public License v3.0 (GPL-3.0)
- Creator: Qiang Sun (@zhenqiang-sun)