Command Line

List of Files or Commands

If you start Kwave from the command line, you can specify a list of files that should be opened. The first specified file will be opened first, then the other files. Each file will be opened in an own new window or sub-window of the same Kwave instance. If you specify wildcards, you can open a large number of files at once.

For example, the following command starts a Kwave and opens all sounds provided by the freedesktop XDG sound theme, each in a new window or sub-window:

% kwave /usr/share/sounds/freedesktop/stereo/*.ogg

It is also possible to pass Kwave text commands, encoded as a special URI[1], this will be described in a later section.

GUI Type

The parameter --gui=SDI|MDI|TAB lets Kwave start in one of the three possible GUI modes: SDI, MDI or TAB.

Qt Toolkit options

In addition to a list of files, you can specify a list of Qt toolkit options like -qwindowgeometry for specifying the size and/or position of the first opened Kwave window and/or -display for starting the Kwave on a different display.

For example, the following command starts a Kwave window with an initial width of 600 pixels and a height of 400 pixels, with the right border positioned 30 pixels away from the right and 0 pixels away from the top of the screen.

% kwave --disable-splashscreen -qwindowgeometry 600x400-30+0

Startup Options

With the option --disable-splashscreen you can disable the splash screen that comes up when starting Kwave. This might be useful when you start Kwave from a script.

The command line option --iconic lets Kwave start up minimized (iconified). This might be useful when you want to start Kwave without GUI interaction, e.g. when running from a script. This option also implicitly disables the splash screen!

By using the command line option --logfile=kwave.log you can log the sequence of actions of a Kwave session into a file. This is useful for debugging, you might be asked for such a logfile when reporting an error.



[1] universal resource identifier