# WinLIRC

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/winlirc/

Using infrared signals allows an inexpensive and easy integration of existing audio and video equipment into home automation. Moreover, e.g. light scenarios using the infrared remote control can be activated or blinds can be lowered. For this, in principle, only one transmitter and receiver diode is necessary - as you want as a finished device or for crafting ...

Find out more about WinLIRC:
[https://winlirc.sourceforge.net](https://winlirc.sourceforge.net)

For those who like to pick up once again the soldering iron, find more information here:
[https://www.lirc.org/receivers.html](https://www.lirc.org/receivers.html)
[https://www.lirc.org/transmitters.html](https://www.lirc.org/transmitters.html)

### Installation

To receive/send IR signals via IP Symcon, you need a LIRC compatible device.

 * WinLIRC Applikation must be installed and running
 * Download: [winlirc.sourceforge.net/de/](https://winlirc.sourceforge.net/de/)
 * Remote control/buttons must be trained in the WinLIRC application
 * Create WinLIRC module in IP-Symcon.
  * Host: localhost
  * Port: 8765

### Use in IP Symcon

The WinLIRC module providess itself in the object tree as follows:

![WinLIRC: Tree](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/winlirc/afa166fc4c-1790424938/winlirc-tree.png)

A successful installation can be seen at the open socket.

![WinLIRC: Socket](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/winlirc/eb60a07d2a-1790424938/winlirc-socket.png)

To output IR commands from IP-Symcon, the WinLIRC_SendOnce function is used.

```php
$id = 18076 /*[Media IR\WinLIRC]*/;
// Turn on ZDF
WinLIRC_SendOnce($id, "humax", "power");
IPS_Sleep(1000);
WinLIRC_SendOnce($id, "humax", "power");
IPS_Sleep(200);
WinLIRC_SendOnce($id, "sat", "power");
// here is still place for lighting commands...
```

## WinLIRC_SendOnce

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/winlirc/winlirc-sendonce/

`bool WinLIRC_SendOnce(int $InstanceID, string $RemoteControl, string $Button)`

**Parameters**

- `$InstanceID` (int): ID of the device to be switched
- `$RemoteControl` (string): Name of the remote control, which is/ was registered in the remote database.
- `$Button` (string): Name of the remote control function, which is/ was registered in the remote database.

**Returns** (bool): If the command succeeds, it returns __TRUE__, otherwise __FALSE__.

Name of the remote control function, which is/ was registered in the remote database.

**Example**

```php
WinLIRC_SendOnce(37279,"soundmaster", "power");
```