github.com/Shriinivas/gimpsegany @v1.0.0

GIMP Plugin For Integration With Meta Segment Anything

Downloads

You can download the latest version of the plugin from the GitHub Releases page.

• gimp-segany-gimp3.zip: For GIMP 3

Download the zip file and follow the installation instructions below.

---

This GIMP plugin integrates with Meta's AI-based tool Segment Anything, which enables you to effortlessly isolate objects within raster images directly from GIMP.

This project provides a plugin that supports both Segment Anything 1 (SAM1) and Segment Anything 2 (SAM2).

---

Installation

Plugin Installation

1. Go to the GitHub Releases page and download gimp-segany-gimp3.zip.
2. Extract the zip file in your GIMP plug-ins folder. This will create a seganyplugin directory with the plugin files inside.
3. If you are updating, you can extract and replace the existing seganyplugin directory.

You can find GIMP's user plugin location in the Edit > Preferences menu under the Folders section. Here are the default locations for each operating system:

• Windows: C:\Users\[YourUsername]\AppData\Roaming\GIMP\3.0\plug-ins\
• Linux: ~/.config/GIMP/3.0/plug-ins/
• macOS: ~/Library/Application Support/GIMP/3.0/plug-ins/

After extracting, ensure the plugin script is executable (on Linux and macOS).

Segment Anything Backend Installation

You need to install the backend for the Segment Anything model you want to use. The plugin can use either SAM1 or SAM2.

Segment Anything 2 (SAM2) Installation

You will get the detailed installation instructions about installing Segment Anything 2 on your platform on Meta's github site: https://github.com/facebookresearch/segment-anything-2.

Prerequisites: - Python 3.10 or higher - PyTorch 2.3.1 or higher

Installation Steps: 1. Clone the repository: bash git clone https://github.com/facebookresearch/segment-anything-2.git 2. Navigate to the directory and install the package: bash cd segment-anything-2 && pip install -e . 3. Download a model checkpoint (e.g., Tiny, Small, Base Plus, Large). 4. Ensure the segment-anything-2 directory is in your PYTHONPATH.

Segment Anything 1 (SAM1) Installation

You will get the detailed installation instructions about installing Segment Anything on your platform on Meta's github site: https://github.com/facebookresearch/segment-anything.

Installation Steps: 1. Clone the repository: bash git clone https://github.com/facebookresearch/segment-anything.git 2. Navigate to the directory and install the package: bash cd segment-anything && pip install -e . 3. Download a model checkpoint (e.g., vit_h, vit_l, vit_b). 4. Ensure the segment-anything directory is in your PYTHONPATH.

Bridge Test

Perform a quick check to ensure your Segment Anything installation is working properly. Open a console and change directory to your GIMP plugin folder.

For SAM2 model:

/path/to/python3/python ./seganybridge.py sam2_hiera_large /path/to/checkpoint/model/sam2_hiera_large.pth

For SAM1 model:

/path/to/python3/python ./seganybridge.py vit_h /path/to/checkpoint/model/sam_vit_h_4b8939.pth

A "Success!!" or "Success!" message indicates a successful installation.

---

Plugin Usage

• Open GIMP. Under the "Image" menu, you should see a new submenu called "Segment Anything Layers".
• Open an image file and click on the plugin's menu item to bring up the dialog box.

Plugin UI:

Options

• Python3 Path: The path to the python3 instance used while running the seganybridge script.
• Model Type: The type of the Segment Anything model to use. Can be set to Auto to infer from the checkpoint filename (sam_ prefix for SAM1, sam2 for SAM2).
• Checkpoint Path: The path to the downloaded Segment Anything model checkpoint file (.pth or .safetensors).
• Segmentation Type: The method to be used for segmentation.
• Auto: Automatically segments the entire image.
• Box: Segments objects within a user-drawn rectangular selection.
• Selection: Segments objects based on sample points from a user-drawn selection.
• Mask Type:
• Multiple: Creates a separate layer for each potential object.
• Single: Creates a single layer with the mask that has the highest AI probability.
• Random Mask Color: If checked, the generated layers will have random colors. Otherwise, a specific color can be chosen.

SAM2 Specific Options (for "Auto" Segmentation)

These options are only available when using a SAM2 model with "Auto" segmentation.

• Segmentation Resolution: Controls the density of the segmentation grid. Higher values will generate more masks but will be slower. (Options: Low, Medium, High)
• Crop n Layers: Enables segmentation on smaller, overlapping crops of the image, which can improve accuracy for smaller objects.
• Minimum Mask Area: Discards small, irrelevant masks.

Workflow

1. Select your desired options in the plugin dialog and click "OK".
2. The plugin will create a new layer group with one or more mask layers.
3. Find the mask layer corresponding to the object you want to isolate.
4. Select that layer and use the "Fuzzy Selection" tool to select the mask area.
5. Hide the new layer group and select your original image layer.
6. You can now cut, copy, or perform any other GIMP operation on the selected object.