add makeosc utility

apps/makeosc/README.md

@@ -0,0 +1,41 @@
+![npm](https://img.shields.io/npm/v/makeosc)
+
+# makeosc
+
+Simple NodeJS script for generating OSC bytes output to stdout.
+
+## Usage
+
+```
+Usage: makeosc [options]
+
+simple util to make osc buffers
+
+Options:
+  -V, --version        output the version number
+  --address <address>  OSC address
+  --args <args...>     osc args (default: [])
+  --slip               slip encode message (default: false)
+  --types <types...>   osc arg types (choices: "s", "i", "f", "b", default: [])
+  -h, --help           display help for command
+```
+
+- using npx `npx makeosc@latest --address /hello`
+- install using `npm install -g makeosc@latest` and run `makeosc --address /hello`
+
+## Notes
+
+- `--types` option is a space seperate list of type characters that will determine what the corresponding argument type will be set to
+  - optional
+  - uses type codes from the OSC spec
+- `--args` option is a space-separated list of arguments. If a corresponding type is not found in the `--types` option it will default to string (`s`).
+  - blobs (`b`) are to be entered as hex string representing the buffer to be sent so the ASCII string `hello` would be `68656c6c6f`
+- the default protocol is UDP but can be changed to TCP using the `--protocol` flag
+
+## Examples
+
+- `makeosc --address /test --args 1.0`
+- `makeosc --address /this/is/sent/via/tcp`
+- `makeosc --address /test/with/types --args 1 2.0 three --types i f`
+  - note that `types` is not the same length as `args` so the remaining argument (`three`) will default to string
+- `makeosc --address /blob --args 68656c6c6f --types b`