Skip to content

CobaltFusion/DebugVision

Repository files navigation

๐Ÿš€ DebugVision

The Software Oscilloscope for Developers

DebugVision turns your code into something you can see.

Instead of digging through logs or guessing performance issues, DebugVision lets you instrument your code with lightweight sample points and visualize runtime behavior like an oscilloscope - live, interactive, and precise.


โœจ What is DebugVision?

DebugVision is an open-source tool for visual debugging and profiling.

It helps you:

  • ๐Ÿ“Š Visualize timing and performance (latency, jitter, spikes)
  • ๐ŸŽฏ Trigger on specific events in your code
  • ๐Ÿ” Zoom into problem areas with high precision
  • ๐Ÿง  Understand complex runtime behavior at a glance

Oscilloscope ๐Ÿ‘‰ but for your software.

โœจ What can you build with this?

  • Visualize how your game loop behaves ๐ŸŽฎ
  • Explore timing in robotics or hardware projects ๐Ÿค–
  • Turn boring logs into interactive graphs ๐Ÿ“ˆ
  • Experiment and see how code behaves in real time

Screenshot of the /fastapi prototype

[Screenshot fastapi prototype] [Demo fastapi prototype]


โš™๏ธ How it works

  1. Add sample points to your code
  2. Run your application
  3. Watch your system behavior unfold visually

You can:

  • Track loop timing (min / max / average)
  • Inspect execution paths
  • Detect anomalies and performance regressions
  • Build custom visualizations for your domain

๐ŸŒ Architecture & Language Support

DebugVision is not tied to a single programming language.

๐Ÿง  Backends

  • โšก C++ backend (high-performance, low-level instrumentation)
  • ๐Ÿ Python backend (rapid prototyping & flexibility)
  • โž• Designed to support any language via extensible adapters

If you can emit structured runtime data, you can plug into DebugVision.


๐ŸŽจ Frontend (Work in Progress)

The visualization layer is still evolving ? and this is a great place to contribute.

Strong directions we are exploring:

  • ๐ŸŒ In-browser UI (cross-platform, zero install)
  • โšก JavaScript-based visualization
  • โš™๏ธ WebAssembly for performance-critical parts
  • ๐Ÿ“ฆ Modern frameworks like Svelte

The frontend is intentionally open-ended ? your ideas can shape it.


๐ŸŽฏ Why DebugVision?

Debugging shouldn't feel like guessing.

Traditional tools:

  • Logs ? too noisy
  • Breakpoints ? too slow
  • Profilers ? too abstract

DebugVision gives you:

  • โšก Real-time insight
  • ๐ŸŽจ Visual clarity
  • ๐Ÿงฉ Flexible instrumentation

๐Ÿ“ท Example Use Cases

  • Game loops (frame timing, spikes)
  • Embedded systems
  • Robotics / control loops
  • High-performance backend systems
  • Experimental projects & learning

๐ŸŒฑ New here? You're welcome.

You don't need to be an expert to contribute.

This project is especially friendly to:

  • ๐ŸŒธ Beginners in C++ / systems programming
  • ๐ŸŽ“ Students learning about performance & debugging
  • ๐Ÿ‘ฉโ€๐Ÿ’ป People from underrepresented groups in tech

If you're curious, motivated, and want to learn? you belong here.


๐Ÿ’ก Contributing

We're building something ambitious, and we need help.

You can contribute by:

  • Fixing bugs
  • Improving the UI/UX
  • Building frontend experiments ๐Ÿ‘€
  • Adding language backends
  • Writing docs or tutorials
  • Suggesting ideas

๐Ÿ‘‰ Check out: good first issue to get started


๐Ÿ› ๏ธ Vision

We want DebugVision to become:

The go-to tool for understanding software behavior visually.

Not just for experts but for any developer who wants clarity.


โค๏ธ Join Us

If you've ever thought:

"There must be a better way to understand what my code is doing..."

You're in the right place.


๐Ÿ”— Getting Started

About

A Software Oscilloscope and portable set of data collection and visualization tools

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors