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 *#
).
The configuration of the loveletter module with name NAME
is located in the loveletters/NAME
subdirectory.
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.
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
.
The file outstream
contains the name of the stream to
send the frames to.
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.
The name of the operator connection interface provided by this module
is the module name, i.e., loveletters/NAME
.