A local macOS desktop matting tool built with Tauri, Vue, and Rust.

中文文档

Apple Matting is a local desktop background-removal tool built with Tauri 2, Vue 3, and Rust. The current matting backend relies on native macOS capabilities and is designed for fast background removal for portraits, product photos, avatars, and similar images.

Website: https://matting.lingxiangtools.top/

• Single image background removal
• Batch folder scanning and processing
• Supports JPG, PNG, WEBP, and BMP
• Before/after comparison preview
• Transparent, solid-color, and gradient backgrounds
• Built-in result editor for erase / restore refinements
• Clipboard copy, save-as, and reveal-in-folder actions
• Chinese and English UI

• Frontend: Vue 3, Vite, Element Plus, vue-i18n
• Desktop: Tauri 2
• Backend: Rust
• Native layer: Swift + macOS Vision / Core Image

• macOS 14.0 or later
• Node.js 18+
• pnpm
• Rust toolchain
• Xcode Command Line Tools

Note: the matting engine currently integrates with macOS native APIs through src-tauri/swift/MattingBridge.swift. Non-macOS platforms will return an unsupported-platform error.

Install dependencies:

pnpm install

Run in development:

pnpm tauri dev

Build the desktop app:

pnpm tauri build

Generate icons:

pnpm tauri icon app_logo.png

If macOS shows that apple-matting.app is damaged after download, run the following command to remove the quarantine attribute and repair it:

xattr -rd com.apple.quarantine /Applications/apple-matting.app

.
├── src/                # Vue frontend
├── src-tauri/          # Tauri / Rust / Swift native layer
├── public/             # Static assets
├── images/             # Demo assets for README
├── app_logo.png        # App icon source

1. Open the app and go to Single Image
2. Click, drag, or paste an image
3. Start matting
4. Edit, replace background, copy, or save the result

1. Go to Batch Processing
2. Select the input folder
3. Optionally choose an output folder
4. Start processing and monitor progress
5. Reveal generated files in Finder

Licensed under GNU GPL v3.0 (GPL-3.0-only). See LICENSE.

• Author: XIAOBIN
• Email: [email protected]
• Website: https://matting.lingxiangtools.top/

Issues and pull requests are welcome. By contributing to this repository, you agree that:

• Your contribution will be distributed under the same project license
• You have the legal right to submit the contribution

• Friendly community: linux.do