Open. Inspect. Ship.
The standalone desktop tool for Rive animations. Load any .riv, bind ViewModels, drive state machines, and export production-ready code.
macOS 11+ · Windows 10+ · Free & open source
New to RAV? Open your first .riv file
Title Bar
Custom window chrome with the RAV brand. Minimize, maximize, and close controls on the right.
Open
Load any .riv file from disk. Drag-and-drop onto the canvas works too.
Toolbar
Reset, play, pause, renderer (WebGL2 / Canvas), layout fit (contain / cover / fill / scaleDown / fitWidth / fitHeight / none / layout), alignment, and live FPS — all in one row.
Export & Settings
EXPORT generates self-contained HTML demos and copy-paste instantiation snippets with per-control selection. The neighbouring icons cover settings and MCP setup.
Script Editor
CodeMirror panel for the Rive instantiation config — autoplay, autoBind, artboard, stateMachines, layout, canvasSize, and lifecycle callbacks. Press APPLY to re-instantiate the runtime. Live build / runtime info anchored at the bottom.
Canvas
The animation viewport. Drop a .riv file here or hit OPEN. Renders via WebGL2 by default; switch renderer in the toolbar. Auto margins center fixed canvases and collapse safely for authored-origin scrolling.
Runtime Strip
MCP bridge health and recent-command activity, console toggle, runtime version label, and a structured status that restores after transient notices like canvas-size or runtime changes.
Console Panel
Two modes — Events log and JS REPL — sharing the bottom panel. Filter Events by source (NATIVE / RIVE USER / UI / MCP), filter JS by level, search either, follow latest, copy visible rows. All four filter toggles are also drivable from MCP.
Properties
Auto-discovered ViewModel controls with state-machine playback targets. List rows resolve authored labels; each image property uses one full-width select with embedded rasters, Open file…, and Clear.
Why this exists
A Rive file viewer for your desktop.
Testing them shouldn't require a web project.
RAV is a free, open-source .riv viewer and player for macOS and Windows. It connects directly to the Rive runtime, discovers ViewModel properties and keeps state-machine playback available, and gives you live controls without scaffolding. When the animation is ready, export the exact instantiation code your app needs — or let an AI agent drive the whole workflow through MCP.
Use the Rive editor to create the original artwork and animation; use RAV to inspect the exported .riv and test its behavior before integration. Rive source projects (.rev) need a runtime export first.
Capabilities
What RAV does

Controls
Every property, live
RAV reads the ViewModel hierarchy from your .riv file and keeps state-machine playback available. List rows resolve exact authored labels. Each image property gets one full-width select with every embedded raster, Open file…, and Clear; the external file input stays hidden.

Export
From animation to any output
Export H.264, H.265, WebM, APNG, GIF, PNG, JPG, or WebP from timelines and live state-machine interaction. Or choose controls, CDN or local packages, then copy a focused snippet or export a self-contained HTML demo.

MCP
AI agents as co-pilots
A bundled native sidecar exposes 56 MCP tools. Claude, Codex, or any MCP client can inspect and drive playback, record timed interactions, export every media format, edit scripts, generate snippets, and control the console panel. One-click install from the app.
Artboard switching
Switch artboards and playback targets from dropdowns. VM controls repopulate per target.
Dual consoles
Event log and JavaScript REPL with timestamps, follow mode, level filters, and copy.
Script editor
CodeMirror 6 with live source indication. Apply configuration without losing artboard state; standalone exports preserve and execute it.
Renderer + runtime
Canvas or WebGL2 with Latest (auto) by default. Concrete and custom semver pins remain available, with the known 2.40.0 authored-layout risk labeled.
Canvas sizing
Auto or fixed pixel dimensions with aspect lock. Overflow-safe auto margins center fixed canvases until styled scrolling is needed.
State preservation
Reset and reload preserve artboard, playback, and control values across re-instantiation.
Auto updates
Tauri-authenticated updates, with Developer ID signing and notarization on macOS.
VM Explorer
Inject the helper snippet for vmExplore, vmGet, vmSet, vmTree, and vmPaths debugging.
Interface
More of the app
Download
Ready when you are
Free, open source, and shipping for macOS and Windows.
All releases on GitHubRAV installations
Retrieving anonymous total…
Recent updates
v2.5.9
LATEST PUBLIC- Offline runtime in saved standalone demos — Newly saved standalone HTML embeds the validated WASM matching the selected concrete Canvas or WebGL2 runtime and disables CDN WASM fallback. After a successful export, the saved file can play without network access and uses local font fallbacks.
- Bundled file inspection — Updated the bundled parse-once file-inspection module for runtime-v0.1.384 with file-format 7.4 support. Full inspections retain authored Range Map ranges, flags, and interpolation metadata, independent binding contexts, corrected state/transition identities and enum names, nested listener scopes, and image-asset ViewModel properties.
- Analysis reports — Updated all bundled cross-platform analysis sidecars. HTML, Markdown, and PDF reports include an API reference, binding map, semantic rule IDs with legacy aliases, and Checks in this report coverage showing which checks ran or were skipped.
- Standalone control selection — A fresh source defaults to all currently available exportable controls selected. The unreliable Changed Only preset is removed; branch and leaf checkboxes, Select All, and Clear remain. Checked controls determine the standalone control UI, restored current values, and active generated accessors.
- Security dependency updates — The shipped TLS stack now resolves rustls 0.23.45. The bundled analysis sidecars are rebuilt with quick-xml 0.41.0, and the website uses Next.js 16.3.8. The legacy Node MCP lockfile also resolves patched fast-uri 3.1.8, hono 4.13.12, and ip-address 10.7.2.
- Scoped standalone selections — Explicit subset and Clear selections remain applicable across renderer or runtime-version changes for the same source, artboard, and ViewModel. A file, artboard, or ViewModel change safely defaults to all controls in the new authoritative hierarchy, so dialog-free exports cannot serialize stale keys.
- Minimized-window MCP responsiveness on macOS — Command-serving WebViews no longer enter WKWebView inactivity suspension after extended minimization. Status, file open, direct standalone export, export-dialog opening, and renderer switching remain responsive while hidden; a visible export overlay still waits for a real paint.
- Playback evaluation queue recovery — A playback-targeted rav_eval whose returned Promise remains unsettled is rejected after two seconds, before the normal child acknowledgement deadline, allowing later ordered renderer commands to proceed.
- Live recording input timing — During a live recording, mouse movement, clicks, ViewModel edits and triggers (physical or MCP) are timestamped and applied at their matching video frame, so input stays in real time even when capture runs behind. Pointer movement is interpolated between mouse samples for smooth 60 FPS output, never across clicks, exits or ViewModel changes. Input that arrives unusually late lands on the next frame and is counted in the receipt instead of stopping the take, and Stop no longer adds an extra frame when converting the take length.
- +1 more
- Live recording under capture lag — Complex lossless or alpha captures can still run below the requested frame rate, so finalizing takes longer. While a live take records, the preview responds to the mouse at least 100 ms late, and the reported lag includes that 100 ms input window. Mouse events handled after Stop are not recorded.
- Standalone export bootstrap — Creating a new export may require the matching runtime WASM from cache or network. Existing HTML files must be re-exported, and externally referenced Rive assets are not automatically embedded.
v2.5.8
- Machine ID on Windows — The About window's Machine ID row and rav_entitlement_status reported "Machine identity is unavailable on this platform" on Windows, so activation could not be requested there. The id is now derived from the installation's MachineGuid on Windows, from the hardware UUID on macOS, and from /etc/machine-id elsewhere; existing activation keys are unaffected.
v2.5.7
- Machine ID in About — The Build Matrix in the About window shows this installation's machine id with a copy button. Optional capabilities are activated per machine and user account; the id is what you send when requesting one.
- MCP rav_entitlement_status — Advertised in tools/list. Without arguments it returns the machine id. Given an activation key it verifies the key, stores it for this machine and account, and keeps it active until the key expires, so later sessions and agents need no key. The advertised tool set can change after activation; the server now declares tools.listChanged and sends notifications/tools/list_changed.
- Left panel footer — Reads "© 2026 IVG Design · MIT License"; the runtime credit moved out of that line.
- Large files took minutes to inspect — The bundled file-inspection module is rebuilt with an updated object lookup implementation, removing a quadratic path introduced by an earlier inspection build. A 13 MB production file that previously ran past the inspection deadline now inspects in about a second, and the exported timeline data lists only data-bound keyframes again.
- Timeline scrubber jitter — During linear-animation playback the current-time indicator oscillated back and forth by a frame or two. The host smooths the indicator between child clock samples; a second, throttled state broadcast carried an older snapshot of the same clock and was allowed to move the indicator backward. The presented time is now monotonic while a timeline plays, late samples only slow it, and real rewinds such as loop restarts and seeks still apply immediately.
- Timelines authored at a speed other than 1× — Rive timelines carry a playback multiplier, and many production files use it (0.4×, 0.2×, even 0.02× and reversed −1×). The scrubber assumed 1×, so its indicator ran ahead of the real clock and snapped back. The child now reports the authored speed, the indicator advances at that speed, the readout shows the multiplier (for example "12 / 240 FR · ×0.2"), and reversed timelines keep left-to-right travel with the frame and time values, ruler and slider counting down.
- Stale timeline wrapper after switching artboards — When two artboards share an animation name, the runtime keeps the previous artboard's wrapper with a frozen clock; the child could report that frozen clock instead of the live one. Movement is now tracked per wrapper, so a frozen wrapper is never chosen while the live one advances.
- +8 more