GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - SysAdminDoc/AlphaCut: Local image and video background removal with before/after preview, mask brushes and transparent exports. Windows app and batch CLI.

BranchesTags
Open more actions menu

Latest commit

 

History

74 Commits
74 Commits

Folders and files

NameName
Last commit message
Last commit date
assets
assets
 
 
docs
docs
 
 
packaging
packaging
 
 
tests
tests
 
 
.dockerignore
.dockerignore
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
AlphaCut-windows.spec
AlphaCut-windows.spec
 
 
AlphaCut.py
AlphaCut.py
 
 
Dockerfile
Dockerfile
 
 
Dockerfile.gpu
Dockerfile.gpu
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
RESEARCH.md
RESEARCH.md
 
 
ROADMAP.md
ROADMAP.md
 
 
alphacut_review.py
alphacut_review.py
 
 
locale_template.json
locale_template.json
 
 
models.json
models.json
 
 
pytest.ini
pytest.ini
 
 
requirements-build.lock
requirements-build.lock
 
 
requirements-cli-coreml.txt
requirements-cli-coreml.txt
 
 
requirements-cli-cuda.txt
requirements-cli-cuda.txt
 
 
requirements-cli-directml.txt
requirements-cli-directml.txt
 
 
requirements-cli.txt
requirements-cli.txt
 
 
requirements-coreml.txt
requirements-coreml.txt
 
 
requirements-cuda.txt
requirements-cuda.txt
 
 
requirements-dev.txt
requirements-dev.txt
 
 
requirements-directml.txt
requirements-directml.txt
 
 
requirements.txt
requirements.txt
 
 

Repository files navigation

AlphaCut v1.6.14

Version Source license Platform

Buy me a coffee on Ko-fi

If this project helps you, a coffee helps me keep working on it.

AlphaCut cut-plane logo

Remove a background. Keep control of the mask.

AlphaCut is a desktop app for local image and video cutouts. Compare the original with the result, paint corrections into the mask and export for the editor you already use. There's also a command line for batch work and watched folders.

Download for Windows · Portable download · User guide

Windows downloads use CPU inference. Python isn't required. Install FFmpeg separately for video; image cutouts work without it. The downloads are unsigned, so Windows may show an unknown-publisher warning. Compare your download with the release checksums.

AlphaCut comparing a backpack photograph with its transparent cutout

Actual AlphaCut window with a generated sample photograph. U2Net produced the cutout on CPU; the result wasn't retouched.

What you can do

  • Check the cutout before exporting. Drag the before/after divider or switch to a grayscale mask to spot holes and rough edges.
  • Use a region selection and keep/remove brushes when the first mask needs work. Edge softness and spill controls are available for further adjustment.
  • Export transparent PNGs or alpha video. Solid-color and image backgrounds let you prepare an opaque export too.
  • Process a queue of images and videos, save presets or watch a folder from the command line.

AlphaCut showing the grayscale mask and its coverage summary

The mask summary describes this preview frame. Its jitter-risk indicator is a heuristic, not a quality score for the whole video.

Make your first cutout

  1. Open a photo with Browse.
  2. Choose u2net for a general subject, or u2net_human_seg for a person.
  3. Click Preview and inspect the mask. The processing buttons stay below the scrollable settings.
  4. Use Start Processing and choose where to save the PNG.

The first use downloads the selected model. Download sizes vary, and larger models can take time to load. Once cached, that model can process media without a network connection.

Choose an export

Your next step Output to try
Use a cutout in a slide, shop listing or image editor Transparent PNG
Composite video in an editor that supports alpha ProRes 4444 or WebM VP9 with alpha
Deliver ordinary video with a replacement background H.264, HEVC or AV1
Work with separate foreground and mask assets PNG sequence, grayscale matte or foreground/alpha pair

Alpha support varies between players and editors. Test a short clip in your destination app. Animated GIF and WebP are available for short clips, with a memory check before export.

Run from source

Use Python 3.12 or newer. Windows, Linux and macOS source profiles are available; this release was exercised on Windows with CPU inference.

git clone https://github.com/SysAdminDoc/AlphaCut.git
cd AlphaCut
python -m venv .venv
.venv\Scripts\python -m pip install -r requirements.txt
.venv\Scripts\python AlphaCut.py

On Linux/macOS, use .venv/bin/python. See the guide for CUDA, DirectML, CoreML and headless environments. Startup checks dependencies but never installs or removes packages.

A command-line image cutout:

.venv\Scripts\python AlphaCut.py -i photo.jpg -m u2net -o cutout.png

The complete CLI reference covers batch jobs, watch folders and video exports. Exact model names take priority; ambiguous names are rejected.

Privacy and practical limits

Your images and video are processed locally. AlphaCut checks GitHub for updates at startup and downloads uncached models from their configured sources. Settings, recent paths, logs and cached models are stored in ~/.alphacut.

Results depend on the subject, lighting and model. Fine hair, motion blur and low-contrast edges can need manual corrections. The video pipeline uses per-frame segmentation, not a dedicated temporal matting model. There's no blanket speed or quality guarantee.

Development

.venv\Scripts\python -m pip install -r requirements-dev.txt
.venv\Scripts\python -m pytest -q
.\packaging\windows\build-release.ps1

The local build creates the Windows executable and installer, AlphaCut-windows.exe.sha256, AlphaCut-Setup-<version>.exe.sha256 and dist/SHA256SUMS.txt. Without a configured signing certificate these are produced unsigned.

User guide · Release notes · Original artwork and review archive · Report a problem

License

AlphaCut's source is MIT licensed. Windows downloads also contain PyQt6 (GPLv3) and other dependencies with their own terms. The combined Windows distribution is provided under GPLv3-compatible terms, with notices and source-rebuild information. Model files are separate downloads governed by their respective licenses.

About

Local image and video background removal with before/after preview, mask brushes and transparent exports. Windows app and batch CLI.

github.com/SysAdminDoc/AlphaCut/releases/latest

Topics

alpha-channelbackground-removalbatch-processingcompositingimage-processingonnxruntimepyqt6pythonvideovideo-editingwindows

Resources

Readme
MIT license
Activity

Stars

5 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

Packages

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.