mirror of
https://github.com/jwetzell/osc-js.git
synced 2026-08-07 16:23:43 +00:00
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
|
|
|
|
# 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`
|