MochiPaw

MochiPaw is a Tauri + Vue desktop pet app based on BongoCat.

This repository contains BongoCat-derived material under the MIT License and CatStack-authored additions under the PolyForm Noncommercial License 1.0.0. See NOTICE.md for license scope, attribution, core usage rules, and commercial licensing information.

Noncommercial only. Commercial use requires prior written permission from CatStack / InfinityXCat.

Features

• Customizable Live2D desktop pet in a transparent, always-on-top window.
• Keyboard, mouse, and gamepad input that drives typing behaviors, motions, and expressions.
• Import, organize, rename, and manage multiple Live2D models and desktop pets.
• Built-in Pomodoro timer and daily typing statistics.
• Tray controls, preferences, global shortcuts, autostart, and update management.
• Windows compatibility features, including game mode, Raw Input support, administrator status, and process diagnostics.
• Cross-platform support for Windows, macOS, and Linux.

Requirements

• Node.js 22 or newer
• pnpm
• Rust stable toolchain
• Tauri desktop build prerequisites for your OS

Install dependencies:

pnpm install

Development

Start the Tauri development app:

pnpm tauri dev

Start only the Vite dev server:

pnpm dev:vite

Generate app icons:

pnpm build:icon

Build

Build only the frontend:

pnpm build:vite

Build frontend and regenerate icons:

pnpm build

Build the Tauri app for the current platform:

pnpm tauri build

Release builds cover Windows, macOS, and Linux:

Windows: target/release/bundle/msi/ and target/release/bundle/nsis/
macOS:   target/release/bundle/dmg/ and target/release/bundle/macos/
Linux:   target/release/bundle/appimage/, target/release/bundle/deb/, and target/release/bundle/rpm/

Portable Zip

Build a portable Windows zip:

pnpm build:portable

The archive is written to:

target/release/bundle/portable/MochiPaw_<version>_windows_<arch>_portable.zip

If a release executable already exists and you only want to recreate the zip:

node scripts/packagePortable.mjs --skip-build

Checks

pnpm lint
cargo check -p mochi-paw
cargo check -p tauri-plugin-admin-status

Release

GitHub Releases are the public release channel for MochiPaw builds.

pnpm release

The release script syncs package metadata through scripts/release.ts and uses release-it.

License

MochiPaw is a multi-license repository:

• BongoCat-derived material remains available under the MIT License.
• CatStack-authored additions are licensed under the PolyForm Noncommercial License 1.0.0 unless a file states otherwise.
• Third-party dependencies and bundled assets keep their own terms.

See LICENSE and NOTICE.md for the full license texts, attribution, and notices.

Attribution

MochiPaw is a derivative work of ayangweb/BongoCat, which was released under the MIT License.

The BongoCat MIT license text, attribution details, CatStack-authored additions, and license scope are documented in NOTICE.md.

Bundled Live2D/Cubism runtime files, model assets, images, icons, and other third-party material keep their original upstream terms. Review those terms before redistributing modified builds or using the assets outside this repository.