lirc-client/docs/api.md

Connect to LIRC Daemon (Infrared)

<a name="Lirc"></a>

## Lirc
**Kind**: global class  

* [Lirc](#Lirc)
    * [new module.exports.Lirc([config])](#new_Lirc_new)
    * [.send()](#Lirc+send) ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
    * [.sendOnce(remote, button, [repeat])](#Lirc+sendOnce) ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
    * [.sendStart(remote, button)](#Lirc+sendStart) ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
    * [.sendStop(remote, button)](#Lirc+sendStop) ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
    * [.list([remote])](#Lirc+list) ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
    * [.version()](#Lirc+version) ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
    * [.connect()](#Lirc+connect) ⇒ <code>Promise</code>
    * [.disconnect()](#Lirc+disconnect) ⇒ <code>Promise</code>

<a name="new_Lirc_new"></a>

### new module.exports.Lirc([config])

| Param | Type | Default | Description |
| --- | --- | --- | --- |
| [config] | <code>object</code> |  | Configuration object. |
| [config.autoconnect] | <code>boolean</code> | <code>true</code> | Automatically connect. |
| [config.host] | <code>string</code> | <code>&quot;&#x27;127.0.0.1&#x27;&quot;</code> | Host running LIRC. |
| [config.port] | <code>number</code> | <code>8765</code> | Port of running LIRC daemon. |
| [config.path] | <code>string</code> |  | Path to LIRC socket. |
| [config.reconnect] | <code>boolean</code> | <code>true</code> | Automatically reconnect. |
| [config.reconnect_delay] | <code>number</code> | <code>5000</code> | Delay when reconnecting. |

<a name="Lirc+send"></a>

### lirc.send() ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
Send a command.

**Kind**: instance method of [<code>Lirc</code>](#Lirc)  
**Returns**: <code>Promise.&lt;array.&lt;string&gt;&gt;</code> - Resulting response from LIRC daemon.  

| Param | Type | Description |
| --- | --- | --- |
| ...args | <code>string</code> | Command to send, or individual parameters. |

<a name="Lirc+sendOnce"></a>

### lirc.sendOnce(remote, button, [repeat]) ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
Tell LIRC to emit a button press.

**Kind**: instance method of [<code>Lirc</code>](#Lirc)  
**Returns**: <code>Promise.&lt;array.&lt;string&gt;&gt;</code> - Response from LIRC.  

| Param | Type | Description |
| --- | --- | --- |
| remote | <code>string</code> | Remote name. |
| button | <code>string</code> | Button name. |
| [repeat] | <code>number</code> | Number of times to repeat. |

<a name="Lirc+sendStart"></a>

### lirc.sendStart(remote, button) ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
Tell LIRC to start emitting button presses.

**Kind**: instance method of [<code>Lirc</code>](#Lirc)  
**Returns**: <code>Promise.&lt;array.&lt;string&gt;&gt;</code> - Response from LIRC.  

| Param | Type | Description |
| --- | --- | --- |
| remote | <code>string</code> | Remote name. |
| button | <code>string</code> | Button name. |

<a name="Lirc+sendStop"></a>

### lirc.sendStop(remote, button) ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
Tell LIRC to stop emitting a button press.

**Kind**: instance method of [<code>Lirc</code>](#Lirc)  
**Returns**: <code>Promise.&lt;array.&lt;string&gt;&gt;</code> - Response from LIRC.  

| Param | Type | Description |
| --- | --- | --- |
| remote | <code>string</code> | Remote name. |
| button | <code>string</code> | Button name. |

<a name="Lirc+list"></a>

### lirc.list([remote]) ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
If a remote is supplied, list available buttons for remote, otherwise
return list of remotes.

**Kind**: instance method of [<code>Lirc</code>](#Lirc)  
**Returns**: <code>Promise.&lt;array.&lt;string&gt;&gt;</code> - Response from LIRC.  

| Param | Type | Description |
| --- | --- | --- |
| [remote] | <code>string</code> | Remote name. |

<a name="Lirc+version"></a>

### lirc.version() ⇒ <code>Promise.&lt;array.&lt;string&gt;&gt;</code>
Get LIRC version from server.

**Kind**: instance method of [<code>Lirc</code>](#Lirc)  
**Returns**: <code>Promise.&lt;array.&lt;string&gt;&gt;</code> - Response from LIRC.  
<a name="Lirc+connect"></a>

### lirc.connect() ⇒ <code>Promise</code>
Connect to a running LIRC daemon.

**Kind**: instance method of [<code>Lirc</code>](#Lirc)  
**Returns**: <code>Promise</code> - Resolves upon connection to server.  
<a name="Lirc+disconnect"></a>

### lirc.disconnect() ⇒ <code>Promise</code>
Disconnect from LIRC daemon and clean up socket.

**Kind**: instance method of [<code>Lirc</code>](#Lirc)  
**Returns**: <code>Promise</code> - Resolves upon disconnect.