ARAS configuration file

The ARAS configuration file contains comments and some commands, one of them in each line:

# The ARAS configuration file
Lines with a # character at the beginning are comments.

ScheduleFile my_schedule_file
Defines the current schedule file.

BlockFile my_block_file
Defines the current block description file.

TimeSignal time_signal_support
Defines the time signal support behaviour.

time_signal_support parameter can take some values:

Off in order to disable time signal support
Hour in order to define hourly time signal support
Half in order to define hourly and half past time signal support

TimeSignalFile my_time_signal_file
Defines the time signal audio URI, for example:

TimeSignalFile file:///home/radio/ARAS-1.0/media/time_signal.wav

IntervalSignal interval_signal_support
Defines the interval signal support behaviour.

interval_signal_support parameter can take some values:

Off in order to disable interval signal support
On in order to enable the interval signal support
If interval_signal_support is On, the interval signal is played when a file block finishes before the beginning of the next block.

IntervalSignalBlock my_interval_signal_block
Defines the interval signal block, for example:

IntervalSignalBlock IntervalSignalBlock

BlockPlayerVolume volume
Defines the block player volume from 0 to 10, for example:

BlockPlayerVolume 5E-1

TimeSignalPlayerVolume volume
Defines the time signal player volume from 0 to 10, for example:

TimeSignalPlayerVolume 5E-1

FadeOutSlope value
Defines the fade out slope, for example:

FadeOutSlope 1E-1

FadeOutResolution value
Defines the fade out time resolution in miliseconds, for example:

FadeOutResolution 100

FadeOutThresold value
Defines the fade out volume thresold , for example:

FadeOutThresold 1E-2

DefaultTimeout value
Defines ARAS default period in miliseconds, for example:

DefaultTimeout 100

ConfigurationTimeout value
Defines the ARAS configuration file loading period in miliseconds, for example:

ConfigurationTimeout 10000

ScheduleTimeout value
Defines the ARAS schedule file loading period in miliseconds, for example:

ScheduleTimeout 10000

BlockTimeout value
Defines the ARAS block description file loading period in miliseconds, for example:

BlockTimeout 10000

ARAS schedule file

The ARAS schedule file contains the schedule description. Each line contains a comment or defines a schedule element:

Lines with a # character at the beginning are comments, for example:

# ARAS schedule file

A schedule element is defined in a line as follows:

Day    Time    Block

Where:

Day can be: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday or Saturday.

Time is the time of the beginning of the schedule element in the format HH:MM:SS.

Block is the block associated with the schedule element.

An example of a schedule element definition is:

Monday    22:00:00    my_block

The ARAS block description file contains the blocks descriptions. Each line contains a comment or defines a block:

Lines with a # character at the beginning are comments, for example:

# ARAS block description file

A block is described in a line as follows:

Name    Type    Data

Where:

Name is the name of the block.

Type is the block type, it can be: File or Random.
If the block type is File, ARAS will play the file whose URI is defined in Data.
If the block type is Random, ARAS will play a random file from the directory defined in Data.

Data is the block data. It can contain a file URI or a directory path depending of the type of block.

An example of a block definition is:

my_block    File    file:///home/radio/archive/my_program.ogg

or

my_block    Random  /home/radio/archive/