NAME

Mylene3e8 - control Mylene1f4 server

SYNOPSIS

Mylene3e8 [OPTIONS] PATH|PORT COMMAND [ARGUMENT]...

DESCRIPTION

Mylene3e8 sends commands to the Mylene1f4 established local TCP (UNIX) or TCP/IP (INET) server. The local TCP server is assumed receiving connection requests on PATH while the TCP/IP server is assumed running on local host and PORT port.

OPTIONS

-i, --inet

Connect to the INET server.

-l, --list

List available commands and exit.

-u, --unix

Connect to the UNIX server (default).

-x, --synchronize

Wait for command execution completion.

--help

Print a usage message and exit with a status code indicating success.

--version

Print version information on standard output then exit.

COMMANDS

abort

Abort current program execution.

add

[album|artist|comment|match|title|year STRING]... [current INTEGRAL]... STRING Add the file specified by last command argument to files list. If the files list is a tagged one (specifiable via -i and --tagged-list options) the file artist, year, album, title and comment properties can be specified as artist and match, year, album, title and comment, respectively. If the files list is not a tagged one the file properties information is discarded.

The file will be added at the end of current files list if no insert position is indicated (via the current command option).

If an insert position is indicated (via the current command option) the file will be inserted before the file for which the index in current files list matches the INTEGRAL argument of the current option if such argument is not negative, otherwise before the file for which the index in current files list matches the sum of execution files list length, 1 and INTEGRAL. If an insert position is specified and it is less than the negated sum of files list length and 1 or greater than the files list length the command is ignored.

The newly added file will have the initial index set to the initial index of the last previously added file plus one.

album STRING

Set album filter criterion to STRING match.

album/ STRING

Set album filter criterion to STRING match and refilter the currently playing file. Same as album STRING, join sequence.

album@

Set album filter criterion to the current file album property match.

album^

Reset album filter criterion to Mylene1f4 default.

album^/

Reset album filter criterion to Mylene1f4 default and refilter the currently playing file. Same as album^, join sequence.

artist STRING

Set artist filter criterion to STRING match.

artist/ STRING

Set artist filter criterion to STRING match and refilter the currently playing file. Same as artist STRING, join sequence.

artist@

Set artist filter criterion to the current file artist property match.

artist^

Reset artist filter criterion to Mylene1f4 default.

artist^/

Reset artist filter criterion to Mylene1f4 default and refilter the currently playing file. Same as artist^, join sequence.

attach

Ask Mylene1f4 to re-attach the system audio device.

back

Same as back INTEGRAL with INTEGRAL set to 1.

back INTEGRAL

If Mylene1f4 current load order is random same as rand, otherwise as it follows. Skip behind the number of files specified by INTEGRAL (current one included). If the selected file does not match the filter criteria the first previous (with respect to the just selected file) that does will be selected instead. The file repeating will be reset as for cycle off. Same as skip -INTEGRAL.

back*

Same as back* INTEGRAL with INTEGRAL set to 0.

back* INTEGRAL

Skip to the INTEGRAL indexed file. Files are indexed starting with 0 from the files list tail to files list head. If INTEGRAL is negative the index of the file to skip to is computed as the sum of INTEGRAL and the number of the files in the files list. If the selected file does not match the filter criteria the first next (with respect to the just selected file) that does will be selected instead. The file repeating will be reset as for cycle off. Same as skip* -INTEGRAL.

basename STRING

Set basename filter criterion to STRING match.

basename/ STRING

Set basename filter criterion to STRING match and refilter the currently playing file. Same as basename STRING, join sequence.

basename^

Reset basename filter criterion to Mylene1f4 default.

basename^/

Reset basename filter criterion to Mylene1f4 default and refilter the currently playing file. Same as basename^, join sequence.

begin [[HOURS:]MINUTES:]SECONDS[,FRAMES]

Set the play start stream time to specified time offset.

begin^

Reset the play start to Mylene1f4 default play start stream time (specified via -e or --start-time options) or frame index (specified via -f or --start-frame options). Same as start^.

comment STRING

Set comment filter criterion to STRING match.

comment/ STRING

Set comment filter criterion to STRING match and refilter the currently playing file. Same as comment STRING, join sequence.

comment@

Set comment filter criterion to the current file comment property match.

comment^

Reset comment filter criterion to Mylene1f4 default.

comment^/

Reset comment filter criterion to Mylene1f4 default and refilter the currently playing file. Same as comment^, join sequence.

cycle

Toggle repeating the currently playing file.

cycle CARDINAL

Repeat the currently playing file as many times as CARDINAL.

cycle off

Move to next target after completing playing file.

cycle on

Repeat forever the currently playing file.

cycle+ INTEGRAL

Repeat the currently playing file as many more times as INTEGRAL. If the currently playing file is repeated forever and INTEGRAL is negative cycle+ INTEGRAL is same as cycle off, otherwise cycle+ INTEGRAL is same as cycle INTEGRAL. If the currently playing file is not going to be repeated and INTEGRAL is negative cycle+ INTEGRAL has no effect, otherwise cycle+ INTEGRAL is same as cycle INTEGRAL. If the currently playing file is going to be repeated, but not forever, INTEGRAL will be added to the number of times for which the file would be repeated. If the resulting number is negative the effect is that of cycle off. Same as cycle- -INTEGRAL.

cycle- INTEGRAL

Repeat the currently playing file as many less times as INTEGRAL. If the currently playing file is repeated forever and INTEGRAL is positive cycle- INTEGRAL is same as cycle off, otherwise cycle- INTEGRAL is same as cycle -INTEGRAL. If the currently playing file is not going to be repeated and INTEGRAL is positive cycle- INTEGRAL has no effect, otherwise cycle- INTEGRAL is same as cycle -INTEGRAL. If the currently playing file is going to be repeated, but not forever, INTEGRAL will be subtracted from the number of times for which the file would be repeated. If the resulted number is negative the effect is that of cycle off. Same as cycle+ -INTEGRAL.

delete INTEGRAL

Remove the INTEGRAL indexed program from the execution queue. If INTEGRAL is negative the index of the program to remove is computed as the sum of INTEGRAL and the number of the programs in the queue. If INTEGRAL is less than the negated execution queue length or equal or greater than the execution queue length the command is ignored.

delete play class|start INTEGRAL

Remove the INTEGRAL indexed program from the play class or play start execution list. If INTEGRAL is negative the index of the program to remove is computed as the sum of INTEGRAL and the number of the programs in the target list. If INTEGRAL is less than the negated target execution list length or equal or greater than the target execution list length the command is ignored.

deque

Remove last program from the execution queue.

deque CARDINAL

Remove last CARDINAL programs from the execution queue.

deque all

Remove all programs from the execution queue.

detach

Ask Mylene1f4 to temporarily detach the system audio device.

exit

Exit Mylene1f4. On some systems exiting Mylene1f4 went INET via a Mylene3e8 transmitted command will cause the blocking of the port on which Mylene1f4 was listening for quite a while.

filter STRING

Set complex filter criterion to STRING. Syntax is the same as for Mylene1f4 complex filter criterion specified via -F or --filter options.

filter/ STRING

Set complex filter criterion to STRING and refilter the currently playing file. Syntax is the same as for Mylene1f4 complex filter criterion specified via -F or --filter options. Same as filter STRING, join sequence.

filter^

Reset complex filter criterion to Mylene1f4 default.

filter^/

Reset complex filter criterion to Mylene1f4 default and refilter the currently playing file. Same as filter^, join sequence.

flush

Discard cached audio data and restart decoding from current stream time offset. Whatever decoder setting were changed would come in effect, including the MPEG layer 3 amplification and equalizer settings modified via l3amplification, l3frequency and l3level commands.

format STRING

Ask Mylene1f4 for some information formatted according to STRING. Formatting rules are the same as for regular Mylene1f4 progress formatting. Errors in STRING are not detected and if present will cause a protocol error resulting most likely in a closed connection.

insert INTEGRAL PROGRAM

Insert PROGRAM program before the INTEGRAL indexed program in the execution queue. If INTEGRAL is negative the program is inserted before the program indexed by the sum of execution queue length, 1 and INTEGRAL. If INTEGRAL is less than the negated sum of execution queue length and 1 or greater than the execution queue length the command is ignored.

insert INTEGRAL STRING PROGRAM

Insert STRING entitled PROGRAM program before the INTEGRAL indexed program in the execution queue. If INTEGRAL is negative the program is inserted before the program indexed by the sum of execution queue length, 1 and INTEGRAL. If INTEGRAL is less than the negated sum of execution queue length and 1 or greater than the execution queue length the command is ignored.

insert play class|start INTEGRAL PROGRAM

Insert PROGRAM program before the INTEGRAL indexed program in the play class or play start execution list. If INTEGRAL is negative the program is inserted before the program indexed by the sum of target execution list length, 1 and INTEGRAL. If INTEGRAL is less than the negated sum of target execution list length and 1 or greater than the target execution list length the command is ignored.

insert play class|start INTEGRAL STRING

PROGRAM Insert STRING entitled PROGRAM program before the INTEGRAL indexed program in the play class or play start execution list. If INTEGRAL is negative the program is inserted before the program indexed by the sum of target execution list length, 1 and INTEGRAL. If INTEGRAL is less than the negated sum of target execution list length and 1 or greater than the target execution list length the command is ignored.

join

Refilter the currently playing file. If the currently playing file matches the filter criteria no further action is taken, otherwise the first next file (with respect to the loading order) that does is loaded, case in which the file repeating is switched off (as for cycle off).

l3amplification REAL

Set amplification for MPEG layer 3 streams to REAL (same amplification as the Mylene1f4 via --layer3-amplification option specifiable one). The new setting does not affect the current MPEG layer 3 stream playback. Refer the flush command for immediate effect.

l3frequency CARDINAL REAL

Set frequency for MPEG layer 3 streams CARDINAL indexed equalizer band to REAL (same equalizer as the one for which the band frequencies may be specificied via Mylene1f4 --layer3-frequencies option). The new setting does not affect the current MPEG layer 3 stream playback. Refer the flush command for immediate effect.

l3level CARDINAL REAL

Set level for MPEG layer 3 streams CARDINAL indexed equalizer band to REAL (same equalizer as the one for which the band levels may be specificied via Mylene1f4 --layer3-levels option). The new setting does not affect the current MPEG layer 3 stream playback. Refer the flush command for immediate effect.

mail CARDINAL CARDINAL STRING

Deliver the program identified by the CARDINAL and CARDINAL major and minor IDs, respectively, the STRING message.

match STRING

Same as artist STRING.

match/ STRING

Same as artist/ STRING.

match@

Same as artist@.

match^

Same as artist^.

match^/

Same as artist^/.

move INTEGRAL INTEGRAL

Remove the program indexed by the first INTEGRAL argument from the execution queue and reinserted it before the program indexed by the second INTEGRAL argument. If first INTEGRAL argument is negative the index of the program to remove is computed as the sum of first INTEGRAL argument and the number of the programs in the queue (same as for delete command). If the second INTEGRAL argument is negative the program is inserted before the program indexed by the sum of execution queue length, 1 and second INTEGRAL argument (same as for insert command).

order back|last|next|previous|random

Set load order (the same load order as for Mylene1f4 -L and --load-order options).

order^

Reset load order to Mylene1f4 default (the one specified via -L or --load-order options).

path STRING

Set path filter criterion to STRING match.

path/ STRING

Set path filter criterion to STRING match and refilter the currently playing file. Same as path STRING, join sequence.

path^

Reset path filter criterion to Mylene1f4 default.

path^/

Reset path filter criterion to Mylene1f4 default and refilter the currently playing file. Same as path^, join sequence.

pause

Pause playing (same as space on).

pick INTEGRAL

Skip to the INTEGRAL indexed frame if INTEGRAL is not negative, to the frame count INTEGRAL difference indexed frame if INTEGRAL is negative and the frame count is known, ignore otherwise. The command is ignored if the currently playing file is an 1f42 map describing more than one audio streams.

pick+ INTEGRAL

Skip ahead the number of frames specified by INTEGRAL. The command is ignored if the currently playing file is an 1f42 map describing more than one audio streams.

pick- INTEGRAL

Skip behind the number of frames specified by INTEGRAL. The command is ignored if the currently playing file is an 1f42 map describing more than one audio streams.

play

Resume playing (same as space off).

progress1 STRING

Set format for printing stream header progress information to STRING. Formatting rules are the same as for regular Mylene1f4 progress formatting. Errors in STRING are not detected and if present will cause a protocol error resulting most likely in a closed connection.

progress1^

Reset format for printing stream header progress information to Mylene1f4 default.

progress2 STRING

Set format for printing frame progress information to STRING. Formatting rules are the same as for regular Mylene1f4 progress formatting. Errors in STRING are not detected and if present will cause a protocol error resulting most likely in a closed connection.

progress2^

Reset format for printing frame progress information to Mylene1f4 default.

progress3 STRING

Set format for printing stream trailer progress information to STRING. Formatting rules are the same as for regular Mylene1f4 progress formatting. Errors in STRING are not detected and if present will cause a protocol error resulting most likely in a closed connection.

progress3^

Reset format for printing stream trailer progress information to Mylene1f4 default.

queue PROGRAM

Queue PROGRAM program for execution. Same as insert INTEGRAL PROGRAM with INTEGRAL set to -1 or queue length.

queue STRING PROGRAM

Queue STRING entitled PROGRAM program for execution. Same as insert INTEGRAL STRING PROGRAM with INTEGRAL set to -1 or queue length.

quit

Same as exit.

rand

Move to a randomly selected file. The file repeating will be reset as for cycle off.

remove CARDINAL

Remove the last CARDINAL files from the files list. If the currently playing file belongs to the last CARDINAL it will only be removed once Mylene1f4 advances from it (to another file, if any). If the currently playing file was scheduled for deletion by a previous remove command, the last CARDINAL files not including it will be removed. If the files list become empty Mylene1f4 will exit.

remove current|initial CARDINAL

Remove the files for which the specified property (index in the current files list and index in the initial files list, respectively) matches CARDINAL. If the currently playing file is selected it will only be removed once Mylene1f4 advances from it (to another file, if any). If the files list become empty Mylene1f4 will exit.

restore

Restore files list order.

scrap

Schedule the currently playing file for deletion. The file will only be removed (from the files list) once Mylene1f4 advances from it (to another file, if any). If the files list become empty Mylene1f4 will exit.

seek [[HOURS:]MINUTES:]SECONDS[,FRAMES]

Jump to the specified time offset. The command is ignored if the currently playing file is an 1f42 map describing more than one audio streams.

seek+ [[HOURS:]MINUTES:]SECONDS[,FRAMES]

Seek forward the specified time amount. The command is ignored if the currently playing file is an 1f42 map describing more than one audio streams.

seek- [[HOURS:]MINUTES:]SECONDS[,FRAMES]

Seek backward the specified time amount. The command is ignored if the currently playing file is an 1f42 map describing more than one audio streams.

select^

Reset file selection criteria to Mylene1f4 defaults. Same as album^, artist^, basename^, comment^, filter^, path^, title^ sequence.

select^/

Reset file selection criteria to Mylene1f4 defaults and refilter the currently playing file. Same as select^, join sequence.

shuffle

(Re)shuffle the files list.

skip

Same as skip INTEGRAL with INTEGRAL set to 1.

skip INTEGRAL

If Mylene1f4 current load order is random same as rand, otherwise as it follows. Skip ahead the number of files specified by INTEGRAL (current one included). If the selected file does not match the filter criteria the first next (with respect to the just selected file) that does will be selected instead. The file repeating will be reset as for cycle off. Same as back -INTEGRAL.

skip*

Same as skip* INTEGRAL with INTEGRAL set to 0.

skip* INTEGRAL

Skip to the INTEGRAL indexed file. Files are indexed starting with 0 from the files list head to files list tail. If INTEGRAL is negative the index of the file to skip to is computed as the sum of INTEGRAL and the number of the files in the files list. If the selected file does not match the filter criteria the first next (with respect to the just selected file) that does will be selected instead. The file repeating will be reset as for cycle off. Same as back* -INTEGRAL.

space

Toggle pausing.

space off

Resume playing.

space on

Pause playing.

start CARDINAL

Set the number of audio frames that will be skipped at the beginning of each played file to CARDINAL.

start^

Reset the play start to Mylene1f4 default play start stream time (specified via -e or --start-time options) or frame index (specified via -f or --start-frame options). Same as begin^.

suspend

Suspend current program execution and (re)start executing the next program. The suspended program is reinserted in the execution queue in the first position and will be resumed once the newly (re)started program completes. Same as suspend INTEGRAL with INTEGRAL set to 1.

suspend INTEGRAL

Suspend current program and reinserted it before the INTEGRAL indexed program. If INTEGRAL is negative the program is inserted before the program indexed by the sum of execution queue length, 1 and INTEGRAL (same as for insert command).

title STRING

Set title filter criterion to STRING match.

title/ STRING

Set title filter criterion to STRING match and refilter the currently playing file. Same as title STRING, join sequence.

title@

Set title filter criterion to the current file title property match.

title^

Reset title filter criterion to Mylene1f4 default.

title^/

Reset title filter criterion to Mylene1f4 default and refilter the currently playing file. Same as title^, join sequence.

wind

Same as wind INTEGRAL with INTEGRAL set to 1.

wind INTEGRAL

If Mylene1f4 current load order is random same as rand, otherwise same as back INTEGRAL if Mylene1f4 current load order is previous, same as skip INTEGRAL if Mylene1f4 current load order is next. In other words, unless Mylene1f4 current load order is random skip ahead or behind the number of files specified by INTEGRAL (current one included) depending whether Mylene1f4 current load order is next or previous, respectively. In this very last case if the selected file does not match the filter criteria the first (with respect to the just selected file and Mylene1f4 current load order) that does will be selected instead. The file repeating will be reset as for cycle off.

Commands and command arguments defined as a set of alternatives may be abbreviated as long as the abbreviation is not ambiguous.

Time offsets in [[HOURS:]MINUTES:]SECONDS[,FRAMES] specification (as for begin, jump, jump+ and jump- command arguments) are computed as HOURS * 3600 + MINUTES * 60 + SECONDS + FRAMES / 60 seconds, with fields not being restricted to the 0 .. 59 range. No white space is allowed before and after : and , literal signs. FRAMES, HOURS, MINUTES and SECONDS are expected decimal specifications.

Where not otherwise specified, cardinal and integral number specifications are interpreted as C constant specifications, with 0x prefix indicating base 16, 0 prefix indicating base 8 otherwise and none of the two base 10.

EXAMPLES

Tell Mylene1f4 (went INET and using port 32767) start playing Crier La Vie at once:

Mylene3e8 -i 32767 title/ "Crier La Vie"

Play it forever:

Mylene3e8 -i 32767 cycle

Need to know what Mylene1f4 is playing:

Mylene3e8 -i 32767 format "%G(%t)\n"

to read:

Crier La Vie

Ask Mylene1f4 (assumed -r or --repeat cycling files in command line) to play every file for which title is Pas De Doute twice (disregarding all filter criteria):

Mylene3e8 -i 32767 queue "$(cat program)"

where program lists as:

mode i;



i = 0;

while (i < advance()) {

    i = i + 1;

    E_load();

    if (!match("Pas De Doute", title())) {

        E_down(2);

    }

}

SEE ALSO

Mylene1f4(1)

AUTHORS

Ciprian Niculescu