Samosa is an open-source, dockable rotoscoping panel for Adobe After Effects. It connects After Effects to a local Sammie-Roto-2 runtime so object selection, tracking, matting, removal, export, and import stay inside the After Effects workflow.
Samosa is an independent integration project. It is not an official Sammie-Roto-2 project and is not affiliated with or endorsed by Adobe.
Documentation:Windows installation | macOS installation | Model installation | After Effects tutorial | Development | Third-party licenses
The current release targets Windows and macOS with After Effects 2021 or newer through CEP. The selector is embedded in the docked panel. A future native Custom Comp UI module can route clicks from the Composition viewer to the same local service API.
- Multiple objects with include and exclude point prompts
- SAM2 selection and clip-wide object tracking
- MatAnyone, MatAnyone2, and VideoMaMa matting adapters
- MiniMax and OpenCV removal adapters
- Mask cleanup, growth, antialiasing, and duplicate-frame controls
- PNG, EXR, and video output with automatic import into the active composition
- Background jobs with progress, cancellation, and tracked-frame state
- 100%, 75%, and 50% viewer scaling
- Windows 10/11, or macOS 13 or newer
- Adobe After Effects 2021 or newer
- Internet access during runtime and model installation
- Windows: a supported NVIDIA, Intel, or CPU backend
- macOS: Apple Silicon MPS acceleration or Intel CPU processing
Samosa installers do not embed model weights or Adobe SDK files. They download a pinned Sammie-Roto-2 source revision, Python runtime, and selected checkpoints during installation or first use.
Download the installer for your platform from the latest release:
- Windows:
Samosa-Setup-1.2.1.exe - macOS:
Samosa-1.2.1-macOS.pkg
Both installers create a local runtime and configure the After Effects CEP panel. See Windows installation or macOS installation.
Choose one model mode:
- Standard: installs SAM2 Base now; missing models download when first requested.
- Complete: pre-downloads every supported model after the restricted-model license notice is accepted.
- Custom: selects individual model packs to pre-download.
Restart After Effects and open Window > Extensions (Legacy) > Samosa.
See Model installation for exactly what happens when Standard mode encounters a missing model.
- Open a composition and select exactly one file-backed footage layer.
- Open Window > Extensions (Legacy) > Samosa, then choose Load selection.
- Click the viewer to add Include points; right-click or switch to Exclude to remove areas. Add another object when needed.
- Choose Track objects. Add correction points on problem frames and track again.
- Use Matting for refined alpha edges or Remove to fill the selected area.
- Under Output, choose the output description, object, format, and destination, then select Export and add to comp.
Exports use readable names such as interview_Hero_Person_matting_matte. See the After Effects tutorial for the complete workflow.
Run the source-only contract suite with any Python 3.10+ interpreter:
python -m unittest discover -s tests -v
node tests/test_panel_runtime.jsSet SAMMIE_REPO and run with the upstream virtual environment to include the deterministic integration suite:
$env:SAMMIE_REPO="D:\path\to\Sammie-Roto-2"&"$env:SAMMIE_REPO\.venv\Scripts\python.exe"-m unittest discover -s tests -vSee Development, Architecture, and Releasing.
Samosa source code is licensed under GPL-3.0. It directly integrates with the GPL-3.0 Sammie-Roto-2 runtime, so GPL-3.0 is the conservative and compatible release choice.
Some optional engines exposed through Sammie-Roto-2 have separate noncommercial terms. In particular, MatAnyone uses the S-Lab noncommercial license, while MiniMax Remover and VideoMaMa use CC BY-NC 4.0. Installing or downloading those components does not grant commercial-use rights. Review Third-Party Notices before distributing Samosa or using those engines commercially.
Samosa is maintained as a separate repository because it is an After Effects integration and does not modify Sammie-Roto-2 core. Fork Sammie-Roto-2 only if a contribution requires maintaining upstream core patches; submit generally useful changes upstream when possible. See Notice for the exact provenance used during development.
Samosa exists because of the work in Sammie-Roto-2 by Zarxrax and contributors. The workflows it exposes connect to SAM 2, EfficientTAM, MatAnyone, MatAnyone2, VideoMaMa, and MiniMax Remover. Attribution here does not replace each project's license or model terms; see Third-party notices.
Contributions are welcome under GPL-3.0. Read Contributing, Security, and the Code of Conduct before opening a change.
