Running ConsoleZ

Command line parameters

ConsoleZ supports these command line parameters:

-c <configuration file>

Specifies a configuration file.

-w <main window title>

Sets main window title. This option will override all other main window title settings (e.g. 'use tab titles' setting)

-ws <workspace>

Specifies a workspace file.

-t <tab type>

Specifies a startup tab type. Tab must be defined in ConsoleZ settings.

-n <tab name>

Specifies a startup tab name.

-d <directory>

Specifies a startup directory. If you want to parametrize startup dirs, you need to specify startup directory parameter as "%1"\ (backslash is outside of the double quotes)

-r <arguments>

Appends arguments to the startup shell command line. Do not confuse whith a command that you type in the shell!

-p <base priority>

Specifies shell base priority.
Idle: Specifies that the threads of this process run only when the system is idle.
The idle priority class is inherited by child processes.

BelowNormal: Specifies that the process has priority above Idle but below Normal.
The below normal priority class is inherited by child processes.

Normal: Specifies that the process has no special scheduling needs.

AboveNormal: Specifies that the process has priority above Normal but below High.

High: Specifies that the process performs time-critical tasks that must be executed immediately, regardless of the load on the operating system. The threads of the process preempt the threads of normal or idle priority class processes. Use extreme care when specifying High for the process's priority class, because a high priority class application can use nearly all available processor time.

Realtime: Specifies that the process has the highest possible priority. The threads of a process with RealTime priority preempt the threads of all other processes, including operating system processes performing important tasks. Thus, a RealTime priority process that executes for more than a very brief interval can cause disk caches not to flush or cause the mouse to be unresponsive.

-ts <sleep time>

Specifies a sleep time (in milliseconds) before starting next tab. Only used when multiple tabs are specified.

-v <visibility>

Specifies the visibility of the application.
Show: Shows the application.
Hide: Hides the application.
Switch: Switches the application visibility. Shows the application if it is hidden and hides the application if it is visible.

-reuse

Reuses another instance, if any exists, instead of starting a new one.

Note: -t option is not used to set tab's title. It specifies one of the names of the tabs defined in ConsoleZ settings.

Note: If you specify multiple -t options, you can specify multiple -d and -r options as well. In that case, each -t, -d and -r option will be grouped together.
If there is no corresponding -d option for a -t option, the initial directory from that tab's settings will be used.
For example:

Console.exe -t powershell -d C:\WINDOWS -r "-NoExit -Command """Write-Host 'Hello World' -ForeGroundColor yellow"""" -t cmd -d D:\ -t ncftp

Will start

• 'powershell' tab in C:\WINDOWS, running Write-Host 'Hello World' -ForeGroundColor yellow command in it
• 'cmd' tab in D:\.
• 'ncftp' tab will be started in the initial directory specified in its settings.

Note: -ts option can be useful if you want to start multiple instances of a tab, and tab's shell needs write access to some files during initialization Using -ts option, you can specify time to sleep between starting the next tab, giving each shell enough time to initialize itself.