Skip to content

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

License

Notifications You must be signed in to change notification settings

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

No packages published

Contributors 2

  •  
  •