# Blinker - Loveletter

The loveletter module plays Blinken movies on demand. An operator connection is used to submit a movie number (prefixed with a star and followed by ahash, e.g. `*123#`). The movie with this number will then be played until another number is requested or the connection is closed (either by the remote side or using `*#`).

## Configuration

The configuration of the loveletter module with name `NAME` is located in the `loveletters/NAME` subdirectory.

### Sound File

While an operator is connected to the loveletter module (e.g. via a phone connection), a sound file can be requested to be played. (In case of the phone connection, this file is located on the phone server.) The name of the sound to request is contained in the file `sound`. If this file does not exists, no sound is requested to be played.

### Movies

The movies available for on-demand play are located in the subdirectory `movies`. The movie number is derived from the filename by leaving out all non-digit characters. Please make sure that there are not two different movies with the same derived number (e.g. `123.bml` and `123.bbm`.

### Output Stream

The file `outstream` contains the name of the stream to send the frames to.

### Halt Stream

The playing movie can be halted whenever another stream is active. Therefore, the name of the other stream is written to the file `haltstream`. When the halt stream becoms active, the current frame is frozen, i.e. the frame is kept. When the halt stream ends, the movie resumes with the remaining time for the current frame and continues as usual afterwards.
If this feature is not needed, the file `haltstream` should not exist.

## Operator Connection Interface

The name of the operator connection interface provided by this module is the module name, i.e., `loveletters/NAME`.