JkwU8‖

fqXCA‖Starting LibreOfficeDev Software With Parameters

GVpcE‖By starting LibreOfficeDev 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

tBHoH‖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 LibreOfficeDev software technology.


rgL4d‖Starting LibreOfficeDev Software From the Command Line

fdsgu‖LibreOfficeDev requires write access to its user profile directory.

4EMfS‖Valid Command Line Parameters

4FPvV‖Using without special arguments

DhG66‖Using without any arguments opens the start center.

WEuAN‖{file}

r4DMd‖Tries to open the file (files) in the components suitable for them.

cEwT9‖{file} macro://./[Library.Module.MacroName]

XaUob‖Opens the file and applies specified macros from the file.


fMjzc‖Getting help and information

zRD6V‖Parameter

yxw9F‖Meaning

--help / -h / -?

YzQrF‖Lists the available command line parameters to the console.

--helpwriter

BdUtM‖Opens LibreOfficeDev built-in or online Help on Writer.

--helpcalc

VcKDf‖Opens LibreOfficeDev built-in or online Help on Calc.

--helpdraw

CsWp2‖Opens LibreOfficeDev built-in or online Help on Draw.

--helpimpress

yCDB2‖Opens LibreOfficeDev built-in or online Help on Impress.

--helpbase

Eaw8A‖Opens LibreOfficeDev built-in or online Help on Base.

--helpbasic

wNnP4‖Opens LibreOfficeDev built-in or online Help on Basic scripting language.

--helpmath

nsy2M‖Opens LibreOfficeDev built-in or online Help on Math.

--version

qdGmE‖Shows LibreOfficeDev version and quits.

--nstemporarydirectory

Eu4VH‖(macOS sandbox only) Returns path of the temporary directory for the current user and exits. Overrides all other arguments.


4t9KE‖General arguments

Parameter

Meaning

--quickstart[=no]

MDS3n‖Activates[Deactivates] the Quickstarter service. It can take only one parameter no which deactivates the Quickstarter service. Without parameters this service is activated.

--nolockcheck

GsDGX‖Disables check for remote instances using the installation.

--infilter=InputFilterName
[:InputFilterParam[,param]]

SDCFC‖Forces an input filter type, if possible. For example:

--infilter="Calc Office Open XML"

--infilter="Text (encoded):UTF8,LF,Liberation Mono,en-US".

wBsd4‖See the list of document filters for file conversion.

zxG8G‖The list of filter options for Lotus, dBase and Diff files.

Whm8z‖The list of filter options for CSV files.

Af2pi‖The list of filter options for PDF files.

--pidfile={file}

rcEZp‖Store soffice.bin pid to {file}.

--display {display}

8kbVi‖Sets the DISPLAY environment variable on UNIX-like platforms to the value {display}. This parameter is only supported by the start script for LibreOfficeDev software on UNIX-like platforms.


67rps‖User/programmatic interface control

Parameter

Meaning

--nologo

R8iS9‖Disables the splash screen at program start.

--minimized

QNjce‖Starts minimized. The splash screen is not displayed.

--nodefault

zXQmZ‖Starts without displaying anything except the splash screen.

--invisible

doxcd‖Starts in invisible mode.

F9L9o‖Neither the start-up logo nor the initial program window will be visible. LibreOfficeDev software can be controlled, and documents and dialogs can be controlled and opened via the API.

Rdt2A‖Using the parameter, LibreOfficeDev can only be ended using the taskmanager (Windows) or the kill command (UNIX-like systems).

tVXKn‖It cannot be used in conjunction with --quickstart.

LJCww‖More information is found in LibreOfficeDev Developer's Guide.

--headless

i4ZzA‖Starts in "headless mode" which allows using the application without user interface.

vCEcL‖This special mode can be used when the application is controlled by external clients via the API.

--norestore

pgHxs‖Disables restart and file recovery after a system crash.

--safe-mode

KvPh6‖Starts in a safe mode, i.e. starts temporarily with a fresh user profile and helps to restore a broken configuration.

--accept={UNO}

ovbPH‖Notifies LibreOfficeDev software that upon the creation of "UNO Acceptor Threads", a "UNO Accept String" will be used.

Ft66F‖UNO-URL is string the such kind uno:connection-type,params;protocol-name,params;ObjectName.

TrMTH‖More information is found in LibreOfficeDev Developer's Guide.

--unaccept={UNO-URL}

iME8Q‖Closes an acceptor that was created with --accept={UNO-URL}. Use --unaccept=all to close all open acceptors.

--language={lang}

g8cF6‖Uses specified language, if language is not selected yet for UI. The lang is a tag of the language in IETF language tag.


HqoWY‖Developer arguments

Parameter

Meaning

--terminate_after_init

5J9rm‖Exit after initialization complete (no documents loaded).


hntPb‖New document creation arguments

note

o63G2‖The arguments create an empty document of specified kind. Only one of them may be used in one command line. If filenames are specified after an argument, then it tries to open those files in the specified component.


Parameter

Meaning

--writer

Mi6E8‖Starts with an empty Writer document.

--calc

ucgzm‖Starts with an empty Calc document.

--draw

9jSmQ‖Starts with an empty Draw document.

--impress

GRBED‖Starts with an empty Impress document.

--math

caFeB‖Starts with an empty Math document.

--global

bfXLT‖Starts with an empty Writer master document.

--web

uEgej‖Starts with an empty HTML document.


Ro5GG‖File open arguments

note

o6ubd‖The arguments define how following filenames are treated. New treatment begins after the argument and ends at the next argument. The default treatment is to open documents for editing, and create new documents from document templates.


Parameter

Meaning

-n

NoRni‖Treats following files as templates for creation of new documents.

-o

ppxcs‖Opens following files for editing, regardless whether they are templates or not.

--pt {Printername}

QkAC5‖Prints the following files to the printer {Printername} and ends. The splash screen does not appear.

2Fa6r‖If the file name contains spaces, then it must be enclosed in quotation marks.

kydFB‖If used multiple times, only last {Printername} is effective for all documents of all --pt runs.

fqeqt‖Also, --printer-name argument of --print-to-file switch interferes with {Printername}.

-p

JCZLS‖Prints following files to the default printer, after which those files are closed. The splash screen does not appear.

cUCfJ‖If the file name contains spaces, then it must be enclosed in quotation marks.

--view

nP28K‖Opens following files in viewer mode (read-only).

LFfWt‖--show[=N]

stFL2‖Opens and starts the slideshow of the following presentation documents immediately. Files are closed after the showing. N in the example refers to the slide number and, when it is provided, they start at that slide.

--convert-to OutputFileExtension
[:OutputFilterName
[:OutputFilterParams[,param]]]
[--outdir output_dir]

5R6iA‖If --convert-to is used more than once, last value of OutputFileExtension[:OutputFilterName[:OutputFilterParams]] is effective. If --outdir is used more than once, only its last value is effective. In absence of --outdir, current working directory is used for the result. For example:

--convert-to pdf *.doc

--convert-to pdf:writer_pdf_Export --outdir /home/user *.doc

--convert-to "html:XHTML Writer File:UTF8" *.doc

--convert-to "txt:Text (encoded):UTF8" *.doc

wBsd4‖See the list of document filters for file conversion.

zxG8G‖The list of filter options for Lotus, dBase and Diff files.

Whm8z‖The list of filter options for CSV files.

Af2pi‖The list of filter options for PDF files.

--print-to-file [--printer-name printer_name] [--outdir output_dir]

EiUnD‖Batch print files to file. If --outdir is not specified, then current working directory is used as output_dir.

rDfJb‖If --printer-name or --outdir used multiple times, only last value of each is effective. Also, {Printername} of --pt switch interferes with --printer-name. For example:

--print-to-file *.doc

--print-to-file --printer-name nasty_lowres_printer --outdir /home/user *.doc

--cat

dZ48Y‖Applies filter "txt:Text" to the following text documents and dump text content to console (implies --headless). Cannot be used with --convert-to.

-env:VAR[=VALUE]

dmEjt‖Set a bootstrap variable. For example, to set a non-default user profile path:


n26C4‖Ignored switches

Parameter

Meaning

-psn

TyzK6‖Ignored (macOS only)

-Embedding

CyC5C‖Ignored (COM+ related; Windows only)

--nofirststartwizard

4BCWP‖Does nothing, accepted only for backward compatibility.

--protector {arg1} {arg2}

pZFD4‖Used only in unit tests and should have two arguments.