Skip to content

Latest commit

 

History

History
67 lines (50 loc) · 3.74 KB

README.md

File metadata and controls

67 lines (50 loc) · 3.74 KB

OSC.LINK

OSC.LINK is a control interface for realtime interaction between a mobile or desktop browser, and the OSC protocol. It was designed for the rapid-prototyping of multi-user media installations, and simple extensible deployment for mobile phone interaction without the cumbersome steps of joining a network, downloading an app, or signing up for an account.

By snapping a QR code or following a simple URL, user mobile devices are turned into input controllers that can send active and passive interaction data to a local client, and then fed to any platform that can recieve OSC, such as game engines, DAWs or media servers

screen1.png screen2.png screen3.png

Quickstart:

  • Head to the releases page and download the latest platform specific build for your system
  • Launch the app and join an available session from the list
  • Configure your destination application to listen to localhost IP(127.0.0.1), on specified port and IP
  • Interaction data from users that join this session from osc.link will now be sent over UDP to the target destination

Known Issues:

  • buttons send both the true and false messages at the same time, only on button release. seems to work as expected on desktop browser

TO DO / RFE wishlist:

  • ability to host multiple local sessions, with per session IP/port configuration. checkboxes instead of joining a specific server
  • hostside configuration for external IP beyond hardcoded localhosst

Future Roadmap:

  • implement user credential system for private sessions
  • implement admin dashboard for creation and customization of hosted sessions, with Name/Label attributes for each parameter, and a variety of parameter data types
    • button (momentary, toggle and radio type)
    • knob (min / max attributes, endless option, vertical/horz control option)
    • fader (min / max attributes, endless option, vertical/horz control option)
    • 2d pad
    • string float (optional submission button to send the string as a value)
    • dropdown menu
    • colorPicker (thumbnail with popup wheel or RGB/HSB faders)
  • Enable location/gps data

Changelog

[v.0.0.16] 2022-11-20

  • base impl for sending sensor data

[v.0.0.15] 2022-10-15

  • a script disables dragging for the browser when an osc.link server is joined
  • On mobile, y value is the full height of the phone screen, not true UV of the panel. this is the cause of some of the issues below
  • wide aspect browser windows on desktop are unable to reach the bottom of the float thrange on the Y axis of 2d control
  • Y gets distorted/cropped in landscape (same issue ^^^), under buttons
  • reverse sorted logging or adjustable limit of console readout for host feedback / FIFO

[v.0.0.14] 2022-10-8

  • Depricate "Disco Diffusion" branch from hamburger menu and publish String field parameter instead as data type
  • hostside configuration for Port instead of hardcoded destination
  • "Made by Laubsauger | Powered by socketosc" text needs to be offset with a depth layer behind the UI to avoid space collision conflicts. Currently the second session can't be joined from mobile on iphone13Pro for this reason (fine on larger screen android), and the conflict is present in Chrome browser, but can be scaled around
  • host side option to end a session and open a new session, instead of quitting application to join a new session

Credits:

built and maintained by Laubsauger

conception/direction: DRMBT

prototype forked from ThorneBrandt