📚 Technical Documentation

Rive App .RIV File Support

Complete guide to supported features, bindings, and best practices for working with .RIV files in Backstreaming

Current Panel Version: BETA

This documentation reflects the current beta version. Features are continuously being added. New capabilities will be released regularly.

Objective

This documentation explains what our platform's control panel can interpret and control from .riv files produced in the Rive App. Reading is based on data bindings defined in Rive App's state machines.

✅ Currently Supported Features

Our platform already supports various essential features for dynamic and interactive animation control through data bindings defined in Rive App.

Supported Bindings (State Machine Inputs)

Type
Support
Description
Trigger
✅ Supported
Triggers actions or transitions
Boolean
✅ Supported
Toggles states on/off
Number
✅ Supported
Controls properties such as position, size, rotation
Color
✅ Supported
Allows real-time color changes and effects
String
✅ Supported
Displays dynamic text and variables
Image
✅ Supported
Image changes via panel supported
List
✅ Supported
Support for value And element lists
Enum
✅ Supported
Switches between fixed states or categories

💡 Tip: These input types are displayed in appropriate interactive controls (buttons, text fields, selectors, etc.), allowing full integration into your livestreams or external systems.

❌ Features Not Yet Supported

We are constantly expanding our platform's capabilities. Below are items that are not yet compatible, but are on our implementation roadmap.

Data Bindings Not Yet Supported

Type
Status
Notes
Artboard Attributes
⛔ Not Supported
Reading attributes inside Artboard is not available yet

Structural Features Not Yet Supported

Item
Status
Notes
Multiple State Machines
⛔ Not Supported
Only the first state machine is currently read
Events
⛔ Not Supported
Custom events defined in Rive are not triggered
Mouse Interactions
⛔ Not Supported
Interactions like click or drag are not recognized yet
Listeners
⛔ Not Supported
Only the main artboard is recognized by the panel
Timeline Control
⛔ Not Supported
No direct timeline control unless linked to a state machine
Conditional Logic
⛔ Not Supported
Internal logic is not yet interpreted
External Data Integration
⛔ Not Supported
Integration with scoreboards, chats, APIs coming soon

📁 .RIV File Requirements

To ensure compatibility and proper functioning of your .RIV file, follow these guidelines:

1

Use only one state machine per file

(for now)

2

Name the inputs clearly and objectively

e.g. showScore, bgColor, teamName

3

Avoid lists and images with bindings

until support is implemented

4

Optimize the .riv file size

to avoid real-time loading overload

💡 Best Practices & Recommendations

Follow these best practices to ensure the best possible experience when working with .RIV files:

Test your .riv file directly in Rive App before uploading to the platform

Use only the currently supported binding types to ensure full functionality

Validate your file has a single state machine with clear input names

Keep .riv file size optimized for real-time streaming performance

In case of errors, send the file to our technical team for review

Stay updated – new features are constantly being released

🎯 Quick Reference

✅ Do's

  • ✓ Use supported binding types
  • ✓ Keep files optimized
  • ✓ Test in Rive App first
  • ✓ Use clear naming

❌ Don'ts

  • ✗ Don't use multiple state machines
  • ✗ Don't use lists or images
  • ✗ Don't create oversized files
  • ✗ Don't use unclear input names

Ready to create amazing overlays?

Upload your .RIV files and start controlling them in real-time

Have questions about Rive App or our platform? Send us feedback