README

ocaml-osc

Pure OCaml implementation of theOpen Sound Control protocol.

Dependencies:

• lwt (optional)

• ocplib-endian

• oUnit

• rresult

Usage

If you just need to parse and serialise OSC packets, use theOsc.Codec module:

# require "osc";;# open Osc.Types;;# let data = Osc.Codec.of_packet (Message {address = "/hello/world"; arguments = [Int32 123l; String "foo"]});;val data : bytes = "/hello/world\000\000\000\000,is\000\000\000\000{foo\000"# let packet = Osc.Codec.to_packet data;;val packet : (packet, [ `Missing_typetag_string | `Unsupported_typetag of char ]) Rresult.result =  Rresult.Ok (Message {address = "/hello/world"; arguments = [Int32 123l; String "foo"]})

To simplify sending and receiving OSC packets over the network, the modulesOsc_lwt andOsc_unix are available:

# require "osc.lwt";;# require "lwt.syntax";;# open Osc.Types;;# lwt client = Osc_lwt.Udp.Client.create ();;val client : Osc_lwt.Udp.Client.t = <abstr># let addr = Unix.ADDR_INET (Unix.inet_addr_of_string "127.0.0.1", 57120);;val addr : Lwt_unix.sockaddr = Unix.ADDR_INET (<abstr>, 57120)# lwt () = Osc_lwt.Udp.Client.send client addr (Message {address = "/hello/world"; arguments = [Int32 123l; String "foo"]});;

1. osc= version
2. ocaml>= "4.08"
3. dune>= "2.9"
4. base-unix

1. ounitwith-test

None

None