Files
veejay/veejay-current/veejay-utils/man/sayVIMS.1
Jerome Blanchi aka d.j.a.y ac4d57944a Improve help - sayVIMS
- fix existing examples
- add a third example using pipe
2019-06-16 00:53:19 +02:00

92 lines
2.2 KiB
Groff

.TH "sayVIMS" 1
.SH NAME
sayVIMS - sends VIMS messages to veejay
.SH SYNOPSIS
.B sayVIMS [options] [filename]
.SH DESCRIPTION
.B sayVIMS
is a simple program to send VIMS messages to veejay.
.SH OPTIONS
The command line options allow to specify its behaviour
.TP
.B \-p [3490]
Veejay port
.TP
.B \-h [localhost]
Veejay host
.TP
.B \-f [filename]
Use a filename instead of stdin
.TP
.B \-g [multicast address]
Multicast address
.TP
.B \-i
Start in interactive mode (use -? to get help, exit interactive mode typing 'quit')
.TP
.B \-c
Start with colored text
.TP
.B \-m
Send a single message and quit
.TP
.B \-d
Dump status line to stdout
.TP
.B \-b
Base64 encode binary data
.TP
.B \-v
Verbose
.SH USEFUL EXAMPLES
.TP
.B sayVIMS -h localhost -p3490 -m \/"017:;\/"
Start sayVIMS and connect to veejay (and tell veejay go to sample starting position)
.TP
.B sayVIMS -g 224.0.0.50 -p5000 -m \/"017:;\/"
Ditto, for multicast.
.TP
.B echo -e \/"17:;\/"\e\en\/"12:;\/" | sayVIMS
Start sayVIMS (auto connect to veejay) reading messages from stdin (tell veejay go to sample starting position and stop all samples)
.TP
.SH Message Format
A message is described as
.B <selector>:<arguments>;
.TP
For example:
.B 099:1 0;
.TP
The selector is a 3 digit number identifying some atomic function in veejay ("veejay -u|less" to list all events). The colon is used to indicate the start of the list of arguments. The semicolon denotes the end of message.
.TP
.SH Passing arguments
Each of veejay's functions except an ordered argument list ; depending on the
In case of messages clips, streams or effect chain some values refer to defaults or current:
.TP
.B 0 for current clip/stream
.TP
.B -1 for last clip/stream
.TP
.B > 0 any clip/stream number
.TP
.B -1 for current chain entry
.TP
.B >= 0 < 20 any chain entry
.SH AUTHOR
This man page was written by Niels Elburg.
If you have questions, remarks or you just want to
contact the developers, the main mailing list for this
project is:
.I veejay-users@lists.sourceforge.net
For more info see the website at
.I http://veejay.sourceforge.net
.SH HISTORY
This tool was first named 'sendVIMS' , but it
confused to much with 'sendVIMS for PD' although
the latter is derived from this one.
.SH "SEE ALSO"
.B veejay