NAME

SYNOPSIS

DESCRIPTION

OPTIONS

or the later equivalent

Mylene1f4 --output skip --progress-type tags [FILE...]
Note that the --progress1 option argument might need quoting.
-l, --list PATH
Read files list from PATH. Ignore -i and --tagged-list requests. Two consequent file names (paths) are to be separated in PATH by one or more null (zero) bytes. Arguments in command line are ignored.
-o, --output STRING
Set output type. Possible values for STRING are device, null and skip. If device is specified Mylene1f4 will redirect PCM output to the program specified via -d or --device options. If null is specified Mylene1f4 will discard decoded PCM data. If skip is specified Mylene1f4 will skip PCM data decoding all together. Default value is device.
-p, --progress-type STRING
Set the formats for printing progress information to one of the built-in sets. Possible values for STRING are null, path, tags and x1f4. Note that tags style is not suited for console output, but for tagged lists generation. Use --progress-print in conjuction with --progress-type to examine the built-in sets.
-q, --quiet
Suppress error messages (all together).
-r, --cycle, --repeat
Restart playing FILE(s) after playing the last.
-s, --start INTEGRAL
Specify the index in the (shuffled, if requested) file list of the file that is to be played first. If negative it will be incremented with the number of files.
-t, --title STRING
Set the title file selection filter criterion to matching STRING. Only the files for which the title property matches the (wild card) STRING pattern will loaded.
-v, --verbose
Print some file and audio stream information on standard error. Can be specified more than once.
-x, --synchronize
Recover initial audio stream miss synchronization. By default Mylene1f4 will tolerate no errors in the decoded streams, not even alien data preceding audio streams. If initial audio stream miss synchronization recovery is requested Mylene1f4 will attempt to find a valid audio stream within specified source. Note that subsequent decoding errors will not be recovered.
--attached
Start system audio device attached (default). Mylene1f4 will ask the program to which it redirects PCM output to open the system audio device as it starts. Ignored if output was set (via -o or --output) to anything but device or no controlling server establishment was requested (via --inet-server or --unix-server).
--backward-seek-complaints
Allow backward seek complaints issued by the audio MPEG decoder when the frame being decoded refers non existent preceding frames (default).
--clear-title STRING
Discard the title of the next to be (via --queue) queued program.
--context-interrupt CARDINAL
Set the maximum number of instructions the programs in an execution context can execute continuously. If set to 0 the context programs execution will never be interrupted on not giving away control account (see --program-interrupt also). Otherwise, if the number of instructions executed on behalf of the programs in some execution context exceeds the indicated upper limit, all the programs in the execution context are discarded. Default is 65536. See PROGRAM EXECUTION for program execution information. Note that there is no direct relation between coded statement count and executed instruction count, though the latest does not usually exceed the first by more than twice.
--context-list-length CARDINAL
Set maximum context execution list length to CARDINAL. The limit is enforced for server received programs only. Default is 1024. See PROGRAM EXECUTION for program execution information.
--deque CARDINAL
Remove last CARDINAL (queued via --queue) programs from the execution queue.
--deque-all
Remove all (queued via --queue) programs from the execution queue.
--deque-last
Remove last (queued via --queue) program from the execution queue.
--detached
Start system audio device detached. Mylene1f4 will ask the program to which it redirects PCM output to not open the system audio device as it starts. Ignored if output was set (via -o or --output) to anything but device or no controlling server establishment was requested (via --inet-server or --unix-server).
--disable-expression-optimizations
Disable complex file selection filter criterion expression optimizations.
--disable-id3v2-read
Disable ID3 version 2 reading.
--dumb
Do not recover initial audio stream miss synchronization (default). See -x, --synchronize for initial audio stream miss synchronization recovery.
--enable-expression-optimizations
Enable complex file selection filter criterion expression optimizations (default).
--enable-id3v2-read
Enable ID3 version 2 reading (default).
--error STRING
Set load error behavior. Possible values for STRING are abort and ignore. If abort is specified Mylene1f4 will abort upon load errors. If ignore is specified Mylene1f4 will ignore load errors. Default value is abort.
--head-b-operators
List complex filter available binary operators and exit.
--head-p-b-operators
List program available binary operators and exit.
--id3v2-complaints
Allow ID3 version 2 parser complaints.
--id3v2-parser PATH
Set path to ID3 version 2 parser to PATH. The ID3 version 2 parser is a program that Mylene1f4 will execute to parse the version 2 ID3 tags from the played files. If PATH is void the default value is used. Default value is prefix/lib/Mylene1f4/id3v2-id3tag, where prefix is set at compile time and defaults to /usr/local.
--id3v2-timeout CARDINAL
Set ID3 version 2 loading timeout to CARDINAL microseconds (Mylene1f4 will wait no more than that much time for the ID3 version 2 parser to complete execution). If zero is specified the default is used. CARDINAL is not restricted to 1 .. 1000000 range.
--id3v2-transfer CARDINAL
Set ID3 version 2 maximum transfer size to CARDINAL bytes (Mylene1f4 will read no more than that many bytes from the ID3 version 2 parser). If zero is specified the default is used. The option is not implemented and the default is always used.
--inet-server PORT
Establish a controlling TCP/IP server on the port specified by PORT. Ignore local TCP server establisment requested via --unix-server. Mylene1f4 will execute the commands received by server. Mylene3e8(1) is a typical Mylene1f4 client relaying user commands to the establised server. Note that there are no security mechanisms to restrict access to the server and any entity able to reach the network within which the server was established will be able transmit commands to be executed (read: mess up your sorry existence).
For now, option is ignored if output was set (via -o or --output) to anything but device.
See SERVER MODE for more on server related information.
--layer3-amplification REAL
Set MPEG layer III audio streams amplification to REAL. REAL is expected in the -20 .. 20 range.
--layer3-frequencies LIST
Set MPEG layer III audio streams equalizer band frequencies to LIST. LIST is expected a list of comma separated band frequency values in the 20 .. 20000 range. The default frequecies are 32, 64, 128, 256, 512, 1024, 2048, 4096, 8192 and 16384.
--layer3-levels
Set MPEG layer III audio streams equalizer band levels to LIST. LIST is expected a list of comma separated band level values in the -20 .. 20 range. The number of equalizer band levels must match the number of equalizer band frequencies.
--list-b-operators
List complex filter available binary operators and exit.
--list-directives
Display text formatting directives in a list view and exit.
--list-fs-operators
List complex filter available file selection concerned unary operators and exit.
--list-functions
List complex filter available functions and exit.
--list-p-b-operators
List program available binary operators and exit.
--list-p-fs-operators
List program available file selection concerned unary operators and exit.
--list-p-functions
List program available functions and exit (same as --list-q-functions).
--list-p-u-operators
List program available unary operators and exit.
--list-q-functions
List program available functions and exit (same as --list-p-functions).
--list-u-operators
List complex filter available unary operators and exit.
--mpeg-synchronization STRING
Set MPEG audio data synchronization method process for use when initial audio stream miss synchronization is (via -x or --synchronize) requested. Possible values for STRING are double, select and single. If double is specified the first frame header look alike byte sequence on which the occurrence of the next frame header can be successfully predicted is accepted as a close enough synchronization. If select is specified the first coherent frame headers sequence (in which the occurence of a frame header can be predicted from the previous header) is accepted as a close enough synchronization. The length of the sequence can be specified via --mpeg-synchronization-sequence and defaults to 4. If single is specified the first frame header look alike byte sequence is accepted as a close enough synchronization. Default value is select.
--mpeg-synchronization-seek CARDINAL
Do not examine more than CARDINAL bytes when looking for a valid MPEG audio stream. Mylene1f4 will enforce this limit only loosely and will actually examine more bytes (that is, if the limit is observed whatsoever). Default value is 4194304 (4 mega bytes).
--mpeg-synchronization-sequence CARDINAL
Set the synchronization frame headers sequence length for MPEG audio data synchronization select method. Default value is 4.
--no-backward-seek-complaints
Suppress backward seek complaints issued by the audio MPEG decoder when the frame being decoded refers non existent preceding frames.
--no-cycle, --no-repeat
Restart not playing FILE(s) after playing the last (default).
--no-id3v2-complaints
Suppress ID3 version 2 parser complaints, including execution errors (default).
--no-reuse-address
Reuse no address when binding the local INET controlling server (default). It is quite likely that the binding (establishing) of the INET controlling server will fail for some evil entity imagines that the address is already in use, even when it is obviously not.
--no-server-filter-complaints
Suppress server transmitted filter setting requests parsing complaints.
--no-server-format-complaints
Suppress server transmitted text formatting requests parsing complaints.
--no-server-progress-complaints
Suppress server transmitted progress formatting requests parsing complaints.
--no-shuffle
Shuffle not files list (default).
--null-process STRING
Set MPEG decoding process for (via -o or --output specified) null output to STRING. Possible values for STRING are 4294967291, futile, null, pcm1, real, skip, and utterly-futile. If 4294967291, pcm1 or real is specified the MPEG audio streams are fully decoded. If futile or null is specified the MPEG audio streams are parsed, yet not truly decoded. Note that this process is not supported for layer 3. If skip or utterly-futile is specified only the frame headers in MPEG audio streams will be examined. Default value is 4294967291 (which also happens to be the biggest prime number that fits in 32 bits, the second biggest being 4294967279, number that has no relevance yet for Mylene1f4).
--pack-directives
Display text formatting directives in a compacted tree view and exit.
--paused
Start paused. Ignored if no controlling server establishment was requested (via --inet-server or --unix-server).
--play-list-length CARDINAL
Set maximum play list length to CARDINAL. The limit is enforced for server received play list items (files, that is) only. Default is 65536.
--playing
Start playing (default). Ignored if no controlling server establishment was requested (via --inet-server or --unix-server).
--program-allocation CARDINAL
Set the limit for the memory a program may request allocated to CARDINAL. The limit refers strictly the memory allocation requests, i.e. it does not consider the usual memory management overhead. It does include the memory required for storing the executable representation of the program. Default is 2097152 (2 mega bytes). See PROGRAM EXECUTION for program execution information.
--program-interrupt CARDINAL
Set the number of instructions a program can execute between two succesive effector function calls limit to CARDINAL. If set to 0 a program execution will never be interrupted on running for too long account. Default is 65536. See PROGRAM EXECUTION for program execution information. Note that there is no direct relation between coded statement count and executed instruction count, though the latest does not usually exceed the first by more than twice.
--progress-print
Display progress information formatting (resulting after merging --progress-type, --progress1, --progress2 and --progress3 options) and exit. The displayed formatting will be the one used if --progress-print would not have been specified.
--queue PROGRAM
Queue PROGRAM for execution. Can be specified more than once. See PROGRAM EXECUTION for program execution information.
--queue-length CARDINAL
Set maximum execution queue length to CARDINAL. The limit is enforced for server received programs only. Default is 4096. See PROGRAM EXECUTION for program execution information.
--request-transfer CARDINAL
Set maximum server received request transfer size to CARDINAL bytes. The requests for which the maximum transfer size is set are the requests received on the established UNIX or INET server. The connections on which requests bigger than the set threshold are received are closed. The default is 4096.
--reuse-address
Reuse local address when binding the local INET controlling server. If used all over the place this may reduce the failure rate of binding (establishing) an INET controlling server.
--server-filter-complaints
Allow server transmitted filter setting requests parsing complaints (default).
--server-format-complaints
Allow server transmitted text formatting requests parsing complaints (default).
--server-progress-complaints
Allow server transmitted progress formatting requests parsing complaints (default).
--store-title STRING
Set the title of the next to be (via --queue) queued program to STRING.
--unix-server PATH
Establish a controlling local TCP server on PATH. Ignore TCP/IP server establisment requested via --inet-server. Mylene1f4 will execute the commands received by server. Mylene3e8(1) is a typical Mylene1f4 client relaying user commands to the establised server.
For now, option is ignored if output was set (via -o or --output) to anything but device.
See SERVER MODE for more on server related information.
--unix-server-mode MODE
Set file permissions for established local TCP controlling server to integral MODE. MODE should include at least owner read/write permissions (00600). Default is 00600.
--tree-directives
Display text formatting directives in a tree view and exit.
--help
Print a usage message and exit with a status code indicating success.
--version
Print version information on standard output then exit.

All the file selection filter criteria, including the simple ones specified via -A or --album, -B or --basename, -P or --path, -a or --artist, -c or --comment and -t or --title and the more sophisticated one specified via -F or --filter are enforced when loading files (meaning that a file will have to pass every and each of the set filters to be loaded).

For the simple filter criteria the match is a wild card match (it allows for the * and ? shell patterns). A * sequence matches everything, while an empty pattern (`') will match only files for which the correponding property exists but is empty. Matching is case sensitive. Note that the matched file properties are white space trimmed (white space is removed from both head and tail).

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

COMPLEX FILTER SYNTAX

PROGRAM EXECUTION

PROGRAM EXECUTION QUEUE

PROGRAM CONTEXT EXECUTION LISTS

TEXT FORMATTING

SERVER MODE

MAPPED STREAMS SUPPORT

SEE ALSO

AUTHORS