KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

apple-matting

★ 89 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="./app_logo.png" alt="Apple Matting Logo" width="160" />

<h1 align="center">Apple Matting</h1>
A local macOS desktop matting tool built with Tauri, Vue, and Rust.

 <a href="./README.zh.md">中文文档</a>


 <a href="https://github.com/pangxiaobin/apple-matting/releases">
 <img src="https://img.shields.io/badge/Download-Releases-111827?style=for-the-badge&logo=github" alt="Download from GitHub Releases" />
 </a>
 <a href="https://matting.lingxiangtools.top/#download">
 <img src="https://img.shields.io/badge/Download-Website-0f766e?style=for-the-badge&logo=safari" alt="Download from Website" />
 </a>


 <a href="https://matting.lingxiangtools.top/">
 <img src="https://img.shields.io/badge/Website-matting.lingxiangtools.top-0f766e?style=flat-square" alt="Website" />
 </a>
 <a href="./LICENSE">
 <img src="https://img.shields.io/badge/License-GPLv3-f59e0b?style=flat-square" alt="License: GPLv3" />
 </a>
 <a href="https://matting.lingxiangtools.top/">
 <img src="https://img.shields.io/badge/Platform-macOS%2014%2B-111827?style=flat-square" alt="Platform" />
 </a>
 <a href="https://tauri.app/">
 <img src="https://img.shields.io/badge/Tauri-2.x-24c8db?style=flat-square" alt="Tauri" />
 </a>
 <a href="https://vuejs.org/">
 <img src="https://img.shields.io/badge/Vue-3.x-42b883?style=flat-square" alt="Vue" />
 </a>

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/>

## 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

![Apple Matting Demo](https://raw.githubusercontent.com/pangxiaobin/apple-matting/main/images/operate.gif)

## 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:

```bash
pnpm install
```

Run in development:

```bash
pnpm tauri dev
```

Build the desktop app:

```bash
pnpm tauri build
```

Generate icons:

```bash
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:

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

## Project Structure

```text
.
├── 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

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

### Batch Processing

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

## License

Licensed under `GNU GPL v3.0` (`GPL-3.0-only`). See [LICENSE](./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](https://linux.do)

## Star History

apple-matting

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README