LicenseRef-GPL licensed and maintained by Tom Murphy
This version can be pinned in stack with:vivid-osc-,2786

Module documentation for

Used by 1 package in nightly-2023-12-04(full list with versions):

Small, simple, and well-tested implementation of the Open Sound Control message format.

Example usage:

:set -XOverloadedStrings
msg = OSC "/foo" [OSC_S "bar", OSC_I 9, OSC_F 0.1, OSC_B "this-is-binary"]
:t msg
> msg :: OSC
:t encodeOSC msg
> encodeOSC msg :: ByteString
decodeOSC (encodeOSC msg) == Right msg
> True

Sending it over UDP (e.g. to TidalCycles), using the network package:

{-# LANGUAGE OverloadedStrings #-}
import Network.Socket
import Network.Socket.ByteString as SB

import Vivid.OSC

main = do
   -- Boring Network.Socket setup:
   (a:_) <- getAddrInfo Nothing (Just "") (Just "57120")
   s <- socket (addrFamily a) Datagram defaultProtocol
   connect s (addrAddress a)

   -- The interesting part:
   SB.send s $ encodeOSC $
      OSC "/play2" [OSC_S "cps", OSC_F 1.2, OSC_S "s", OSC_S "bd"]