SYNTAX

irmp3 [option] [command ; command... ]

DESCRIPTION

This programm will try to guess the best communication method to your irmp3 daemon and send commands to it via this method
It can read from stdin from a file, or from the command line, and can send the orders eeither through a named pipe or a network connection depending on what the daemon provides.

SEARCHING STRATEGY

When invoqued, irmp3 will do it's best to behave intelligently. For input, if multiple possibilities are available, it will take only one in the following order :

file given as a -f option

arguments on the command line

standard input

for output, it will use the options given on the command line, in the command line order, filling missing fields as much as possible. If no command line output parameters are given, it will try the following

if fifo_enabled is set in the irmp3d config file, it will look for a fifo in the fifo_directory, with the pattern fifo_name

if mod_netctl is enabled, it will attempt to connect to localhost using port netctl_port

OPTIONS

-n, --network[=<Host>:[port]]

will only try network connection, if no host is specified, it will try localhost, if no port is specified, irmp3 will try to guess it from the config file

-p, --pipe[=<Pipename>]

will only try connection through a pipe, will try to guess the name from the config file if nothing is specified if nothing is specified

-f, --file[=<Filename>]

Will read the commands from the given file

-c, --config=[<Filename>]

the irmp3d config file from which default values will be read. defaults to /etc/irmp3d.conf

-v, --verbose

More verbose output, will tell the connection attempts and the orders sent. you can specify it multiple time to have even more output

-?, --help, --usage

Output help information and exit.

-V, --version

Output version information and exit.

FILES

/etc/irmp3d.conf

the config file will be used to try to find the irmp3d daemon. If the daemon uses fifo, it will try to connect through a fifo, if it uses mod_netctl, it will try to guess the port etc...

EXAMPLES

To send a stop order (leaving irmp3 guess the proper communication method), simply type

irmp3 stop

to send order contained in a file to an irmp3d on another machine through a network

irmp3 -n target_machine:target_port -f command_file

To give orders from standard input, through a pipe

irmp3 -p my_pipe

AUTHORS

Jeremy Rosen <[email protected]>