Skip to content
Umamo mascot

Open-source 2D Puppet Modelling

Umamo is a free, cross-platform modelling editor for 2D puppet animation with pen and touch support. It reads and writes Live2D Cubism .cmo3 and .moc3 files. Currently in early development preview to gather user feedback. Join our Discord to participate!

Early Development GPL-3.0
Download Umamo View on GitHub

Windows, MacOS, and Linux · Free and Open Source

The Umamo modelling workspace: A parameter panel on the left, a smiling 2D puppet with horse ears in the center viewport, an outliner and mesh properties on the right, and a keyform sheet along the bottom.

Download

The current build is Umamo (see releases), published .

Download Umamo

Pick your platform from the table.

Build Signing: Windows builds are not signed yet so the Windows' SmartScreen will warn on attempting to install or run them. Follow the Windows notes below on how to get around it.

All platforms

Platform Installer Recommended Portable Unpack and run Java 21+ .jar
See the GitHub releases page for every build.

Verify your download against SHA256SUMS.txt(signature, release key) · Release notes · All releases · Source code

Installers and portable builds bundle their own Java runtime. The .jar builds need Java 21 or newer and run anywhere Java does. Intel Macs use the .jar for now.

Installing

  1. Download the .msi installer and run it. The installer installs for your local user only and will exit without confirmation after it is finished.
  2. SmartScreen will say “Windows protected your PC”. Choose More info, then Run anyway.

Rather not install? Download the .zip instead, extract it anywhere you like, and run Umamo.exe from the extracted folder. SmartScreen will warn about it the same way.

Apple Silicon

  1. Download the .dmg, open it, and drag Umamo into Applications.
  2. Start Umamo from Applications.

Intel

  1. Install Java 21 or newer if you don't have it.
  2. Download the Intel .jar and double-click it, or run it from Terminal: 
    java -XX:MaxRAMPercentage=50 -jar umamo-macos-x64-<version>.jar

Debian 12+, Ubuntu 22.04+, Linux Mint 21+

Download the .deb for your architecture and install it:

sudo apt install ./umamo-linux-x64-<version>.deb

Fedora and other RPM distributions

The .rpm is signed. Import the Umamo release key once, then install it with signature checking turned on:

sudo rpm --import https://umamo.org/keys/umamo-signing-key.asc
sudo dnf install --setopt=localpkg_gpgcheck=1 ./umamo-linux-x64-<version>.rpm

Release key fingerprint: 6775 4C0D C587 4327 0D57 4066 F549 9AE5 C80A 0F1C

Any other distribution

Unpack the .tar.gz and run the launcher:

tar xzf umamo-linux-x64-<version>.tar.gz
umamo/bin/umamo

That's it. Linux doesn't restrict you from running any application that you wish to run on your computer.

System Requirements

Minimum Recommended Notes
Memory 16 GB 32 GB+ 8 GB has been tested, but requires raising the Java heap space setting. Heavy models with many layers and texture atlases may run out of memory on systems below 16GB.
CPU 4 cores - A 2014 Macbook Pro with an Intel i7 4th Gen, with performance mode turned on, had barely acceptable performance. If your system is newer than this you will probably be fine.
Operating system Windows 10/11
MacOS 11+ (Intel)
-
Ubuntu 22 		-
MacOS 15+ (ARM64)
Fedora 44
Ubuntu 26 		Tested platforms. For older operating systems, you may need to use the JAR based distribution.

Built for 2D Puppet Work

One shared codebase, a modern UI, and works with your existing CMO3 and MOC3 puppets.

Runs on any OS

Windows, MacOS and Linux today, on x64 and arm64. Android and iPadOS are on the development roadmap.

Pen Displays and Tablets

Made with pen displays in mind by building the interface around pen input.

Cubism Editor Interopability

Opens and saves .cmo3 projects byte-compatible with the official editor. Tested with Cubism Editor 4.2 to 5.4.

MOC3 In and Out

Import and export runtime distribution .moc3 along with their sidecars.

Industry Standard Artwork Format Support

Bring layered files straight from Krita(.kra), Photoshop(.psd), and Clip Studio Paint(.clip).

A modern, resolution-independent UI

Built with Kotlin and Compose Multiplatform, with a command palette, pie menus, and high resolution display support.

File formats

Format Read Write Notes
.uma Yes Yes Native UMA Model
.cmo3 Yes Yes Cubism Editor model, supports up to Cubism 5.4.
.moc3 Yes Yes Cubism runtime distribution model, supports up to Cubism 5.4.
.kra Yes — Krita
.psd Yes — Photoshop
.clip Partial — Clip Studio Paint; has known blending issues.

Found a problem with a format? Open an issue with a sample file.

Screenshots

Click on any image to enlarge it.

Modelling workspace: Parameters on the left, outliner and mesh properties on the right, keyform sheet below.
Texture workspace: The UV Editor in object mode with an atlas page pinned.

Questions

Umamo is completely open source and free, but if you would like to support the project you can join the Patreon or make a one-time donation through Ko-fi. All received funds go directly to paying hosting bills, hardware for testing, and platform developer fees. Excess funds will be banked for the future or distributed to other open source projects working with the Umamo Project.

Animation support is on the development roadmap for Summer 2027. This is a long term stretch goal. Getting the modeling, UV editor, and physics interface perfected first is the most important goal.

Yes, please search if the issue has already been reported and if not, open a new issue that describes the problem.

Currently Umamo is alpha level software available for testing. Please make sure to make regular backups of your files. In fact, make second copies of your files explicitly for playing around with. Do not use the original copies.

Support the project

Umamo will always be free. If it is useful to you, a recurring or one-time contribution pays for development costs and hardware.

Patreon Ko-fi