Skip to main content
Version: 2.x (current)

Install AniMathIO 2

Download the installer from the latest release page (currently 2.2.0). Every installer ships the desktop editor (animathio), the headless tool (animathio-cli) and the first-party plugin bundles.

PlatformFileNotes
Windowsanimathio_2.2.0_x64-setup.exeNSIS installer. Unsigned, so SmartScreen warns: choose More info, then Run anyway.
macOSAniMathIO_2.2.0_aarch64.dmgApple Silicon. Unsigned and not notarized: right-click the app and choose Open.
Linux (any distribution)animathio_2.2.0_x86_64.AppImageMake it executable and run it. The host provides the runtime libraries.
Debian and Ubuntuanimathio_2.2.0_amd64.debDeclares its runtime libraries as dependencies.

Linux​

chmod +x animathio_2.2.0_x86_64.AppImage
./animathio_2.2.0_x86_64.AppImage
sudo apt install ./animathio_2.2.0_amd64.deb

Flatpak​

The 2.2.0 source includes Flatpak build files for com.animathio.AniMathIO. A Flathub listing is pending; AniMathIO is not yet available from Flathub. See the Flatpak build instructions for building locally.

Verify the installation​

animathio --version
animathio-cli --version

CI-built installers carry a build provenance attestation. To check a download:

gh attestation verify <file> --repo AniMathIO/AniMathIO

Each release also lists a SHA256SUMS file. Download it next to the installer and run sha256sum --check --ignore-missing SHA256SUMS (on macOS, shasum -a 256 --check --ignore-missing SHA256SUMS).

Automatic subtitles need a model​

The installers include the local speech engine but no model. The first time you generate subtitles, AniMathIO asks before downloading tiny (78 MB), base (148 MB, default) or small (488 MB), checks its SHA-256 and stores it in your user data directory.

Build from source​

You need stable Rust (edition 2024). On Linux also install libasound2-dev.

git clone https://github.com/AniMathIO/AniMathIO.git
cd AniMathIO
scripts/build-plugins.sh
cargo run -p animathio --release

For an unpackaged release binary set ANIMATHIO_PLUGIN_DIR=target/plugins so the editor finds the plugins. Debug binaries find target/plugins on their own.

Coming from 1.x​

AniMathIO 2 uses a different project format (.amio). Convert a 1.x project with animathio-cli import-v1 project.animathio -o imported.amio, or use Import v1 on the start screen. See Migrating from 1.x. The 1.x installers and documentation remain available as v1 (legacy).