Starting the LibreOffice Software With Parameters
By starting the LibreOffice software from the command line you can assign various parameters, with which you can influence the performance. The use of command line parameters is only recommended for experienced users.
|
For normal handling, the use of command line parameters is not necessary. A few of the parameters require a deeper knowledge of the technical background of the LibreOffice software technology. |
Starting the LibreOffice Software From the Command Line
- Under Windows, select Run from the Windows Start menu, or open a Shell under UNIX® based platforms.
- Under Windows, type the following text in the Open text field and click OK.
- Under UNIX based systems, type the following line of text, then press Return:
{install}/program/soffice {parameter}}
Replace {install} with the path to your installation of the LibreOffice software (for example, C:\Program Files\Office, or ~/office)
Where required, replace {parameter} with one or more of the following command line parameters.
Valid Command Line Parameters
| Parameter | Meaning |
|---|---|
| -help / -h / -? | Lists the available command line parameters to the console. |
| -writer | Starts with an empty Writer document. |
| -calc | Starts with an empty Calc document. |
| -draw | Starts with an empty Draw document. |
| -impress | Starts with an empty Impress document. |
| -math | Starts with an empty Math document. |
| -global | Starts with an empty Writer master document. |
| -web | Starts with an empty HTML document. |
| -show {filename.odp} | Starts with the Impress file {filename.odp} and starts the presentation. Enters edit mode after the presentation. |
| -minimized | Starts minimized. The splash screen is not displayed. |
| -maximized | Starts maximized. |
| -invisible | Starts in invisible mode.
Neither the start-up logo nor the initial program window will be visible. However, the LibreOffice software can be controlled and documents and dialogs opened via the API. When the LibreOffice software has been started with this parameter, it can only be ended using the taskmanager (Windows) or the kill command (UNIX based systems). It cannot be used in conjunction with -quickstart. More information is found in the LibreOffice Developer's Guide. |
| -nocrashreport | Disables the error report tool. |
| -norestore | Disables restart and file recovery after a system crash. |
| -nofirststartwizard | Disables the Welcome Wizard. |
| -quickstart | Activates the Quickstarter. |
| -accept={UNO string} | Notifies the LibreOffice software that upon the creation of "UNO Acceptor Threads", a "UNO Accept String" will be used.
More information is found in the LibreOffice Developer's Guide. |
| -env | Sets another environment for the program start.
Use soffice -env:UserInstallation=$(URL) where $(URL) is the URL of a folder that contains the "user" folder. |
| -p {filename1} {filename2} ... | Prints the files {filename1} {filename2} ... to the default printer and ends. The splash screen does not appear.
If the file name contains spaces, then it must be enclosed in quotation marks. |
| -pt {Printername} {filename1} {filename2} ... | Prints the files {filename1} {filename2} ... to the printer {Printername} and ends. The splash screen does not appear.
If the file name contains spaces, then it must be enclosed in quotation marks. |
| -o {filename} | Opens {filename} for editing, even if it is a template. |
| -view {filename} | Creates a temporary copy of {filename} and opens it read-only. |
| -n {filename} | Creates a new document using {filename} as a template. |
| -nologo | Disables the splash screen at program start. |
| -nodefault | Starts without displaying anything except the splash screen. |
| -nofirststartwizard | Add this parameter to the program start command to suppress the Welcome Wizard. |
| -display {display} | Sets the DISPLAY environment variable on UNIX based platforms to the value {display}. This parameter is only supported by the start script for the LibreOffice software on UNIX based platforms. |
| -headless | Starts in "headless mode" which allows using the application without user interface.
This special mode can be used when the application is controlled by external clients via the API. |