Browser plugins

From ArchWiki
Revision as of 16:59, 3 March 2016 by Lahwaacz (talk | contribs) (→‎External links: use standard heading)
Jump to navigation Jump to search

zh-cn:Browser plugins

There are two types of browser plugins, based on the plugin API they use:

  • Netscape plugin API (NPAPI): these plugins work in Firefox and most other browsers (not in Chromium and Opera).
  • Pepper plugin API (PPAPI): these plugins work only in Chromium (and Chrome) and Opera.

Most plugins on this page are NPAPI-only, unless noted otherwise.

Flash Player

Adobe Flash Player


The package you will need to install depends on the browser you use.

  • The NPAPI version can be installed with the flashplugin package. This plugin was discontinued by Adobe and is stuck at version 11.2; although, Adobe will provide security updates for 5 years after its release (i.e. until March 2017[1][2]).
  • The PPAPI version is shipped with Google Chrome. If you are using Chromium or any other browser using the PPAPI interface such as Opera, see Chromium#Flash Player plugin for more information.


If you are using Firefox, please make sure to follow this instruction first.


To change the preferences (privacy settings, resource usage, etc.) of Flash Player, right click on any embedded Flash content (for instance the one on this page) and choose Settings from the menu.

You can also use the Flash settings file /etc/adobe/mms.cfg. Gentoo has an extensively commented example mms.cfg.

To enable VDPAU hardware video decoding, add/uncomment the following line:

EnableLinuxHWVideoDecode = 1

It might also be required to add/uncomment the following line:

OverrideGPUValidation = 1

Disable the "Press ESC to exit full screen mode" message

There is no solution other than patching the Flash plugin. Please note only the NPAPI plugin is supported. Install flash-fullscreen-patcherAUR[broken link: archived in aur-mirror] which provides wine as a required dependency since the patch has been initially made for Windows.

After the package has been installed, backup

# cp /usr/lib/mozilla/plugins/ /usr/lib/mozilla/plugins/ 

Then, patch

# -f /usr/lib/mozilla/plugins/

If you use Firefox and want to remove the message Press ESC to exit full screen mode in HTML5 videos too, go to about:config and set full-screen-api.warning.timeout to 0.

Alternatively, install Firefox extension Disable HTML5 Fullscreen Alert, which will suppress full screen warnings for HTML5 content.

Multiple monitor full-screen fix

When using a multiple monitor setup, or swapping between virtual desktops, it is possible to lose focus on a fullscreen flash window. In such a case, the adobe flash-plugin will automatically exit full-screen mode. This may not be to your liking.

Unfortunately, this behavior is hard coded into the binary. In order to change this behavior it is necessary to alter the binary.

Fixing this issue only works for the NPAPI plugin and this issue can be fixed via 3 ways.

After the package has been installed, backup
# cp /usr/lib/mozilla/plugins/ /usr/lib/mozilla/plugins/
Then, patch
# -i /usr/lib/mozilla/plugins/
After the package has been installed, backup
# cp /usr/lib/mozilla/plugins/ /usr/lib/mozilla/plugins/
Then, you will need to alter that file using a hex editor like ghex. You must open it with root privileges obviously.
# ghex /usr/lib/mozilla/plugins/
Using the hex editor find the string _NET_ACTIVE_WINDOW. In ghex the readable string is on the right hand side of the window, and the hex is on the left, you are trying to locate the readable string. It should be easy to find using a search function.
Upon finding _NET_ACTIVE_WINDOW rewrite the line, but do not change the length of the line, for example _NET_ACTIVE_WINDOW becomes _XET_ACTIVE_WINDOW.
Save the binary, and restart any processes using the plugin (as this will crash any instance of the plugin in use.)

Playing DRM-protected content

See Flash DRM content.


Shumway is an HTML5 technology experiment that explores building a faithful and efficient renderer for the SWF file format without native code assistance. As of 2013-01-01, the plugin may be installed directly from Mozilla's site. According to the Shumway wiki, "Integration with Firefox is a possibility if the experiment proves successful."

Shumway is also embedded in Firefox Nightly/Aurora builds.


See also Wikipedia:Gnash.

GNU Gnash is a free (libre) alternative to Adobe Flash Player. It is available both as a standalone player for desktop computers and embedded devices, as well as a browser plugin, and supports the SWF format up to version 7 (with versions 8 and 9 under development) and about 80% of ActionScript 2.0.

There are multiple packages available: gnashAUR[broken link: archived in aur-mirror], gnash-kde4AUR[broken link: archived in aur-mirror], gnash-gitAUR.

Note: If you find that Gnash does not work properly right out of the box, then you may also need to install the gstreamer0.10-ffmpeg package.


Lightspark is another attempt to provide a free alternative to Adobe Flash aimed at supporting newer Flash formats. Lightspark has the ability to fall back on Gnash for old content, which enables users to install both and enjoy wider coverage. Although it is still very much in development, it supports some popular sites.

Lightspark can be installed with the lightsparkAUR[broken link: archived in aur-mirror] or lightspark-gitAUR package.

Video players workarounds

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: What does this do? Why is it related to Flash Player? (Discuss in Talk:Browser plugins#)

Open-with Firefox extension

  1. Install Open-with add-on.
  2. Open about:openwith, select Add...
  3. In the dialog select a video streaming capable player (e.g. /usr/bin/mpv).
  4. (Optional step) Add needed arguments to the player (e.g. you may want --force-window --ytdl for mpv)
  5. (Optional step) Choose how to display the dialogs using the left panel.
  6. Right click on links or visit pages containing videos. If the site is supported, the player will open as expected.

The same procedure can be used to associate video downloaders such as youtube-dl.

PDF viewer


PDF.js is a PDF renderer created by Mozilla and built using HTML5 technologies.

For Firefox it is available as a plugin, which is included in Firefox since version 19.

For Chromium and Google Chrome there is an experimental extension in the Chrome web store or alternatively it can be built from the source of Pdf.js.

External PDF viewers

To use an external PDF viewer you need #MozPlugger or #kpartsplugin.

If you want to use MozPlugger with Evince, for example, you have to find the lines containing pdf in the /etc/mozpluggerrc file and modify the corresponding line after GV() as below:

repeat noisy swallow(evince) fill: evince "$file"

(replace evince with something else if it is not your viewer of choice).

If this is not enough, you may need to change 2 values in about:config:

  • Change pdfjs.disabled's value to true;
  • Change plugin.disable_full_page_plugin_for_types's value to an empty value.

Restart and it should work like a charm!

Adobe Reader

Note: Adobe Reader for Linux is discontinued[3] and the outdated version that is still available cannot easily run in a 64-bit browser.

Due to licensing restrictions, Adobe Reader is only available in the AUR.

Adobe Acrobat Reader is only available as a 32-bit binary. It can be installed with the acroreadAUR package. This package installs the Acrobat Reader application as well as the NPAPI plugin.

Also, there are localizations available in many languages.


There is no 64-bit version of Adobe Reader available. To use it in a 64-bit environment, you can:

  • Follow this guide originally posted in the forums. It involves creating a chrooted environment that could be reused for other 32-bit only applications.
  • Install the acroreadAUR package (with all its 32-bit dependencies). Be advised that the Firefox plugin cannot be used directly with this binary -- it will not load in the 64-bit browser. To load it install the nspluginwrapper package from the official [multilib] repository and run:
$ nspluginwrapper -v -a -i

as a normal user. This checks the plugin directory and links the plugins as needed.


See Citrix.

Java (IcedTea)

Note: Both Java plugins are NPAPI-only and thus do not work in Chromium and Opera.

To enable Java support in your browser, you have two options: the open-source OpenJDK (recommended) or Oracle's proprietary version. For details about why OpenJDK is recommended see this.

To use OpenJDK, you have to install the IcedTea browser plugin, icedtea-web.

If you want to use Oracle's JRE, install the jreAUR package.

See Java#OpenJDK for additional details and references.

Note: If you experience any problems with the Java plugin (e.g. it is not recognized by the browser), you can try this solution.


See Pipelight.

Multimedia playback

Many browsers support the GStreamer framework to play multimedia inside HTML5 <audio> and <video> elements. Check the optional dependencies of the browser package (or webkitgtk/webkitgtk2 if using a webkit-based browser) to see which version of GStreamer is supported: this can be either gst-* for the current version, or gstreamer0.10-* for the legacy version. See GStreamer#Installation for the description of each plugin.

Other plugins

  • Gecko Media Player — Mozilla browser plugin to handle media on websites, using MPlayer. || gecko-mediaplayer || totem
  • Rosa Media Player Plugin — Qt-based browser plugin also based on MPlayer. || rosa-media-player-pluginAUR
  • VLC Plugin — NPAPI-based plugin that uses VLC technologies.;a=summary || npapi-vlc-gitAUR



Hangouts plugin can be installed with the google-talkpluginAUR package . It is a messenger by Google, that allows you to do many things. For example, it is possible to do the following: watching YouTube, making diagrams, editing documents, playing games. It is possible to make video call between 15 people simultaneously.


MozPlugger can be installed with the mozpluggerAUR package.

MozPlugger is a Mozilla plugin which can show many types of multimedia inside your browser. To accomplish this, it uses external programs such as MPlayer, xine, Evince, OpenOffice, TiMidity, etc. To modify or add applications to be used by MozPlugger just modify the /etc/mozpluggerrc file.

For example, MozPlugger uses OpenOffice by default to open doc files. To change it to use LibreOffice instead, look for the OpenOffice section:

### OpenOffice
define([OO],[swallow(VCLSalFrame) fill: ooffice2.0 -nologo -norestore -view $1 "$file"
    swallow(VCLSalFrame) fill: ooffice -nologo -norestore -view $1 "$file"
    swallow(VCLSalFrame) fill: soffice -nologo $1 "$file"])

and add LibreOffice at the beginning of the list:

### LibreOffice/OpenOffice
define([OO],[swallow(VCLSalFrame) fill: libreoffice --nologo --norestore --view $1 "$file"
    swallow(VCLSalFrame) fill: ooffice2.0 -nologo -norestore -view $1 "$file"
    swallow(VCLSalFrame) fill: ooffice -nologo -norestore -view $1 "$file"
    swallow(VCLSalFrame) fill: soffice -nologo $1 "$file"])
Note: Be sure to also choose LibreOffice as your preferred application to open doc files.

As another simple example, if you want to open cpp files with your favorite text editor (we will use Kate) to get syntax highlighting, just add a new section to your mozpluggerrc file:

text/x-c++:cpp:C++ Source File
text/x-c++:hpp:C++ Header File
    repeat noisy swallow(kate) fill: kate -b "$file"

To change the default of MPlayer so that mpv is used instead, change the appropriate lines such that:

### MPlayer

#define(MP_CMD,[mplayer -really-quiet -nojoystick -nofs -zoom -vo xv,x11 -ao esd,alsa,oss,arts,null -osdlevel 0 $1 </dev/null])
define(MP_CMD,[mpv -really-quiet $1 </dev/null])

#define(MP_EMBED,[embed noisy ignore_errors: MP_CMD(-xy $width -wid $window $1)])
define(MP_EMBED,[embed noisy ignore_errors: MP_CMD(--autofit=$width -wid $window $1)])

#define(MP_NOEMBED,[noembed noisy ignore_errors maxaspect swallow(MPlayer): MP_CMD($1)])
define(MP_NOEMBED,[noembed noisy ignore_errors maxaspect swallow(mpv): MP_CMD($1)])


#define(MP_AUDIO,[mplayer -quiet -nojoystick $1 </dev/null])
define(MP_AUDIO,[mpv -really-quiet $1 </dev/null])

#define(MP_AUDIO_STREAM,[controls stream noisy ignore_errors: mplayer -quiet -nojoystick $1 "$file" </dev/null])
define(MP_AUDIO_STREAM,[controls stream noisy ignore_errors: mpv -really-quiet $1 "$file" </dev/null])

For a more complete list of MozPlugger options see this page.


The KParts plugin is a plugin that uses KDE's KPart technology to embed different file viewers in the browser, such as Okular (for PDF), Ark (for different archives), Calligra Words (for ODF), etc. It cannot use applications that are not based on the KPart technology.

The KParts plugin can be installed with the package kpartsplugin.


Flash Player: no sound

Flash Player outputs its sound only through the default ALSA device, which is number 0. If you have multiple sound devices (a very common example is having a sound card and HDMI output in the video card), then your preferred device may have a different number.

For a list of available devices with their respective numbers, run:

$ aplay -l
 **** List of PLAYBACK Hardware Devices ****
 card 0: Generic [HD-Audio Generic], device 3: HDMI 0 [HDMI 0]
   Subdevices: 1/1
   Subdevice #0: subdevice #0
 card 1: DX [Xonar DX], device 0: Multichannel [Multichannel]
   Subdevices: 0/1
   Subdevice #0: subdevice #0
 card 1: DX [Xonar DX], device 1: Digital [Digital]
   Subdevices: 1/1
   Subdevice #0: subdevice #0

In this case, the HDMI output is card 0 and the sound card is card 1. To make your sound card the default for ALSA, create the file .asoundrc in your home directory, with the following content:

pcm.!default {
    type hw
    card 1
ctl.!default {
    type hw
    card 1

Flash Player: blocking sound for other applications or delayed playback

If sound is delayed within Flash videos or Flash stops sound from any other application, then make sure you do not have snd_pcm_oss module loaded:

$ lsmod | grep snd_pcm_oss

You can unload it:

# rmmod snd_pcm_oss

and restart the browser to see if it helps.

Flash Player: performance

Adobe's Flash plugin has some serious performance issues, especially when CPU frequency scaling is used. There seems to be a policy not to use the whole CPU workload, so the frequency scaling governor does not clock the CPU any higher. To work around this issue, see CPU frequency scaling#Switching threshold

Flash Player: low webcam resolution

If your webcam has low resolution in Flash (the image looks very pixelated) you can try starting your browser with this:

$ LD_PRELOAD=/usr/lib/libv4l/ [broswer]

Flash Player: black bars in full screen playback on multi-headed setups

The Flash plugin has a known bug where the full screen mode does not really work when you have a multi-monitor setup. Apparently, it incorrectly determines the full screen resolution, so the full screen Flash Player fills the correct monitor but gets scaled as if the monitor had the resolution of the total display area.

To fix this, you can use the "hack" described here. Simply download the source from the link given on the page, and follow the instructions in the README.

Tip: The hack is available and can be installed with the fullscreenhackAUR[broken link: archived in aur-mirror] package.
Note: While the author mentions using NVDIA's TwinView, the hack should work for any multi-monitor setup.

Flash Player: videos not working on older systems

If you have Adobe Flash installed on an older system and you start playing a video which simply turns black with nothing happening, it is most likely that your CPU does not support SSE2. You can simply check this by looking at your CPU flags with this command:

$ grep sse2 /proc/cpuinfo

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: sandfox is unmaintained and only uses rudimentary sandboxing; use a modern alternative like playpen instead. Or even better, circument the issue with external players like mpv (Discuss in Talk:Browser plugins#)

If no results are returned, then you need to install an older version of Flash (for example 10.3, or 11.1). Older versions possibly will have vulnerabilities. You should then consider sandboxing Firefox using the sandfoxAUR package See the sandfox homepage for usage information.

Older versions of Flash are available here: You need to copy to the folder /usr/lib/mozilla/plugins/

The most recent package without SSE2 is flashplugin- If you use the packaged version, you have to add IgnorePkg = flashplugin to /etc/pacman.conf.

Flash Player: plugin version still shown older version after upgrade


Solution for Firefox: delete file "pluginreg.dat" in user's profile directory.

  • Close firefox
  • Go to /home/<username>/.mozilla/firefox/<profile_folder>/
  • Delete file "pluginreg.dat"

Firefox will automatically rebuild this file once it is started again. Make sure to substitute <username> and <profile_folder> with the appropriate information.

Plugins are installed but not working

A common problem is that the plugin path is unset. This typically occurs on a new install, when the user has not re-logged in before running Firefox after the installation. Test if the path is unset:


If unset, then either re-login, or source /etc/profile.d/ and start Firefox from the same shell:

source /etc/profile.d/ && firefox

Gecko Media Player will not play Apple trailers

If Apple Trailers appear to start to play and then fail, try setting the user agent for your browser to:

QuickTime/7.6.2 (qtver=7.6.2;os=Windows NT 5.1Service Pack 3)

See also