Open Sound Control encode/decode

Version on this page:
LTS Haskell 13.13:
Stackage Nightly 2019-03-20:
Latest on Hackage:

See all snapshots vivid-osc appears in

LicenseRef-GPL licensed and maintained by Tom Murphy

Module documentation for

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"]
Depends on 4 packages:
Used by 2 packages:
comments powered byDisqus