User Tools

Site Tools


This is an old revision of the document!



Linux, FreeBSD and OSX

Before you install pilight, make sure you have gcc installed. On some distributions you can also install all compilation tools at once by installing build-essential. The installation of these programs differ from distribution to distribution. Please refer to their instructions on how to do this.


The prerequisites for compiling for Windows are includes in the git package.

Connecting the Hardware

In order to fully use pilight you need to have one of the supported hardware senders and receiver connected. Currently pilight can run in two hardware modes. Please refer to the settings.json description on how to use one of these modes.


In this mode, pilight will use a lirc kernel module to send a receive codes. This hardware mode is advised when you are not using a low-pass filter.

  • First connect the receiver to BCM pin 18 (wiringPi 1) and the sender to BCM pin 17.
  • Then load the lirc_rpi kernel module.
modprobe lirc_rpi gpio_in_pin=18 gpio_out_pin=17


In this mode, pilight will directly use the gpio pins. This hardware mode is advised when you are using a low-pass filter.

  • Just connect the receiver to BCM pin 18 (wiringPi 1) and the sender to BCM pin 17.

Compilation and Installation

Please follow these steps carefully to install pilight:

cd ~
git clone --depth 5
cd pilight
make install

pilight is now installed and can be used by running pilight-daemon. This will run pilight with a default configuration. This allows basic sending en receiving.


To change any of the default settings of pilight alterations can be made in the settings.json file. To predefine specific locations and their respective devices a config.json file can be created. Please refer to both wiki pages for further explanations.

installation.1379507397.txt.gz · Last modified: 2015/11/27 21:08 (external edit)