IDE Window: Run parameters

From Free Pascal wiki
Jump to navigationJump to search

Deutsch (de) English (en) français (fr) 日本語 (ja)


IDE Window - Run Parameters.png

Host Application

If your project executable and the executable to debug is different, you can specify here the other executable.

Default: leave empty

Command line parameters

Add here the command line parameters, with which your project should be started.

Default: leave empty

Note: Not used when using Lauching Application.

Launching application

If you want to start your project not directly, but via a script on in a terminal or a special profiler or a special debugger specify here the command line and enable the checkbox. Without this you can view output in internal console

On Linux if you run a console program from Lazarus, it is executed but no console is showing. To see the console program ran from Lazarus similarly to Windows, add /usr/bin/xterm $(TargetCmdLine) and check Use launching application (xterm is installed on almost all Linux systems).

Working directory

Normally the working directory of a debugged project is the executable directory. That means all relative file names are expanded by the working directory. You can override this directory here.

Note: On OSX, the system forces the current directory to '/' for all GUI applications, so this doesn't do anything


To show the application under X (gnome, kde, xfce) on another desktop, specify the Display command line variable. For example to show the application on the second desktop use :1. To show on another computer use or hydra:1.

Default Window/Console position and size

Light bulb  Note: * Lazarus 3.99
Light bulb  Note: * Windows Only

Set bounds for the console window (console app). For GUI apps set bounds for first window with Position = poDefault.

  • Console Window take Left/Top and Columns/Rows.
  • GUI apps take Left/Top and Width/Height.

If Width/Height is set without Left/Top then the OS may assume a Left/Top=0/0.


IDE Window - Run Parameters - Environment.png

Normally a debugged program starts with the same environment variables as the IDE itself.

System variables

Here you can see, what system variables are currently defined. You cannot change/override them.

User overrides

Add environment variable overrides for the debugged program. Do not confuse them with command line parameters or config variables. These variables can be retrieved by the program via such functions as GetEnvironmentVariable, GetEnvironmentVariableCount, Application.GetEnvironmentList.