Repository navigation
Home
An open-source, local-first editor for Rive .riv animations.
Design, animate, build state machines, and export files that play in every official Rive runtime.
No accounts. No cloud.
| I want to… | Go to |
|---|---|
| Try OpenRive in 5 minutes | Getting Started |
| Make my first animation | Tutorial: Your First Animation |
| Make something interactive | Tutorial: Interactive Button |
| Let an AI assistant build animations | Tutorial: Animate with AI |
| Run it for my team | Self-Hosting · Storage and PostgreSQL |
| Install the desktop app | Desktop App |
| Look up a shortcut | Keyboard Shortcuts |
| Fix a problem | Troubleshooting · FAQ |
| Contribute | Contributing · Development |
-
Real
.rivfiles. Reads and writes the Rive runtime format. Unmodified files round-trip byte for byte, which is checked against the runtime's 437 test files. - Official rendering. The canvas is drawn by the official Rive WASM runtime, so what you see is what your app shows.
- Design & animate. Shapes, pen paths, text, images and SVG import, gradients, timelines with easing, state machines with inputs and pointer listeners.
- Theme colors. Define colors once and switch themes to recolor a whole file.
- Automate. A terminal UI, an MCP server for AI assistants, a REST API and in-editor scripts share one editing API.
- Everywhere. Web, self-hosted with Docker, or a desktop app for macOS, Windows and Linux.
- Local and login-free. Projects live in PostgreSQL: embedded on your machine, a server when you self-host.
Using OpenRive: User Guide · Templates · Theme Colors · Text and Assets · Code Panel · Users and Roles · Keyboard Shortcuts
Running it: Running Locally · Self-Hosting · Desktop App · Configuration · Storage and PostgreSQL
Automating it: CLI · MCP Server · REST API
Under the hood: Architecture · File Format · Glossary · Roadmap
Contributing: Contributing · Contribution Guides · AI Collaboration
OpenRive is free and MIT-licensed. You can support it with a donation (TON):
UQBglMTG79v4lv6j0CyhJSKaB8vNr704qUgcyA0CkUtGEZ7q
Stars, bug reports and pull requests help too.
OpenRive · MIT License ·
Report a bug ·
Request a feature ·
This wiki is generated from the repo's docs/, contribution/ and wiki/ folders. Edit those, not the wiki.
Get started
Tutorials
Using OpenRive
- User Guide
- Keyboard Shortcuts
- Templates
- Theme Colors
- Data Binding
- Text and Assets
- Code Panel
- Preview Bundles
- Users and Roles
- Accounts and Sign-in
Self-hosting
Automation
Under the hood
Contributing