Skip to content

lewispinstein-hue/MotionView

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

89 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MotionView

Stars Downloads | Version Version

MotionView Logo

MotionView's creation was inspired by other visualizers such as Grafana and Graphy. Our goal was to create a high-performance versatile VRC dashboard that is packed full of features, easy to use, and easy to understand.



MotionView is a high-speed telemetry dashboard and live visualizer for VEX PROS teams. It turns a raw stream of terminal numbers into a highly visual, actionable representation of your robot's behavior. Stop guessing why your robot is failing, and start seeing it.

MotionView Dashboard

Core Features

  • Live Streaming: See your robot's exact path, heading, and speed drawn on a virtual 2D field.
  • Compare and Contrast: Overlay multiple datasets (such as actual and target velocities) on the graph at once.
  • Customizable UI: Pin critical variables as custom floating UI widgets, and drag floating widgets around the screen.
  • Path Planning: Draft, edit, and simulate routes interactively, then overlay your planned path onto a real recorded run.
  • Smart Telemetry: Create periodic set-and-forget watches and stream general-purpose logs over a high-speed binary protocol without eating up your V5 CPU.
  • Events are synced: Click on an event to see exactly where and what the robot was doing at that time.

Quick Start

  1. Download: Grab the latest release for your OS from the Releases Page.
  2. Demo: Download the Example Route, press Cmd + O in MotionView to open it, and press Space to watch a recorded run.
  3. Connect your Robot: Install MVLib into your PROS project to start streaming your own live data.

Docs

Keybinds

UX designed to keep your hands on the keyboard. Use the built-in keybinds to navigate MotionView. You can also view them inside MotionView through the help menu.

Keybinds
Context Keybind Action
Global Cmd + 1 Switch to Viewing mode
Global Cmd + 2 Switch to Planning mode
Global Cmd + Shift + K Clear everything (field + plan)
Global F Fit/reset field position
Global T Toggle Floating info panel
Viewing Space Play/Pause playback (or toggle Auto‑follow Head when live‑connected)
Viewing Cmd + O Open file selector
Viewing Cmd + K Clear Viewer
Viewing Cmd + S Start/stop live streaming (if connected)
Viewing Cmd + R Refresh & sync livestream (if streaming)
Viewing P Toggle Planned Overlay
Viewing G Toggle Floating Graph
Viewing Cmd + C Connect/disconnect
Viewing / Step to previous/next pose
Planning Space Play/Pause plan playback
Planning Delete / Backspace Delete selected waypoint(s)< td>
Planning / / / Nudge selected waypoint(s)
Planning Shift + ←/→/↑/↓ Nudge selected waypoint(s) by 5× step
Planning Cmd + Z Undo
Planning Cmd + Shift + Z Redo
Planning Cmd + K Clear planned path

Version Compatibility

How to check your versions:

  • MotionView: Click the ? icon in the app, and look for the version number in the bottom left.
  • MVLib: Run pros c info-project in your terminal and look for libmvlib.

Because MotionView and MVLib communicate using a highly optimized binary protocol, you must ensure your desktop app and your PROS library are compatible.

MotionView App Requires MVLib Notes
v1.2.x v2.0.x Current Release: Introduced high-speed binary telemetry.
v1.1.x v1.1.x Non-binary data protocol
v1.0.x v1.0.x Legacy data protocol (missing some features)

About

A desktop app that live visualizes your robot for PROS Robotics

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors