Skip to content

lewispinstein-hue/MotionView

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

90 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

Contributors