Apple Matting

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:

Features

• 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

Demo

Screenshots

Stack

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

Requirements

• 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.

Quick Start

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

Notes

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

Project Structure

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

Usage

Single Image

• Open the app and go to Single Image
• Click, drag, or paste an image
• Start matting
• Edit, replace background, copy, or save the result

Batch Processing

• Go to Batch Processing
• Select the input folder
• Optionally choose an output folder
• Start processing and monitor progress
• Reveal generated files in Finder

License

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

Author

• Author: XIAOBIN
• Email: lxt@lingxiangtools.top
• Website: https://matting.lingxiangtools.top/

Contributing

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

Community

• Friendly community: linux.do

Star History