PM123's Command line Parameters

PM123 accepts a couple command line parameters:

pm123 [-configdir dir] [-pipe pipename] [-start] [-nogui] [-shuffle] [URL [URL ...]|-cmd command]

-configdir dir

Search in dir for the configuration files instead of the programs executable directory.⁽¹⁾

-pipe pipename

Use pipename instead of the name in the configuration file as remote pipe name. This applies to -cmd as well as to GUI starts. Note that OS/2 pipe names must start with \\PIPE\. Example: -pipe \\PIPE\MYPIPENAME

-start

Start PM123 if not yet running. This implicitly checks whether the pipe name is already used and if not PM123 keeps running. Otherwise the just started instance terminates immediately.

-nogui

Do not show the PM123 window by default. User interface windows might still be shown by the remote interface.

-shuffle (deprecated)

Shuffles files added from command line.

-cmd [host] command...

If host is omitted, send commands to local PM123, otherwise send commands to PM123 running on host. For a command listing, see PM123 Remote control. No further options must follow -cmd.

-smooth (not supported)

Ignored for compatibility with older PM123 versions.

PM123 also accepts MP3 files, URLs, playlists, directories, CD tracks and whatever a plug-in understands as command line parameters. The CD track can be specified as cd:///J:/Track XX, where J is a CD drive letter and XX is a CD track number. The effect is similar to dropping multiple files on PM123.

You must not start PM123 from a batch file with an explicit path. The current working directory must be the executables path. Otherwise PM123 will not find its DLLs.

Notes

1. OS/2 cannot load PM123's DLL modules if the current working directory is not the executable directory of PM123. So -configdir is the only chance to use a different configuration directory.