From ArchWiki
Jump to navigation Jump to search

From Home - LibreOffice:

LibreOffice is the free power-packed Open Source personal productivity suite for Windows, Macintosh and Linux, that gives you six feature-rich applications for all your document production and data processing needs: Writer, Calc, Impress, Draw, Math and Base.


Install one of the following packages:

  • libreoffice-still is the stable maintenance branch, for conservative user.
  • libreoffice-fresh is the feature branch, with new program enhancements for early adopter or power user.

Check the optional dependencies pacman displays. If you use HSQLDB Embedded in LibreOffice Base, you must install a Java Runtime Environment. You may need hsqldb2-javaAUR to use some modules in LibreOffice Base.


LibreOffice includes support for GTK and Qt theme integration. See also Uniform look for Qt and GTK applications.

LibreOffice will try to autodetect the most suitable VCL UI interface based on your desktop environment. To force the use of a certain VCL UI interface, use one of the SAL_USE_VCLPLUGIN=gen, SAL_USE_VCLPLUGIN=kde5, or SAL_USE_VCLPLUGIN=gtk3 environment variables. These variables can be uncommented in /etc/profile.d/ or /etc/profile.d/

Note: When using the LXDE desktop environment, setting SAL_USE_VCLPLUGIN in /etc/profile.d/ has no effect since the SAL_USE_VCLPLUGIN environment variable is afterwards set to gtk by the script /usr/bin/startlxde. In order to use gtk3 toolkit with LXDE the SAL_USE_VCLPLUGIN environment variable needs to be set after launching the desktop environment.

However, if it looks like it is using Windows 95/98 icons, go to Tools > Options... in the menus (which presents the Options Dialog), then select LibreOffice > Accessibility and uncheck "Automatically detect high-contrast mode of operating system".

If that does not work immediately, you may need to change the icon set that is in use; this is also in the Options Dialog, under LibreOffice > View with two pop-up boxes for "Icon size and style" (the latter pop-up box should be changed to something other than "High-contrast").

If you prefer to disable the startup logo, open /etc/libreoffice/sofficerc, find the Logo= line and set Logo=0.

Note: This variable is unrelated with the Logo scripting support.

Extension management

The following additional extensions are available:

For more extensions, check the AUR, the built-in LibreOffice Extension manager, or libreplanet.

Language aids

Spell checking

For spell checking, please make sure hunspell is properly installed; this should be the case for both still and fresh LibreOffice versions. Then install a language dictionary for hunspell like hunspell-en_US for American English or hunspell-de for German. Then enable the Writing aids by selecting the check-box in Tools > Options > Language Settings > Writing Aids > Hunspell SpellChecker after restarting LibreOffice.


Unlike other languages, Finnish dictionaries use different naming. These four packages should be installed (in this order): libvoikko, malagaAUR, voikko-fiAUR, hfstospellAUR and voikko-libreofficeAUR.


Project Orthos provides more complete Greek spell checkers as Libreoffice extensions. Package libreoffice-extension-orthos-greek-dictionaryAUR provides a Greek-only spelling dictionary, while libreoffice-extension-orthos-greek-english-dictionaryAUR provides one that bundles Greek and US English.

Hyphenation rules

For hyphenation rules, you will need hyphen and a language hyphen rule set (hyphen-en for English, hyphen-de for German, etc).


For the thesaurus option, you will need libmythes and a mythes language thesaurus (like mythes-en for English, mythes-de for German, etc).


For Greek, instead of mythes-elAUR you may want to try out libreoffice-extension-orthos-greek-thesaurusAUR, which includes more words.

Grammar checking

Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: Unintelligible flow of ideas: LanguageTool is packaged as a LibreOffice extension, the reason for preferring the AUR package does not make sense. (Discuss in Talk:LibreOffice#)

For grammar checking, several tools are available. The most common is LanguageTool. While the languagetool is available, it is not packaged as a LibreOffice extension. It is thus recommended to install the LibreOffice extension manually or with libreoffice-extension-languagetoolAUR instead. Even though the extension comes bundled with LanguageTool, this does not conflict with languagetool.

After this extension has been installed, please make sure you have a Java 8 runtime installed (jre8-openjdk). Indeed, Languagetool uses Java and may slow down or briefly hang LibreOffice, particularly while opening documents. Fortunately this is usually only when initially opening a document and is usually not apparent otherwise. Once installed, you want to enable it as the default environment for LibreOffice. To do that go to "Tools" --> "Options" --> "Advanced" and select the appropiate JRE (it will be shown as 1.8.0) then press "Ok". You will be prompted to restart the LibreOffice suite. Once restarted you will be able to install Languagetools without trouble.

Other grammar tools can also be found on the LibrePlanet extension page, on the official LibreOffice Extensions website or OpenOffice's Website. Please note all OpenOffice extensions are guaranteed to work with LibreOffice.


French-speaking users are advantaged here: they do not need to install LanguageTool nor Java. Dicollecte provides a nice Python extension, specifically designed for Frenchs. You can install it from the website or via libreoffice-extension-grammalecte-frAUR. In any case, this extensions also comes with the French dictionaries otherwise provided by hunspell-fr.

Offline help for en-US

As of version 5.2.2, libreoffice-fresh provides the offline help files for en-US. Help files for different locales is provided by the appropriate libreoffice language package, (i.e., libreoffice-fresh-en-za provides the help files for en-ZA locales).

Installing macros

If you intend to use macros, you must have a Java Runtime Environment enabled.

The default path for macros in Arch Linux is different from most Linux distributions. Its location is: ~/.config/libreoffice/4/user/Scripts/.


A general way to track down problems is the safe mode in LibreOffice:

$ libreoffice --safe-mode

Font substitution

These settings can be changed in the LibreOffice options. From the drop-down menu, select Tools > Options > LibreOffice > Fonts. Check the box that says Apply Replacement Table. Type Andale Sans UI in the font box and choose your desired font for the Replace with option. When done, click the checkmark. Then choose the Always and Screen only options in the box below. Click OK. You will then need to go to Tools > Options > LibreOffice > View, and uncheck "Use system font for user interface". If you use a non-antialised font, such as Arial, you will also need to uncheck "Screen font antialiasing" before menu fonts render correctly.


Merge-arrows-2.pngThis article or section is a candidate for merging with Font configuration.Merge-arrows-2.png

Notes: please use the second argument of the template to provide more detailed indications. (Discuss in Talk:LibreOffice#)


$ echo "Xft.lcdfilter: lcddefault" | xrdb -merge

To make the change persistent, add Xft.lcdfilter: lcddefault to your ~/.Xresources file, and make sure to run $ xrdb -merge ~/.Xresources (source). See X resources for more details.

If this does not work, you can also try adding Xft.lcdfilter: lcddefault to your ~/.Xdefaults. If you do not have this file, you will have to create it.

Hanging when using NFSv3 shares

If LibreOffice hangs when trying to open or save a document located on a NFSv3 share, try prepending the following lines with a # in /usr/lib/libreoffice/program/soffice:

# file locking now enabled by default

To avoid overwriting on update you can copy /usr/lib/libreoffice/program/soffice in /usr/local/bin. Original post here.

LibreOffice does not detect my certificates

If you cannot see the certificates when trying to sign a document, you will need to have the certificates configured in Mozilla Firefox (or Thunderbird). If after that LibreOffice still does not show them, set the MOZILLA_CERTIFICATE_FOLDER environment variable to point to your Mozilla Firefox (or Thunderbird) folder:

export MOZILLA_CERTIFICATE_FOLDER=$HOME/.mozilla/firefox/XXXXXX.default/

Certificate detection.

Run .pps files in edit mode (without slideshow)

The only solution is to rename the .pps file to .ppt.

Add the following script to your home directory and use it to open every .pps file. Very useful to open .pps files received by email without the need to save them.


f=$(mktemp --suffix .ppt)
cp "$1" "${f}" && libreoffice "${f}" && rm -f "${f}"

Media support

If embedded videos are just gray boxes, make sure to have installed the GStreamer plugins required.

Default paper size in Writer and Draw

If the default paper size in blank Writer and Draw documents is persistently incorrect for your locale, try installing the libpaper optional dependency and either updating /etc/papersize (for a system-wide change) or exporting the PAPERSIZE environment variable (for a user change) with your preferred paper size. See papersize(5).

Note: libpaper defaults to Letter paper size if nothing else has been set.

LibreOffice toolbars unreadable with dark themes


To use toolbar icons compatible with dark themes, set environment variable VCL_ICONS_FOR_DARK_THEME=1

As an alternative workaround, run libreoffice with a light theme (e.g. with environment variable GTK_THEME=Adwaita:light).

LibreOffice toolbars unreadable with dark Breeze/Plasma 5 theme

If you do not want to install breeze-gtk change the icon style in Tools > Options > LibreOffice > View > Icon Style to a readable one provided by LibreOffice.

Otherwise install the Breeze theme for GTK, breeze-gtk, and, if using a LibreOffice version < 5.3.0, the Breeze dark icons for LibreOffice, libreoffice-breeze-iconsAUR.

Just enable "Breeze Dark" or another readable icon style in Tools > Options > LibreOffice > View > Icon Style then.

If that is not enough, ensure that LibreOffice starts using the gtk interface - see #Theme.

If this still does not work correctly, try using the gen interface instead. [1]

LibreOffice Math formula editor unreadable with dark theme

Text in formula editor is also unreadable if a dark theme is in use. There is an ongoing bug report.

Some have had success with overriding text color in LibreOffice preferences, but that changes text color everywhere, such as the document itself, which is still white.

Only workaround known is to override the theme to a light one (e.g. GTK_THEME=Adwaita:light).

AutoText expected default behaviour not functional in system locales other than en_US

If expected default AutoText behaviour is not present (for example, typing fn in a document in Writer and then pressing the F3 key does not result in the automatic insertion of a numbered function) when the system locale is not en_US you need to add the default en_US AutoText templates to your AutoText path. To do this, go to Tools > AutoText, then click on Path... and add the following path to the list: /usr/lib/libreoffice/share/autotext/en-US. AutoText should now work as expected by default.

LibreOffice freezes

Disable OpenCL and/or OpenGL by setting the environment variable SAL_DISABLE_OPENCL=1 and/or SAL_DISABLEGL=1. The LibreOffice safe mode also offers the option to disable both.

See also