Starting the LibreOffice Software With Parameters

From LibreOffice Help
Jump to: navigation, search

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.

Note.png 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

  1. Under Windows, select Run from the Windows Start menu, or open a shell under Linux, *BSD, or Mac OS X platforms.
  2. Under Windows, type the following text in the Open text field and click OK.
  3. Under UNIX-like 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.
--version Displays the version information.
--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.
--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-like systems).

It cannot be used in conjunction with -quickstart.

More information is found in the LibreOffice Developer's Guide.

--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.

--unaccept={UNO string} Closes an acceptor that was created with --accept={UNO string}. Use --unaccept=all to close all open acceptors.
-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.
--nolockcheck Disables check for remote instances using the installation.
--nofirststartwizard Add this parameter to the program start command to suppress the Welcome Wizard.
--display {display} Sets the DISPLAY environment variable on UNIX-like platforms to the value {display}. This parameter is only supported by the start script for the LibreOffice software on UNIX-like 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.

--infilter={filter} Forces an input filter type, if possible. Eg. --infilter="Calc Office Open XML".
--convert-to output_file_extension[:output_filter_name] [--outdir output_dir] files Batch convert files. If --outdir is not specified, then current working directory is used as output_dir.
Eg. --convert-to pdf *.doc
--convert-to pdf:writer_pdf_Export --outdir /home/user *.doc
--print-to-file [--printer-name printer_name] [--outdir output_dir] files Batch print files to file. If --outdir is not specified, then current working directory is used as output_dir.
Eg. --print-to-file *.doc
--print-to-file --printer-name nasty_lowres_printer --outdir /home/user *.doc