This page contains information about how to install Pipelight either via a precompiled package on supported distributions or how to compile it yourself. To use Pipelight you first need to install the package itself and then enable the plugins you want to use. For some websites you will also need to install a user agent switcher in your browser. Note: Pipelight does not work in Chrome / Chromium version 35 or higher, take a look at our Chromium page for more information.

1. Package Installation

The first step is to install the Pipelight package and dependencies on your system. Click on one of the supported systems to see the distribution specific steps. Please note that (unless explicitly stated otherwise) these packages are provided by the Pipelight team, and not the distributions themselves.

If there are no ready-to-use packages for your distribution, you can still compile Pipelight on your own.

2. Using windows browser plugins

After installing Pipelight, you will need to enable the plugins you want to use. By default all plugins are disabled and you need to enable them through the pipelight-plugin script. Enabling a plugin is as easy as executing the following command in your terminal:

sudo pipelight-plugin --enable pluginname

To disable the plugin again use:

sudo pipelight-plugin --disable pluginname

If you do not want to enable a plugin for all users on your system, but only your current user, simply leave out the sudo. The pipelight-plugin script supports a lot more commands, which you can check out in our man page.

Not all plugins work completely out of the box and may require some additional configuration or steps. Therefore make sure to checkout the plugin related information:

There are also some other smaller plugins, which do not have a dedicated page. You can get a list of all supported plugins by executing:

pipelight-plugin --help

Some of these plugins need to be "unlocked" first (this will create some extra file consuming some disk space). If you try to enable such a plugin, you will get an error tell you to execute

sudo pipelight-plugin --unlock pluginname

first. If you do not longer need a specific plugin you can use --lock instead to remove the file again.

The following additional plugins (i.e. they were not mentioned yet) are supported as of version 0.2.7 and must be unlocked:

Plugin

Command

Description

Adobe® Reader®

adobereader

Popular PDF viewer on Windows

Foxit® PDF Reader

foxitpdf

Another PDF viewer

Grandstream® Plugin

grandstream

Plugin to connect to IP cameras

Hikvision® Plugin

hikvision

Another plugin to connect to IP cameras

Roblox® Plugin

roblox

A web plugin to launch games created with Roblox

Vizzed Retro Game Room

vizzedrgr

A game console emulator for old games

Viewright® Caiway®

viewright-caiway

The ViewRight player in the Caiway edition (VOD service in NL)

Triangleplayer

triangleplayer

Required to play the game "The Lost Titans"

Unity® Web Player (64-bit)

x64-unity3d

64-bit version of the Unity Webplayer

Adobe® Flash® (64-bit)

x64-flash

64-bit version of Flash

3. Further steps and information

Some websites will show you an error that your operating system is not supported. To get around this problem, you will need to install an user agent switcher as described here.

In case something does not work as expected take a look at our help section which already contains solutions for the most common problems. In case none of the provided tips solves your problem, you will also find information about submitting questions or a bug report on this page.