From ArchWiki
Revision as of 11:48, 25 January 2014 by Orschiro (talk | contribs) (Troubleshooting)
Jump to navigation Jump to search


Chromium is an open-source graphical web browser from Google, based on the Blink rendering engine.


The open source project, Chromium, can be installed with the package chromium, available in the official repositories. In the AUR you can also find:

  • chromium-devAUR - the development version (beware: compiling Chromium takes at least as long as compiling the Linux kernel!)
  • chromium-browser-binAUR - the binary version of the latest Chromium build

The modified browser, Google Chrome, bundled with Flash Player and PDF Reader, can be installed with the package google-chromeAUR, available in the AUR. In the AUR you can also find:

Tip: See these two articles for an explanation of the differences between Stable/Beta/Dev, as well as Chromium vs. Chrome and the version numbers.

SRWare Iron, a modified Chromium with altered settings to increase privacy and with built-in ad-blocker, can be installed with the package iron-binAUR, available in the AUR.


Set Chromium as default browser

This behaviour is related to xdg-open: see xdg-open#set the default browser. For more information about the topic in general, see Default Applications.

File associations

This behaviour is related to xdg-open: see xdg-open#Configuration. For more information about the topic in general, see Default Applications.

Font rendering

Chromium (and Google Chrome) will use the settings in ~/.config/fontconfig/fonts.conf. For possibly better rendering you may try the following. Create the file if it does not already exist.

<match target="font">
  <edit mode="assign" name="autohint"><bool>true</bool></edit>
  <edit mode="assign" name="hinting"><bool>true</bool></edit>
  <edit mode="assign" name="hintstyle"><const>hintslight</const></edit>

If the fonts are still rendered badly, you can use Xft settings as suggested here:

! Xft settings ---------------------------------------------------------------
Xft.dpi:        96
Xft.antialias:  true
Xft.rgba:       rgb
Xft.hinting:    true
Xft.hintstyle:  hintslight

Then update the X Resources database using:

$ xrdb -merge ~/.Xresources
Note: These settings will affect any application that uses X Resources for font settings; e.g. rxvt-unicode.

Flash Player plugin

Adobe Flash Player (Netscape plugin API)

Warning: This version will not be updated (except for security updates), and is stuck at version 11.2. It will be completely disabled by April 2014.[1]

The Adobe Flash plugin can be installed with the package flashplugin, available in the official repositories.

Adobe Flash Player (Pepper plugin API)

While the classic Flash plugin will not be updated for Linux, an updated Flash Player is included with Google Chrome. It is compatible with Chromium and Iron.

The easiest way to install pepper-flash for Chromium is using one of the packages provided in the AUR:

  • If you have still flashplugin installed, in order for Chromium to use this new Pepper Flash plugin, please make sure the plugin location from /usr/lib/mozilla/plugins/ is disabled and /usr/lib/PepperFlash/ is enabled in chrome://plugins.
  • If you use SRWare Iron, and have still flashplugin installed and if the Pepper Flash doesn't show up in the plugins list, then disable and start Iron with:
$ iron --ppapi-flash-path=/usr/lib/PepperFlash/ --ppapi-flash-version=11.9.900.117

PDF viewer plugin

There are multiple ways of enabling PDF support in Chromium that are detailed below.


libpdf is Google's own implementation of a PDF renderer included with Google Chrome. It is compatible with Chromium and Iron.

The easiest way to install libpdf for Chromium is using one of the packages provided in the AUR:

Enable the plugin in chrome://plugins.

Note: As a new version of Chromium will not update, it may become incompatible. Thus and with respect to possible security fixes it is advisable to update both at the same time.
Note: To install libpdf for other Chromium packages, edit the PKGBUILD of chromium-libpdfAUR to install into correct path. For example, to install it for chromium-browser-binAUR, replace
install -m644 opt/google/chrome/ "${pkgdir}/usr/lib/chromium"


install -m644 opt/google/chrome/ "${pkgdir}/opt/chromium-browser"

Using mozplugger


Using the KParts plugin



Chromium uses NSS for the certificate management. Certificates can be managed in SettingsShow advanced settings...Manage Certificates....

Tips and tricks



Cracking Sound

There have been reports of cracking sound with chromium over hdmi audio. Start chromium with a different audio buffer size to fix the issue:

$ chromium --audio-buffer-size=2048

Proxy settings

There have been many situations in which proxy settings do not work properly, especially if set through the KDE interface. A good method as of now is to use Chromium's command-line options, like --proxy-pac-url and --proxy-server, to set your proxy.

Default profile

If you cannot get your default profile when you try to run Chromium and get a similar error instead:

$ chromium
[2630:2630:485325611:FATAL:chrome/browser/] Check failed: profile. 
Cannot get default profile. Trace/breakpoint trap

You have to set the correct owner of the directory ~/.config/chromium as following:

# chown -R yourusername:yourusergroup ~/.config/chromium


Sometimes, Chromium will disable WebGL with certain graphics card configurations. This can generally be remedied by typing about:flags into the URL bar and enabling the WebGL flag. You may also enable WebGL by passing the command line flag --enable-webgl to Chromium in the terminal.

There is also the possibility that your graphics card has been blacklisted by Chromium. To override this use the --ignore-gpu-blacklist flag or go to about:flags and enable Override software rendering list.

If you're using Chromium with Bumblebee, WebGL might crash due to GPU sand-boxing. In this case, you can disable GPU sand-boxing with optirun chromium --disable-gpu-sandbox.

Google Play and Flash

DRM content on Flash still requires HAL to play. This is readily apparent with Google Play Movies. If one attempts to play a Google Play movie without HAL, they will receive a YouTube-like screen, but the video will not play. See Flash DRM content for more information.

Note: It is necessary to use flashplugin since chromium-pepper-flashAUR does not work with this method.

Force 3D acceleration in Pepper Flash Player and i.g. the browser with radeon driver

To force 3D rendering there is an option "Override software rendering list" in chrome://flags, also you would have to export video acceleration variables, see ATI#Enabling_video_acceleration. You could check if it is working in chrome://gpu.

speech-dispatcher dumps core

Chromium installs speech-dispatcher as a dependency. The latter is an independent layer for speech synthesis interface and by default uses festival as its back end. If you are frequently receiving core dumps, it is likely caused by not having installed festival. To resolve the error message, either install festival or change the back end used by speech-dispatcher.

See also