vmrcli/README.md
2024-06-27 01:18:25 +01:00

54 lines
1.4 KiB
Markdown

# VMRCLI Command Line Utility
## `Tested against`
- Basic 1.1.1.1
- Banana 2.1.1.1
- Potato 3.1.1.1
## `Requirements`
- [Voicemeeter](https://voicemeeter.com/)
## `Use`
`./vmrcli.exe [-i] [-k] [-D] <api commands>`
Where:
- `i`: Enable interactive mode. If set any api commands passed will be ignored.
- `k`: The kind of Voicemeeter (basic, banana or potato). Use this to launch the GUI.
- `D`: Set log level 0=TRACE, 1=DEBUG, 2=INFO, 3=WARN, 4=ERROR, 5=FATAL
## `API Commands`
- Commands starting with `!` will be toggled, use it with boolean parameters.
- Commands containing `=` will set a value.
- All other commands with get a value.
Examples:
Launch basic GUI, set log level to INFO, Toggle Strip 0 Mute, then print its new value
`./vmrcli.exe -kbasic -D2 !strip[0].mute strip[0].mute`
Launch banana GUI, set log level to DEBUG, set Strip 0 label to podmic then print Strip 2 label
`./vmrcli.exe -kbanana -D1 strip[0].label=podmic strip[2].label`
## `Script files`
Scripts can be loaded from text files, for example in Powershell:
```powershell
./vmrcli.exe -D1 $(Get-Content .\example_commands.txt)
```
## `Official Documentation`
- [Voicemeeter Remote C API](https://github.com/onyx-and-iris/Voicemeeter-SDK/blob/main/VoicemeeterRemoteAPI.pdf)
## `Special Thanks`
- [rxi](https://github.com/rxi) for writing the [log.c](https://github.com/rxi/log.c) package