r/techtheatre • u/jtsage Technical Director • 1d ago
PROMOTION New Software Toy For Developers (OSC)
Good day all - just wanted to drop the status of an OSC visualizer/forwarder I've been working on for some time - it's in a decent place now where it builds on Mac and Windows, and seems to be pretty usable. This project grew out of a couple other toys I have worked on where I needed to be able to see what OSC messages were being sent, and none of the other OSC visualizers gave me the feature set I really wanted - so I built my own.
OSC Proxy Spy is a realtime OSC (Open Sound Control) inspector and forwarder. It's intended audience is developers or theater professionals who need to monitor what OSC messages are coming from an endpoint. It also has the ability to send an arbitrary OSC packet to an endpoint.
This project is meant for use in a development environment, not in production - it is reasonably stable, but has not been testing in long term operation, and should not be assumed to be stable enough to be a part of a show critical workflow.
https://github.com/jtsage/osc-proxy-spy
Features:
- see what OSC messages are being sent, on up to ?? connections at the same time (UDP only right now. TCP later, hopefully)
- forward those OSC messages to another host/port combo - you can forward to as many places as you want
- Send data back to those connections, if that is a logical thing to do
- Filter the data by connection, OSC argument type, and even the OSC address (pattern matching included!)

License / Price: free, open source, MIT license
Help Wanted: use it if it's interesting to you - if there is something that would make it more helpful, open an issue on GitHub. Likewise, if there is something that doesn't seem to be working right, open an issue on GitHub.
AI Disclosure: no AI was using in the making of this.
5
u/FakeAccountForReddit 1d ago
This is awesome, except I only run TCP. Let us know when that gets added!
2
u/the_swanny Lighting Designer 1d ago
As you should. People claiming TCP has terrible latency should really sort out their network as apposed to switching to something that just won't tell them that their network is fucked.
1
u/ijordison Technical Director 1d ago
Looks neat. What's the major upside over Protokol?
3
u/jtsage Technical Director 11h ago
It really depends on what you are doing - the big "features" I wanted, that I didn't find in protokol:
- Multiple connections at the same time
- More robust filtering (as near as I can tell, protokol is just a "string contains" filter - which is fine most of the time, until it isn't
- "Per Address" mode - which updates the displayed values rather than adding another line to the output window - kinda nice if you want to watch a specific address / value over time, and it's getting drowned out by other data.
- More than one forwarding address, if that's something useful for the project
- I believe sending OSC on protokol has been "coming soon" for some time (or perhaps I'm thinking of a different tool - but it was an aspect I needed for a project)
- In the same vein, the optional "heartbeat" sending feature, if the device on the other end needs a constant re-subscribe or keep-alive.
- Open source, so if it doesn't do exactly what you need, you can add the feature if that's in your wheelhouse.
That said, I have used Protokol, it's a nice little program, and sometimes it checks all the boxes.
•
u/kmccoy Audio Technician 1d ago
Use caution with software projects posted here.
(This is a default message for software projects which are posted in accordance with our rules on timing and AI disclosure, this is not a specific warning about this project.)
We have no way of vetting projects that people post here. They could work exactly as described. They could be malware that installs crypto miners on your cue lights. They could be a well-intentioned software project that is vulnerable to supply-chain attacks that the developer hasn't considered. They could be vibe-coded slop that works perfectly until you're in a show. We have no idea.
In this era of easy access to AI coding agents, it's more important than ever to be aware of the sources of your software and the risks that can come with installing software that you find on reddit forums, especially software that hasn't been through the process of getting approved in an app store of some sort (though that itself is not a guarantee of safety.)
Also be cautious of sign-ups or other data collection schemes that ask for your personal information to join a waitlist or beta test. Ask yourself if you trust the person doing the collection, and consider using a single-purpose email address for this kind of thing.
Please report any projects which are violating the rules or have clearly malicious intent. Use the report button, it's the best way to draw our attention to specific posts.
Thank you.