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, so it fits the workflow you already have.

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 pony ears in the centre 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: The Apple Silicon .dmg and Umamo.app are signed and notarized by Apple. The Linux .rpm and SHA256SUMS.txt are signed with the Umamo release key. Windows builds are not signed yet so 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. Android tablet builds are in progress.

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 a file layer that speaks the formats you already use.

Runs where you draw

Windows, MacOS and Linux today, on x64 and arm64. Android tablet support is in progress.

Pen and touch

Made for pen displays and tablets. Pen and touch are first-class input, not a mouse emulation.

Cubism Editor interop

Opens and saves .cmo3 projects byte-compatible with the official editor, so files move back and forth.

MOC3 in and out

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

Import your artwork

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

A modern, resolution-independent UI

Crisp at any DPI, with a command registry and customisable key bindings.

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

Not yet. This is a long term stretch goal. Getting the modeling, UV editor, and physics interface perfected first will be important for animation later.

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