.dockerignore

+.travis.yaml
+.swagger-codegen-ignore
+README.md
+tox.ini
+git_push.sh
+test-requirements.txt
+setup.py
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.hypothesis/
+venv/
+.python-version
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+#Ipython Notebook
+.ipynb_checkpoints
+
+# VirtualEnv
+python
+
+#Testing
+.noseids
+
+# Configurations
+config/engine.ini
+config/docker/engine.ini
+env.list
+
+# Socket
+modules/liquidsoap/engine.sock
\ No newline at end of file

.gitignore

+.idea/
+*.pyc
+*.log
+logs
+tmp
+.vscode/tags
+configuration/engine.ini
+script/.engine.install-db.lock
+.engine.install-db.lock
+configuration/systemd/dev/
+env.list
+audio/source
+configuration/docker/engine.ini
+modules/liquidsoap/engine.sock
\ No newline at end of file

.gitlab-ci.yml

+image: python:3.7
+
+stages:
+  - test
+
+before_script:
+  - apt-get -qq update 
+  - apt-cache search libmariadb
+  - apt-get install -y python3-virtualenv virtualenv opam redis-server redis-tools libev4 libev-dev libsndfile1 quelcom # mariadb-server libmariadbclient-dev
+  - /usr/bin/virtualenv venv
+  - . venv/bin/activate
+  # - opam init --disable-sandboxing -y
+  # - opam switch create 4.08.0
+  # - opam update -y
+  # - opam install depext -y
+  # - opam depext taglib mad lame vorbis flac opus cry samplerate pulseaudio bjack alsa ssl liquidsoap -y
+  # - opam install taglib mad lame vorbis flac opus cry samplerate pulseaudio bjack alsa ssl liquidsoap -y
+  # - eval $(opam env)
+  - python3 -V
+  - pip3 install -r requirements.txt
+  - mkdir /etc/aura
+  - mkdir /var/log/aura
+  - pwd
+  - cp configuration/sample-production.engine.ini configuration/engine.ini
+
+simple_guru_help:
+  stage: test
+  script:
+    - python3 guru.py -h
+
+#print_connection_status:
+#  stage: test
+#  script:
+#    - python3 guru.py -pcs
\ No newline at end of file

.gitmodules

+[submodule "contrib/engine-clock"]
+	path = contrib/engine-clock
+	url = git@gitlab.servus.at:aura/engine-clock.git
+[submodule "contrib/engine-api"]
+	path = contrib/engine-api
+	url = git@gitlab.servus.at:aura/engine-api.git

.pylintrc

+[MASTER]
+
+# A comma-separated list of package or module names from where C extensions may
+# be loaded. Extensions are loading into the active Python interpreter and may
+# run arbitrary code.
+extension-pkg-whitelist=
+
+# Add files or directories to the blacklist. They should be base names, not
+# paths.
+ignore=CVS
+
+# Add files or directories matching the regex patterns to the blacklist. The
+# regex matches against base names, not paths.
+ignore-patterns=
+
+# Python code to execute, usually for sys.path manipulation such as
+# pygtk.require().
+#init-hook=
+
+# Use multiple processes to speed up Pylint. Specifying 0 will auto-detect the
+# number of processors available to use.
+jobs=1
+
+# Control the amount of potential inferred values when inferring a single
+# object. This can help the performance when dealing with large functions or
+# complex, nested conditions.
+limit-inference-results=100
+
+# List of plugins (as comma separated values of python modules names) to load,
+# usually to register additional checkers.
+load-plugins=
+
+# Pickle collected data for later comparisons.
+persistent=yes
+
+# Specify a configuration file.
+#rcfile=
+
+# When enabled, pylint would attempt to guess common misconfiguration and emit
+# user-friendly hints instead of false-positive error messages.
+suggestion-mode=yes
+
+# Allow loading of arbitrary C extensions. Extensions are imported into the
+# active Python interpreter and may run arbitrary code.
+unsafe-load-any-extension=no
+
+
+[MESSAGES CONTROL]
+
+# Only show warnings with the listed confidence levels. Leave empty to show
+# all. Valid levels: HIGH, INFERENCE, INFERENCE_FAILURE, UNDEFINED.
+confidence=
+
+# Disable the message, report, category or checker with the given id(s). You
+# can either give multiple identifiers separated by comma (,) or put this
+# option multiple times (only on the command line, not in the configuration
+# file where it should appear only once). You can also use "--disable=all" to
+# disable everything first and then reenable specific checks. For example, if
+# you want to run only the similarities checker, you can use "--disable=all
+# --enable=similarities". If you want to run only the classes checker, but have
+# no Warning level messages displayed, use "--disable=all --enable=classes
+# --disable=W".
+disable=bare-except,
+        broad-except,
+        logging-not-lazy,
+        line-too-long,
+        trailing-whitespace,
+        missing-module-docstring,
+        print-statement,
+        parameter-unpacking,
+        unpacking-in-except,
+        old-raise-syntax,
+        backtick,
+        long-suffix,
+        old-ne-operator,
+        old-octal-literal,
+        import-star-module-level,
+        non-ascii-bytes-literal,
+        raw-checker-failed,
+        bad-inline-option,
+        locally-disabled,
+        file-ignored,
+        suppressed-message,
+        useless-suppression,
+        deprecated-pragma,
+        use-symbolic-message-instead,
+        apply-builtin,
+        basestring-builtin,
+        buffer-builtin,
+        cmp-builtin,
+        coerce-builtin,
+        execfile-builtin,
+        file-builtin,
+        long-builtin,
+        raw_input-builtin,
+        reduce-builtin,
+        standarderror-builtin,
+        unicode-builtin,
+        xrange-builtin,
+        coerce-method,
+        delslice-method,
+        getslice-method,
+        setslice-method,
+        no-absolute-import,
+        old-division,
+        dict-iter-method,
+        dict-view-method,
+        next-method-called,
+        metaclass-assignment,
+        indexing-exception,
+        raising-string,
+        reload-builtin,
+        oct-method,
+        hex-method,
+        nonzero-method,
+        cmp-method,
+        input-builtin,
+        round-builtin,
+        intern-builtin,
+        unichr-builtin,
+        map-builtin-not-iterating,
+        zip-builtin-not-iterating,
+        range-builtin-not-iterating,
+        filter-builtin-not-iterating,
+        using-cmp-argument,
+        eq-without-hash,
+        div-method,
+        idiv-method,
+        rdiv-method,
+        exception-message-attribute,
+        invalid-str-codec,
+        sys-max-int,
+        bad-python3-import,
+        deprecated-string-function,
+        deprecated-str-translate-call,
+        deprecated-itertools-function,
+        deprecated-types-field,
+        next-method-defined,
+        dict-items-not-iterating,
+        dict-keys-not-iterating,
+        dict-values-not-iterating,
+        deprecated-operator-function,
+        deprecated-urllib-function,
+        xreadlines-attribute,
+        deprecated-sys-function,
+        exception-escape,
+        comprehension-escape
+
+# Enable the message, report, category or checker with the given id(s). You can
+# either give multiple identifier separated by comma (,) or put this option
+# multiple time (only on the command line, not in the configuration file where
+# it should appear only once). See also the "--disable" option for examples.
+enable=c-extension-no-member
+
+
+[REPORTS]
+
+# Python expression which should return a note less than 10 (10 is the highest
+# note). You have access to the variables errors warning, statement which
+# respectively contain the number of errors / warnings messages and the total
+# number of statements analyzed. This is used by the global evaluation report
+# (RP0004).
+evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)
+
+# Template used to display messages. This is a python new-style format string
+# used to format the message information. See doc for all details.
+#msg-template=
+
+# Set the output format. Available formats are text, parseable, colorized, json
+# and msvs (visual studio). You can also give a reporter class, e.g.
+# mypackage.mymodule.MyReporterClass.
+output-format=text
+
+# Tells whether to display a full report or only the messages.
+reports=no
+
+# Activate the evaluation score.
+score=yes
+
+
+[REFACTORING]
+
+# Maximum number of nested blocks for function / method body
+max-nested-blocks=5
+
+# Complete name of functions that never returns. When checking for
+# inconsistent-return-statements if a never returning function is called then
+# it will be considered as an explicit return statement and no message will be
+# printed.
+never-returning-functions=sys.exit
+
+
+[VARIABLES]
+
+# List of additional names supposed to be defined in builtins. Remember that
+# you should avoid defining new builtins when possible.
+additional-builtins=
+
+# Tells whether unused global variables should be treated as a violation.
+allow-global-unused-variables=yes
+
+# List of strings which can identify a callback function by name. A callback
+# name must start or end with one of those strings.
+callbacks=cb_,
+          _cb
+
+# A regular expression matching the name of dummy variables (i.e. expected to
+# not be used).
+dummy-variables-rgx=_+$|(_[a-zA-Z0-9_]*[a-zA-Z0-9]+?$)|dummy|^ignored_|^unused_
+
+# Argument names that match this expression will be ignored. Default to name
+# with leading underscore.
+ignored-argument-names=_.*|^ignored_|^unused_
+
+# Tells whether we should check for unused import in __init__ files.
+init-import=no
+
+# List of qualified module names which can have objects that can redefine
+# builtins.
+redefining-builtins-modules=six.moves,past.builtins,future.builtins,builtins,io
+
+
+[BASIC]
+
+# Naming style matching correct argument names.
+argument-naming-style=snake_case
+
+# Regular expression matching correct argument names. Overrides argument-
+# naming-style.
+#argument-rgx=
+
+# Naming style matching correct attribute names.
+attr-naming-style=snake_case
+
+# Regular expression matching correct attribute names. Overrides attr-naming-
+# style.
+#attr-rgx=
+
+# Bad variable names which should always be refused, separated by a comma.
+bad-names=foo,
+          bar,
+          baz,
+          toto,
+          tutu,
+          tata
+
+# Naming style matching correct class attribute names.
+class-attribute-naming-style=any
+
+# Regular expression matching correct class attribute names. Overrides class-
+# attribute-naming-style.
+#class-attribute-rgx=
+
+# Naming style matching correct class names.
+class-naming-style=PascalCase
+
+# Regular expression matching correct class names. Overrides class-naming-
+# style.
+#class-rgx=
+
+# Naming style matching correct constant names.
+const-naming-style=UPPER_CASE
+
+# Regular expression matching correct constant names. Overrides const-naming-
+# style.
+#const-rgx=
+
+# Minimum line length for functions/classes that require docstrings, shorter
+# ones are exempt.
+docstring-min-length=-1
+
+# Naming style matching correct function names.
+function-naming-style=snake_case
+
+# Regular expression matching correct function names. Overrides function-
+# naming-style.
+#function-rgx=
+
+# Good variable names which should always be accepted, separated by a comma.
+good-names=i,
+           j,
+           k,
+           ex,
+           Run,
+           _
+
+# Include a hint for the correct naming format with invalid-name.
+include-naming-hint=no
+
+# Naming style matching correct inline iteration names.
+inlinevar-naming-style=any
+
+# Regular expression matching correct inline iteration names. Overrides
+# inlinevar-naming-style.
+#inlinevar-rgx=
+
+# Naming style matching correct method names.
+method-naming-style=snake_case
+
+# Regular expression matching correct method names. Overrides method-naming-
+# style.
+#method-rgx=
+
+# Naming style matching correct module names.
+module-naming-style=snake_case
+
+# Regular expression matching correct module names. Overrides module-naming-
+# style.
+#module-rgx=
+
+# Colon-delimited sets of names that determine each other's naming style when
+# the name regexes allow several styles.
+name-group=
+
+# Regular expression which should only match function or class names that do
+# not require a docstring.
+no-docstring-rgx=^_
+
+# List of decorators that produce properties, such as abc.abstractproperty. Add
+# to this list to register other decorators that produce valid properties.
+# These decorators are taken in consideration only for invalid-name.
+property-classes=abc.abstractproperty
+
+# Naming style matching correct variable names.
+variable-naming-style=snake_case
+
+# Regular expression matching correct variable names. Overrides variable-
+# naming-style.
+#variable-rgx=
+
+
+[SPELLING]
+
+# Limits count of emitted suggestions for spelling mistakes.
+max-spelling-suggestions=4
+
+# Spelling dictionary name. Available dictionaries: none. To make it working
+# install python-enchant package..
+spelling-dict=
+
+# List of comma separated words that should not be checked.
+spelling-ignore-words=
+
+# A path to a file that contains private dictionary; one word per line.
+spelling-private-dict-file=
+
+# Tells whether to store unknown words to indicated private dictionary in
+# --spelling-private-dict-file option instead of raising a message.
+spelling-store-unknown-words=no
+
+
+[TYPECHECK]
+
+# List of decorators that produce context managers, such as
+# contextlib.contextmanager. Add to this list to register other decorators that
+# produce valid context managers.
+contextmanager-decorators=contextlib.contextmanager
+
+# List of members which are set dynamically and missed by pylint inference
+# system, and so shouldn't trigger E1101 when accessed. Python regular
+# expressions are accepted.
+generated-members=
+
+# Tells whether missing members accessed in mixin class should be ignored. A
+# mixin class is detected if its name ends with "mixin" (case insensitive).
+ignore-mixin-members=yes
+
+# Tells whether to warn about missing members when the owner of the attribute
+# is inferred to be None.
+ignore-none=yes
+
+# This flag controls whether pylint should warn about no-member and similar
+# checks whenever an opaque object is returned when inferring. The inference
+# can return multiple potential results while evaluating a Python object, but
+# some branches might not be evaluated, which results in partial inference. In
+# that case, it might be useful to still emit no-member and other checks for
+# the rest of the inferred objects.
+ignore-on-opaque-inference=yes
+
+# List of class names for which member attributes should not be checked (useful
+# for classes with dynamically set attributes). This supports the use of
+# qualified names.
+ignored-classes=optparse.Values,thread._local,_thread._local
+
+# List of module names for which member attributes should not be checked
+# (useful for modules/projects where namespaces are manipulated during runtime
+# and thus existing member attributes cannot be deduced by static analysis. It
+# supports qualified module names, as well as Unix pattern matching.
+ignored-modules=
+
+# Show a hint with possible names when a member name was not found. The aspect
+# of finding the hint is based on edit distance.
+missing-member-hint=yes
+
+# The minimum edit distance a name should have in order to be considered a
+# similar match for a missing member name.
+missing-member-hint-distance=1
+
+# The total number of similar names that should be taken in consideration when
+# showing a hint for a missing member.
+missing-member-max-choices=1
+
+
+[FORMAT]
+
+# Expected format of line ending, e.g. empty (any line ending), LF or CRLF.
+expected-line-ending-format=
+
+# Regexp for a line that is allowed to be longer than the limit.
+ignore-long-lines=^\s*(# )?<?https?://\S+>?$
+
+# Number of spaces of indent required inside a hanging or continued line.
+indent-after-paren=4
+
+# String used as indentation unit. This is usually "    " (4 spaces) or "\t" (1
+# tab).
+indent-string='    '
+
+# Maximum number of characters on a single line.
+max-line-length=100
+
+# Maximum number of lines in a module.
+max-module-lines=1000
+
+# List of optional constructs for which whitespace checking is disabled. `dict-
+# separator` is used to allow tabulation in dicts, etc.: {1  : 1,\n222: 2}.
+# `trailing-comma` allows a space between comma and closing bracket: (a, ).
+# `empty-line` allows space-only lines.
+no-space-check=trailing-comma,
+               dict-separator
+
+# Allow the body of a class to be on the same line as the declaration if body
+# contains single statement.
+single-line-class-stmt=no
+
+# Allow the body of an if to be on the same line as the test if there is no
+# else.
+single-line-if-stmt=no
+
+
+[LOGGING]
+
+# Format style used to check logging format string. `old` means using %
+# formatting, while `new` is for `{}` formatting.
+logging-format-style=old
+
+# Logging modules to check that the string format arguments are in logging
+# function parameter format.
+logging-modules=logging
+
+
+[MISCELLANEOUS]
+
+# List of note tags to take in consideration, separated by a comma.
+notes=FIXME,
+      XXX,
+      TODO
+
+
+[SIMILARITIES]
+
+# Ignore comments when computing similarities.
+ignore-comments=yes
+
+# Ignore docstrings when computing similarities.
+ignore-docstrings=yes
+
+# Ignore imports when computing similarities.
+ignore-imports=no
+
+# Minimum lines number of a similarity.
+min-similarity-lines=4
+
+
+[IMPORTS]
+
+# Allow wildcard imports from modules that define __all__.
+allow-wildcard-with-all=no
+
+# Analyse import fallback blocks. This can be used to support both Python 2 and
+# 3 compatible code, which means that the block might have code that exists
+# only in one or another interpreter, leading to false positives when analysed.
+analyse-fallback-blocks=no
+
+# Deprecated modules which should not be used, separated by a comma.
+deprecated-modules=optparse,tkinter.tix
+
+# Create a graph of external dependencies in the given file (report RP0402 must
+# not be disabled).
+ext-import-graph=
+
+# Create a graph of every (i.e. internal and external) dependencies in the
+# given file (report RP0402 must not be disabled).
+import-graph=
+
+# Create a graph of internal dependencies in the given file (report RP0402 must
+# not be disabled).
+int-import-graph=
+
+# Force import order to recognize a module as part of the standard
+# compatibility libraries.
+known-standard-library=
+
+# Force import order to recognize a module as part of a third party library.
+known-third-party=enchant
+
+
+[DESIGN]
+
+# Maximum number of arguments for function / method.
+max-args=5
+
+# Maximum number of attributes for a class (see R0902).
+max-attributes=7
+
+# Maximum number of boolean expressions in an if statement.
+max-bool-expr=5
+
+# Maximum number of branch for function / method body.
+max-branches=12
+
+# Maximum number of locals for function / method body.
+max-locals=15
+
+# Maximum number of parents for a class (see R0901).
+max-parents=7
+
+# Maximum number of public methods for a class (see R0904).
+max-public-methods=20
+
+# Maximum number of return / yield for function / method body.
+max-returns=6
+
+# Maximum number of statements in function / method body.
+max-statements=50
+
+# Minimum number of public methods for a class (see R0903).
+min-public-methods=2
+
+
+[CLASSES]
+
+# List of method names used to declare (i.e. assign) instance attributes.
+defining-attr-methods=__init__,
+                      __new__,
+                      setUp
+
+# List of member names, which should be excluded from the protected access
+# warning.
+exclude-protected=_asdict,
+                  _fields,
+                  _replace,
+                  _source,
+                  _make
+
+# List of valid names for the first argument in a class method.
+valid-classmethod-first-arg=cls
+
+# List of valid names for the first argument in a metaclass class method.
+valid-metaclass-classmethod-first-arg=cls
+
+
+[EXCEPTIONS]
+
+# Exceptions that will emit a warning when being caught. Defaults to
+# "Exception".
+overgeneral-exceptions=Exception
\ No newline at end of file

.vscode/launch.json

+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Start Aura Engine",
+            "type": "python",
+            "request": "launch",
+            "program": "${workspaceFolder}/engine-core.py",
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "Start Engine Core Only",
+            "type": "python",
+            "request": "launch",
+            "program": "${workspaceFolder}/engine-core.py",
+            "args": [
+                "--without-lqs"
+            ],
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "Start Engine LQS Only",
+            "type": "python",
+            "request": "launch",
+            "program": "${workspaceFolder}/engine-core.py",
+            "args": [
+                "--lqs-only"
+            ],
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "Start Engine API",
+            "type": "python",
+            "request": "launch",
+            "stopOnEntry": false,
+            "program": "${workspaceFolder}/engine-api.py",
+            "env": {
+                "FLASK_APP": "${workspaceRoot}/engine-api.py",
+                "FLASK_ENV": "development"
+            },
+            "args": [
+                "run"
+            ]
+        },
+        {
+            "name": "Aura Engine - Recreate Database",
+            "type": "python",
+            "request": "launch",
+            "program": "${workspaceFolder}/engine-core.py",
+            "args": ["--recreate-database"],
+            "console": "integratedTerminal"
+        }
+    ]
+}
\ No newline at end of file

.vscode/settings.json

+{
+}
\ No newline at end of file

Dockerfile

+
+FROM savonet/liquidsoap:v1.4.3
+
+LABEL maintainer="David Trattnig <david.trattnig@subsquare.at>"
+
+# Engine System Dependencies
+
+RUN apt-get update && apt-get -y install \
+      apt-utils \
+      redis-server \
+      ffmpeg \
+      quelcom \    
+      build-essential \
+      libmariadbclient-dev \
+      default-libmysqlclient-dev \
+      python3.8 python3-pip
+
+# Print Debug Information
+
+RUN echo $(python3.8 -V)
+
+# Setup Engine
+
+RUN whoami
+RUN mkdir -p /srv
+RUN mkdir -p /var/audio
+RUN mkdir -p /var/audio/source
+COPY . /srv
+WORKDIR /srv
+RUN python3.8 $(which pip3) install -r requirements.txt
+
+# Start the Engine
+
+ENTRYPOINT ["./run.sh"]

README.md

+
+
+# Aura Engine
+
+<img src="https://gitlab.servus.at/autoradio/meta/-/raw/master/images/aura-engine.png" width="250" align="right" />
+
+Aura Engine is a scheduling and play-out engine as part of [Aura Radio Software Suite](#About), specifically build for
+the requirements of community radios.
+
+<!-- TOC -->
+
+- [Aura Engine](#aura-engine)
+    - [Features](#features)
+    - [Architecture](#architecture)
+    - [Installation](#installation)
+    - [Read more](#read-more)
+    - [About](#about)
+    - [Resources](#resources)
+
+<!-- /TOC -->
+
+## Features
+
+- Play audio from multiple sources
+- Dynamic switching of sources
+- Record output to filesystem
+- Stream output to an Icecast Server
+- Multichannel Line-out
+- Blank Detenction / Silence Detecter
+- Auto Pilot a.k.a. Fallback Handling
+- API to query Track-Service, monthly reports and information for displaying the Studio Clock (see [Engine API](https://gitlab.servus.at/aura/engine-api))
+- Web Application for displaying the Track-Service (see [AURA Player](https://gitlab.servus.at/aura/player))
+- Web Application for displaying the Studio Clock (see [Engine Clock](https://gitlab.servus.at/aura/engine-clock))
+
+Read more on the [Engine Features](docs/engine-features.md) page.
+
+## Architecture
+
+AURA Engine as part of the AURA Radio Suite uses an modulear architecture
+based on a REST API. All external information is retrieved using JSON data-structures.
+
+To learn more, checkout the [Engine Developer Guide](docs/developer-guide.md) or visit
+ the [Aura Meta](https://gitlab.servus.at/autoradio/meta) repository.
+
+## Installation
+
+- [Installation for Development](docs/installation-development.md)
+- [Installation for Production](docs/installation-production.md)
+- [Running with Docker](docs/running-docker.md)
+- [Setup the Audio Store](docs/setup-audio-store.md)
+
+## Read more
+
+- [Developer Guide](docs/developer-guide.md)
+- [Engine Features](docs/engine-features.md)
+- [Frequently Asked Questions (FAQ)](docs/frequently-asked-questions.md)
+
+
+## About
+
+Aura Engine is a scheduling and play-out engine as part of [Aura Radio Software Suite](#About), specifically build for
+the requirements of community radios.
+
+[<img src="https://gitlab.servus.at/autoradio/meta/-/raw/master/images/aura-logo.png" width="150" />](https://gitlab.servus.at/aura/meta)
+
+AURA stands for Automated Radio and is a swiss army knife for community radio stations. Beside the Engine it provides Steering (Admin Interface for the radio station), Dashboard (Collaborative scheduling and programme coordination), Tank (Audio uploading, pre-processing and delivery). Read more in the [Aura Meta](https://gitlab.servus.at/aura/meta) repository or on the specific project pages.
+
+| [<img src="https://gitlab.servus.at/aura/meta/-/raw/master/images/aura-steering.png" width="150" align="left" />](https://gitlab.servus.at/aura/steering)  |  [<img src="https://gitlab.servus.at/aura/meta/-/raw/master/images/aura-dashboard.png" width="150" align="left" />](https://gitlab.servus.at/aura/dashboard)  |  [<img src="https://gitlab.servus.at/aura/meta/-/raw/master/images/aura-tank.png" width="150" align="left" />](https://gitlab.servus.at/aura/tank) | [<img src="https://gitlab.servus.at/aura/meta/-/raw/master/images/aura-engine.png" width="150" align="left" />](https://gitlab.servus.at/aura/engine)  |
+|---|---|---|---|
+| [Steering](https://gitlab.servus.at/aura/steering)  | [Dashboard](https://gitlab.servus.at/aura/dashboard)  | [Tank](https://gitlab.servus.at/aura/tank)  | [Engine](https://gitlab.servus.at/aura/engine)<br/>[Engine API](https://gitlab.servus.at/aura/engine-api)<br/>[Engine Clock](https://gitlab.servus.at/aura/engine-clock)  |
+
+## Resources
+
+* **Python**: https://docs.python.org/
+* **Redis**: https://redis.io/
+* **OPAM (OCaml Package Manager)**: https://opam.ocaml.org/
+* **Liquidsoap**: https://www.liquidsoap.info/doc-1.4.0/
+* **Jack Audio**: https://jackaudio.org/
+* **Flask**: https://palletsprojects.com/p/flask/
+* **Supervisor**: http://supervisord.org/
+* **Gunicorn**: https://gunicorn.org/
\ No newline at end of file

configuration/playlists/.gitignore

+# Ignore everything in this directory
+*
+# Except this file
+!.gitignore
\ No newline at end of file

configuration/sample-development.engine.ini

+
+###################
+# Engine Settings #
+###################
+
+[station]
+station_name="Radio Aura"
+station_logo_url=https://o94.at/themes/custom/radio_orange/logo1.png
+station_logo_size=180px
+
+
+[database]
+db_user="aura"
+db_name="aura_engine"
+db_pass="---SECRET--PASSWORD---"
+db_host="localhost"
+db_charset="utf8"
+
+[redis]
+redis_host="localhost"
+redis_port=6379
+redis_db=0
+
+[monitoring]
+mail_server="mail.example.com"
+mail_server_port="587"
+mail_user="aura@subsquare.at"
+mail_pass="---SECRET--PASSWORD---"
+# If you want to send multiple adminmails, make them space separated
+admin_mail="david@subsquare.at"
+# Which from mailadress should be used
+from_mail="monitoring@aura.engine"
+# The beginning of the subject. With that you can easily apply filter rules using a mail client
+mailsubject_prefix="[Aura Engine]"
+# Server where heartbeat info is sent to
+heartbeat_server = "127.0.0.1"   
+# Some UDP port
+heartbeat_port = 43334 
+# Seconds how often the vitality of the Engine should be checked (0 = disabled)
+heartbeat_frequency = 1
+
+logdir="/home/username/code/aura/engine/logs"
+# possible values: debug, info, warning, error, critical
+loglevel="info"
+
+[api]
+
+## STEERING ##
+
+# The URL to get the health status 
+api_steering_status="http://localhost:8000/api/v1/"
+# The URL to get the Calendar via Steering
+api_steering_calendar="http://localhost:8000/api/v1/playout"
+
+## TANK ##
+
+# The session name which is used to authenticate against Tank
+api_tank_session="engine"
+# The secret which is used to authenticate against Tank
+api_tank_secret="rather-secret"
+# The URL to get the health status 
+api_tank_status="http://localhost:8040/healthz/"
+# The URL to get playlist details via Tank
+api_tank_playlist="http://localhost:8040/api/v1/playlists/${ID}"
+
+## ENGINE-API ##
+
+# Engine ID (1 or 2)
+api_engine_number=1
+# Engine API availability check
+api_engine_status="http://localhost:8008/api/v1/ui/"
+# Engine API endpoint to store playlogs
+api_engine_store_playlog="http://localhost:8008/api/v1/playlog/store"
+# Engine API endpoint to store clock information
+api_engine_store_clock="http://localhost:8008/api/v1/clock"
+# Engine API endpoint to store health information
+api_engine_store_health="http://localhost:8008/api/v1/source/health/${ENGINE_NUMBER}"
+
+
+[scheduling]
+# How often should the calendar be fetched in seconds. This determines the time of the last changes applied, before a specific show aired
+fetching_frequency=50
+# The scheduling window defines when the entries of each schedule are queued for play-out. The actual window (scheduling_window_start - scheduling_window_end)
+# should be higher then the `fetching_frequency` to allow proper queuing. Otherwise the fetch might never hit the scheduling window, because the scheduling
+# logic is attached to the fetching logic. 
+# 
+# Following operations are related to the scheduling window:
+# 
+#   - Deletion of schedules/timeslots: Those are only accepted until the **start** of the scheduling window
+#   - Update/Delete/Assignment of playlists and entries: Those are accepted until the **end** of the the scheduling window; existing queued entries are updated
+#   - Pro-active fallback handling: Within the window it is continousely evaluated if some fallback playlist should be applied. The queued items are updated accordingly
+#
+# After the end of the scheduling window the pre-rolling phase starts. It's recommended that the end of the windows is approximately 4x times
+# higher than the preroll_offset, to leave enough space for all 4 fallback scenarios to pre-roll (normal, show, timeslot and station).
+# Note, the values for windows is defined as a offset minus the actual start of the schedule in seconds.
+scheduling_window_start=120
+scheduling_window_end=60
+# Playlist ID which is used for station fallbacks. Only used if no station fallback ID is provided via Steering. "0" means it is disabled.
+scheduling_station_fallback_id=0
+# How many seconds before the actual schedule time the entry should be pre-rolled. Note to provide enough timeout for
+# contents which take longer to load (big files, bad connectivity to streams etc.)
+preroll_offset=15
+
+# Sometimes it might take longer to get a stream connected. Here you can define a viable length.
+# But note, that this may affect the preroll time (see `preroll_offset`), hence affecting the 
+# overall playout, it's delays and possible fallbacks
+input_stream_retry_delay=1
+input_stream_max_retries=10
+input_stream_buffer=3.0
+
+# sets the time how long we have to fade in and out, when we select another mixer input
+# values are in seconds
+# this is solved on engine level because it is kind of tough with liquidsoap
+[fading]
+fade_in_time="0.5"
+fade_out_time="2.5"
+
+
+
+#######################
+# Liquidsoap Settings #
+#######################
+
+# all these settings from here to the bottom require a restart of the liquidsoap server
+
+[lqs]
+liquidsoap_path="/home/username/.opam/4.08.0/bin/liquidsoap"
+liquidsoap_working_dir="modules/liquidsoap/"
+liquidsoap_as_root="false"
+
+# Liquidsoap execution delay in seconds; Crucial to keep things in sync
+lqs_delay_offset=1
+
+[user]
+# the user and group under which this software will run
+daemongroup="engineuser"
+daemonuser="engineuser"
+
+[socket]
+socketdir="/home/username/code/aura/engine/modules/liquidsoap"
+
+[audiosources]
+audio_source_folder="var/audio/source"
+audio_source_extension=".flac"
+
+[fallback]
+# track_sensitive => fallback_folder track sensitivity
+# max_blank => maximum time of blank from source (defaults to 20., seconds, float)
+# min_noise => minimum duration of noise on source to switch back over (defaults to 0, seconds, float)
+# threshold => power in dB under which the stream is considered silent (defaults to -40., float)
+fallback_max_blank="20."
+fallback_min_noise="0."
+fallback_threshold="-50."
+# A playlist holding music for Station Fallbacks (optonal)
+fallback_music_playlist= "/home/username/code/aura/configuration/playlists/station-fallback-playlist.m3u"
+# A folder holding music for Station Fallbacks (optional)
+fallback_music_folder="/var/audio/station"
+# The time in seconds how often the folder should be re-scanned
+# Do not reload too often when using large folders
+fallback_music_folder_reload="300"
+
+
+[soundcard]
+# choose your weapon
+# if you are starving for pain in the ass choose alsa
+# if you don't care about latency choose pulseaudio
+# if you want low latency and a bit of experimenting, choose jack
+soundsystem="alsa"
+
+# you can define up to 5 inputs and outputs
+# it is tested with
+#  - ALSA with ONE input and ONE output
+#  - pulseaudio with ONE input and ONE output (should work with multiple ins/outs)
+#  - jack with multiple inputs and outputs
+#
+# boundaries:
+#  - if you use jack, you have to kill liquidsoap. somehow liquidsoap cannot disconnect from jackd when shutting down
+#
+# with alsa you have to write the devicenames like hw:0
+# with pulse and jack => an non empty value means it is used
+# devices with empty string are ignored and not used
+input_device_0=""
+input_device_1=""
+input_device_2=""
+input_device_3=""
+input_device_4=""
+# same same, but different
+output_device_0="default"
+output_device_1=""
+output_device_2=""
+output_device_3=""
+output_device_4=""
+
+# if you are using alsa, you most probably have to tweak these values
+# out of the box you will hear alot of cracklings and artifacts
+
+# alsa_buffer => int
+alsa_buffer="8192"
+#alsa_buffer="16384"
+# alsa_buffer_length => int
+alsa_buffer_length="25"
+# alsa_periods => int
+alsa_periods="0"
+# frame_duration => double
+frame_duration=""
+# frame_size => int
+frame_size=""
+
+#####################
+# Recorder Settings #
+#####################
+
+# you can define up to 5 recorder types.
+# flac, mp3, ogg, opus and wav is supported
+
+[recording]
+# flac example
+# enable this recorder. everything else than 'y' is considered as disabled
+rec_0="n"
+# first set a folder
+rec_0_folder="/var/recordings/flac"
+# after how many minutes the recording will be cut
+rec_0_duration="30"
+# file (or encoding-) type
+rec_0_encoding="flac"
+# bitrate (with encoding types without bitrate like flac or wav it is substituted. 32 => very poor quality. 320 => very high quality)
+rec_0_bitrate="128"
+# channels: everything else than 2 is considered as mono
+rec_0_channels="2"
+
+# mp3 example
+rec_1="n"
+rec_1_folder="/var/audio/rec/mp3"
+rec_1_duration="30"
+rec_1_encoding="mp3"
+rec_1_bitrate="320"
+rec_1_channels="2"
+
+# mp3 example
+rec_2="n"
+rec_2_folder="/var/audio/rec/mp3"
+rec_2_duration="30"
+rec_2_encoding="mp3"
+rec_2_bitrate="192"
+rec_2_channels="2"
+
+# ogg example
+rec_3="n"
+rec_3_folder="/var/recordings/ogg"
+rec_3_duration="30"
+rec_3_encoding="ogg"
+rec_3_bitrate="320"
+rec_3_channels="2"
+
+# opus example
+rec_4="n"
+rec_4_folder="/var/recordings/opus"
+rec_4_duration="30"
+rec_4_encoding="opus"
+rec_4_bitrate="32"
+rec_4_channels="2"
+
+# wav example
+#rec_4="n"
+#rec_4_folder="/var/recordings/wav"
+#rec_4_duration="30"
+#rec_4_filetype="wav"
+#rec_4_bitrate="320"
+#rec_4_channels="2"
+
+###################
+# Stream Settings #
+###################
+
+# You can define up to outgoing 5 streams
+# flac, mp3, ogg and opus is supported
+
+[stream]
+# defines enabled or not
+stream_0="n"
+# possible values: flac, mp3, ogg, opus (depending on what liquidsoap-plugins you installed)
+stream_0_encoding="ogg"
+# bitrate (with encoding types without bitrate like flac or ogg it is substituted. 32 => very poor quality. 320 => very high quality)
+stream_0_bitrate="128"
+# how many channels? everything else than 2 is considered as mono
+stream_0_channels="2"
+# to where we are streaming..?
+stream_0_host="localhost"
+# and which port?
+stream_0_port="8888"
+# the name of the mountpoint
+stream_0_mountpoint="aura-test-0.ogg"
+# username
+stream_0_user="source"
+# and the password
+stream_0_password="source"
+# stream url
+stream_0_url="http://www.fro.at"
+# the name of the stream
+stream_0_name="AURA Test Stream 0"
+# the genre of the stream
+stream_0_genre="mixed"
+# description of the stream
+stream_0_description="Test Stream 0"
+
+stream_1="n"
+stream_1_encoding="flac"
+stream_1_bitrate="128"
+stream_1_channels="2"
+
+stream_1_host="localhost"
+stream_1_port="8888"
+stream_1_mountpoint="aura-test-1.flac"
+stream_1_user="source"
+stream_1_password="source"
+
+stream_1_url="http://www.fro.at"
+stream_1_name="AURA Test Stream 1"
+stream_1_genre="mixed"
+stream_1_description="Test Stream 1"
+
+stream_2="n"
+stream_2_encoding="mp3"
+stream_2_bitrate="64"
+stream_2_channels="2"
+
+stream_2_host="localhost"
+stream_2_port="8888"
+stream_2_mountpoint="aura-test-2.mp3"
+stream_2_user="source"
+stream_2_password="source"
+
+stream_2_url="http://www.fro.at"
+stream_2_name="AURA Test Stream 2"
+stream_2_genre="mixed"
+stream_2_description="Test Stream 2"
+
+stream_3="n"
+stream_3_encoding="ogg"
+stream_3_bitrate="64"
+stream_3_channels="2"
+
+stream_3_host="localhost"
+stream_3_port="8888"
+stream_3_mountpoint="aura-test-3.ogg"
+stream_3_user="source"
+stream_3_password="source"
+
+stream_3_url="http://www.fro.at"
+stream_3_name="AURA Test Stream 3"
+stream_3_genre="mixed"
+stream_3_description="Test Stream 3"
+
+stream_4="n"
+stream_4_encoding="opus"
+stream_4_bitrate="64"
+stream_4_channels="2"
+
+stream_4_host="localhost"
+stream_4_port="8888"
+stream_4_mountpoint="aura-test-4.opus"
+stream_4_user="source"
+stream_4_password="source"
+
+stream_4_url="http://www.fro.at"
+stream_4_name="AURA Test Stream 3"
+stream_4_genre="mixed"
+stream_4_description="Test Stream 3"

configuration/sample-docker.engine.ini

+
+###################
+# Engine Settings #
+###################
+
+[station]
+station_name="Radio Aura"
+station_logo_url="https://o94.at/themes/custom/radio_orange/logo1.png"
+station_logo_size="180px"
+
+
+[database]
+db_user="aura"
+db_name="aura_engine"
+db_pass="---SECRET--PASSWORD---"
+db_host="127.0.0.1"
+db_charset="utf8"
+
+[redis]
+redis_host="127.0.0.1"
+redis_port=6379
+redis_db=0
+
+[monitoring]
+mail_server="mail.example.com"
+mail_server_port="587"
+mail_user="aura@subsquare.at"
+mail_pass="---SECRET--PASSWORD---"
+# If you want to send multiple adminmails, make them space separated
+admin_mail="david@subsquare.at"
+# Which from mailadress should be used
+from_mail="monitoring@aura.engine"
+# The beginning of the subject. With that you can easily apply filter rules using a mail client
+mailsubject_prefix="[Aura Engine]"
+# Server where heartbeat info is sent to
+heartbeat_server = "127.0.0.1"
+# Some UDP port
+heartbeat_port = 43334 
+# Seconds how often the vitality of the Engine should be checked (0 = disabled)
+heartbeat_frequency = 1
+
+logdir="/srv/logs"
+# Possible values: debug, info, warning, error, critical
+loglevel="info"
+
+[api]
+
+## STEERING ##
+
+# The URL to get the health status 
+api_steering_status="http://127.0.0.1:8000/api/v1/"
+# The URL to get the Calendar via Steering
+api_steering_calendar="http://127.0.0.1:8000/api/v1/playout"
+
+## TANK ##
+
+# The session name which is used to authenticate against Tank
+api_tank_session="engine"
+# The secret which is used to authenticate against Tank
+api_tank_secret="rather-secret"
+# The URL to get the health status 
+api_tank_status="http://127.0.0.1:8040/healthz/"
+# The URL to get playlist details via Tank
+api_tank_playlist="http://127.0.0.1:8040/api/v1/playlists/${ID}"
+
+## ENGINE-API ##
+
+# Engine ID (1 or 2)
+api_engine_number=1
+# Engine API availability check
+api_engine_status="http://127.0.0.1:8008/api/v1/ui/"
+# Engine API endpoint to store playlogs
+api_engine_store_playlog="http://127.0.0.1:8008/api/v1/playlog/store"
+# Engine API endpoint to store clock information
+api_engine_store_clock="http://127.0.0.1:8008/api/v1/clock"
+# Engine API endpoint to store health information
+api_engine_store_health="http://127.0.0.1:8008/api/v1/source/health/${ENGINE_NUMBER}"
+
+
+[scheduling]
+# How often should the calendar be fetched in seconds. This determines the time of the last changes applied, before a specific show aired
+fetching_frequency=300
+# The scheduling window defines when the entries of each schedule are queued for play-out. The actual window (scheduling_window_start - scheduling_window_end)
+# should be higher then the `fetching_frequency` to allow proper queuing. Otherwise the fetch might never hit the scheduling window, because the scheduling
+# logic is attached to the fetching logic. 
+# 
+# Following operations are related to the scheduling window:
+# 
+#   - Deletion of schedules/timeslots: Those are only accepted until the **start** of the scheduling window
+#   - Update/Delete/Assignment of playlists and entries: Those are accepted until the **end** of the the scheduling window; existing queued entries are updated
+#   - Pro-active fallback handling: Within the window it is continousely evaluated if some fallback playlist should be applied. The queued items are updated accordingly
+#
+# After the end of the scheduling window the pre-rolling phase starts. It's recommended that the end of the windows is approximately 4x times
+# higher than the preroll_offset, to leave enough space for all 4 fallback scenarios to pre-roll (normal, show, timeslot and station).
+# Note, the values for windows is defined as a offset minus the actual start of the schedule in seconds.
+scheduling_window_start=600
+scheduling_window_end=120
+# Playlist ID which is used for station fallbacks. Only used if no station fallback ID is provided via Steering. "0" means it is disabled.
+scheduling_station_fallback_id=0
+# How many seconds before the actual schedule time the entry should be pre-rolled. Note to provide enough timeout for
+# contents which take longer to load (big files, bad connectivity to streams etc.)
+preroll_offset=30
+
+# Sometimes it might take longer to get a stream connected. Here you can define a viable length.
+# But note, that this may affect the preroll time (see `preroll_offset`), hence affecting the 
+# overall playout, it's delays and possible fallbacks
+input_stream_retry_delay=1
+input_stream_max_retries=10
+input_stream_buffer=3.0
+
+# sets the time how long we have to fade in and out, when we select another mixer input
+# values are in seconds
+# this is solved on engine level because it is kind of tough with liquidsoap
+[fading]
+fade_in_time="0.5"
+fade_out_time="2.5"
+
+#######################
+# Liquidsoap Settings #
+#######################
+
+# all these settings from here to the bottom require a restart of the liquidsoap server
+
+[lqs]
+liquidsoap_path="/usr/bin/liquidsoap"
+liquidsoap_working_dir="modules/liquidsoap/"
+liquidsoap_as_root="true"
+
+# Liquidsoap execution delay in seconds; Crucial to keep things in sync
+lqs_delay_offset=1
+
+[user]
+# the user and group under which this software will run
+daemongroup="engineuser"
+daemonuser="engineuser"
+
+[socket]
+socketdir="/srv/modules/liquidsoap"
+
+[audiosources]
+audio_source_folder="var/audio/source"
+audio_source_extension=".flac"
+
+[fallback]
+# track_sensitive => fallback_folder track sensitivity
+# max_blank => maximum time of blank from source (defaults to 20., seconds, float)
+# min_noise => minimum duration of noise on source to switch back over (defaults to 0, seconds, float)
+# threshold => power in dB under which the stream is considered silent (defaults to -40., float)
+fallback_max_blank="20."
+fallback_min_noise="0."
+fallback_threshold="-50."
+# A playlist holding music for Station Fallbacks (optonal)
+fallback_music_playlist= "/opt/aura/engine/configuration/playlists/station-fallback-playlist.m3u"
+# A folder holding music for Station Fallbacks (optional)
+fallback_music_folder="/var/audio/station"
+# The time in seconds how often the folder should be re-scanned
+# Do not reload too often when using large folders
+fallback_music_folder_reload="300"
+
+
+[soundcard]
+# choose your weapon
+# if you are starving for pain in the ass choose alsa
+# if you don't care about latency choose pulseaudio
+# if you want low latency and a bit of experimenting, choose jack
+soundsystem="alsa"
+
+# you can define up to 5 inputs and outputs
+# it is tested with
+#  - ALSA with ONE input and ONE output
+#  - pulseaudio with ONE input and ONE output (should work with multiple ins/outs)
+#  - jack with multiple inputs and outputs
+#
+# boundaries:
+#  - if you use jack, you have to kill liquidsoap. somehow liquidsoap cannot disconnect from jackd when shutting down
+#
+# with alsa you have to write the devicenames like hw:0
+# with pulse and jack => an non empty value means it is used
+# devices with empty string are ignored and not used
+input_device_0=""
+input_device_1=""
+input_device_2=""
+input_device_3=""
+input_device_4=""
+# same same, but different
+output_device_0="default"
+output_device_1=""
+output_device_2=""
+output_device_3=""
+output_device_4=""
+
+# if you are using alsa, you most probably have to tweak these values
+# out of the box you will hear alot of cracklings and artifacts
+
+# alsa_buffer => int
+#alsa_buffer="8192"
+alsa_buffer="16384"
+# alsa_buffer_length => int
+alsa_buffer_length="25"
+# alsa_periods => int
+alsa_periods="0"
+# frame_duration => double
+frame_duration=""
+# frame_size => int
+frame_size=""
+
+#####################
+# Recorder Settings #
+#####################
+
+# you can define up to 5 recorder types.
+# flac, mp3, ogg, opus and wav is supported
+
+[recording]
+# flac example
+# enable this recorder. everything else than 'y' is considered as disabled
+rec_0="n"
+# first set a folder
+rec_0_folder="/var/recordings/flac"
+# after how many minutes the recording will be cut
+rec_0_duration="30"
+# file (or encoding-) type
+rec_0_encoding="flac"
+# bitrate (with encoding types without bitrate like flac or wav it is substituted. 32 => very poor quality. 320 => very high quality)
+rec_0_bitrate="128"
+# channels: everything else than 2 is considered as mono
+rec_0_channels="2"
+
+# mp3 example
+rec_1="n"
+rec_1_folder="/var/audio/rec/mp3"
+rec_1_duration="30"
+rec_1_encoding="mp3"
+rec_1_bitrate="320"
+rec_1_channels="2"
+
+# mp3 example
+rec_2="n"
+rec_2_folder="/var/audio/rec/mp3"
+rec_2_duration="30"
+rec_2_encoding="mp3"
+rec_2_bitrate="192"
+rec_2_channels="2"
+
+# ogg example
+rec_3="n"
+rec_3_folder="/var/recordings/ogg"
+rec_3_duration="30"
+rec_3_encoding="ogg"
+rec_3_bitrate="320"
+rec_3_channels="2"
+
+# opus example
+rec_4="n"
+rec_4_folder="/var/recordings/opus"
+rec_4_duration="30"
+rec_4_encoding="opus"
+rec_4_bitrate="32"
+rec_4_channels="2"
+
+# wav example
+#rec_4="n"
+#rec_4_folder="/var/recordings/wav"
+#rec_4_duration="30"
+#rec_4_filetype="wav"
+#rec_4_bitrate="320"
+#rec_4_channels="2"
+
+###################
+# Stream Settings #
+###################
+
+# You can define up to outgoing 5 streams
+# flac, mp3, ogg and opus is supported
+
+[stream]
+# defines enabled or not
+stream_0="n"
+# possible values: flac, mp3, ogg, opus (depending on what liquidsoap-plugins you installed)
+stream_0_encoding="ogg"
+# bitrate (with encoding types without bitrate like flac or ogg it is substituted. 32 => very poor quality. 320 => very high quality)
+stream_0_bitrate="128"
+# how many channels? everything else than 2 is considered as mono
+stream_0_channels="2"
+# to where we are streaming..?
+stream_0_host="localhost"
+# and which port?
+stream_0_port="8888"
+# the name of the mountpoint
+stream_0_mountpoint="aura-test-0.ogg"
+# username
+stream_0_user="source"
+# and the password
+stream_0_password="source"
+# stream url
+stream_0_url="http://www.fro.at"
+# the name of the stream
+stream_0_name="AURA Test Stream 0"
+# the genre of the stream
+stream_0_genre="mixed"
+# description of the stream
+stream_0_description="Test Stream 0"
+
+stream_1="n"
+stream_1_encoding="flac"
+stream_1_bitrate="128"
+stream_1_channels="2"
+
+stream_1_host="localhost"
+stream_1_port="8888"
+stream_1_mountpoint="aura-test-1.flac"
+stream_1_user="source"
+stream_1_password="source"
+
+stream_1_url="http://www.fro.at"
+stream_1_name="AURA Test Stream 1"
+stream_1_genre="mixed"
+stream_1_description="Test Stream 1"
+
+stream_2="n"
+stream_2_encoding="mp3"
+stream_2_bitrate="64"
+stream_2_channels="2"
+
+stream_2_host="localhost"
+stream_2_port="8888"
+stream_2_mountpoint="aura-test-2.mp3"
+stream_2_user="source"
+stream_2_password="source"
+
+stream_2_url="http://www.fro.at"
+stream_2_name="AURA Test Stream 2"
+stream_2_genre="mixed"
+stream_2_description="Test Stream 2"
+
+stream_3="n"
+stream_3_encoding="ogg"
+stream_3_bitrate="64"
+stream_3_channels="2"
+
+stream_3_host="localhost"
+stream_3_port="8888"
+stream_3_mountpoint="aura-test-3.ogg"
+stream_3_user="source"
+stream_3_password="source"
+
+stream_3_url="http://www.fro.at"
+stream_3_name="AURA Test Stream 3"
+stream_3_genre="mixed"
+stream_3_description="Test Stream 3"
+
+stream_4="n"
+stream_4_encoding="opus"
+stream_4_bitrate="64"
+stream_4_channels="2"
+
+stream_4_host="localhost"
+stream_4_port="8888"
+stream_4_mountpoint="aura-test-4.opus"
+stream_4_user="source"
+stream_4_password="source"
+
+stream_4_url="http://www.fro.at"
+stream_4_name="AURA Test Stream 3"
+stream_4_genre="mixed"
+stream_4_description="Test Stream 3"

configuration/sample-production.engine.ini

+
+###################
+# Engine Settings #
+###################
+
+[station]
+station_name="Radio Aura"
+station_logo_url="https://o94.at/themes/custom/radio_orange/logo1.png"
+station_logo_size="180px"
+
+
+[database]
+db_user="aura"
+db_name="aura_engine"
+db_pass="---SECRET--PASSWORD---"
+db_host="localhost"
+db_charset="utf8"
+
+[redis]
+redis_host="localhost"
+redis_port=6379
+redis_db=0
+
+[monitoring]
+mail_server="mail.example.com"
+mail_server_port="587"
+mail_user="aura@subsquare.at"
+mail_pass="---SECRET--PASSWORD---"
+# If you want to send multiple adminmails, make them space separated
+admin_mail="david@subsquare.at"
+# Which from mailadress should be used
+from_mail="monitoring@aura.engine"
+# The beginning of the subject. With that you can easily apply filter rules using a mail client
+mailsubject_prefix="[Aura Engine]"
+# Server where heartbeat info is sent to
+heartbeat_server = "127.0.0.1"
+# Some UDP port
+heartbeat_port = 43334 
+# Seconds how often the vitality of the Engine should be checked (0 = disabled)
+heartbeat_frequency = 1
+
+logdir="/var/log/aura"
+# *ossible values: debug, info, warning, error, critical
+loglevel="info"
+
+[api]
+
+## STEERING ##
+
+# The URL to get the health status 
+api_steering_status="http://aura.local:8000/api/v1/"
+# The URL to get the Calendar via Steering
+api_steering_calendar="http://aura.local:8000/api/v1/playout"
+
+## TANK ##
+
+# The session name which is used to authenticate against Tank
+api_tank_session="engine"
+# The secret which is used to authenticate against Tank
+api_tank_secret="rather-secret"
+# The URL to get the health status 
+api_tank_status="http://aura.local:8040/healthz/"
+# The URL to get playlist details via Tank
+api_tank_playlist="http://aura.local:8040/api/v1/playlists/${ID}"
+
+## ENGINE-API ##
+
+# Engine ID (1 or 2)
+api_engine_number=1
+# Engine API availability check
+api_engine_status="http://localhost:8008/api/v1/ui/"
+# Engine API endpoint to store playlogs
+api_engine_store_playlog="http://localhost:8008/api/v1/playlog/store"
+# Engine API endpoint to store clock information
+api_engine_store_clock="http://localhost:8008/api/v1/clock"
+# Engine API endpoint to store health information
+api_engine_store_health="http://localhost:8008/api/v1/source/health/${ENGINE_NUMBER}"
+
+
+[scheduling]
+# How often should the calendar be fetched in seconds. This determines the time of the last changes applied, before a specific show aired
+fetching_frequency=300
+# The scheduling window defines when the entries of each schedule are queued for play-out. The actual window (scheduling_window_start - scheduling_window_end)
+# should be higher then the `fetching_frequency` to allow proper queuing. Otherwise the fetch might never hit the scheduling window, because the scheduling
+# logic is attached to the fetching logic. 
+# 
+# Following operations are related to the scheduling window:
+# 
+#   - Deletion of schedules/timeslots: Those are only accepted until the **start** of the scheduling window
+#   - Update/Delete/Assignment of playlists and entries: Those are accepted until the **end** of the the scheduling window; existing queued entries are updated
+#   - Pro-active fallback handling: Within the window it is continousely evaluated if some fallback playlist should be applied. The queued items are updated accordingly
+#
+# After the end of the scheduling window the pre-rolling phase starts. It's recommended that the end of the windows is approximately 4x times
+# higher than the preroll_offset, to leave enough space for all 4 fallback scenarios to pre-roll (normal, show, timeslot and station).
+# Note, the values for windows is defined as a offset minus the actual start of the schedule in seconds.
+scheduling_window_start=600
+scheduling_window_end=120
+# Playlist ID which is used for station fallbacks. Only used if no station fallback ID is provided via Steering. "0" means it is disabled.
+scheduling_station_fallback_id=0
+# How many seconds before the actual schedule time the entry should be pre-rolled. Note to provide enough timeout for
+# contents which take longer to load (big files, bad connectivity to streams etc.)
+preroll_offset=30
+
+# Sometimes it might take longer to get a stream connected. Here you can define a viable length.
+# But note, that this may affect the preroll time (see `preroll_offset`), hence affecting the 
+# overall playout, it's delays and possible fallbacks
+input_stream_retry_delay=1
+input_stream_max_retries=10
+input_stream_buffer=3.0
+
+# sets the time how long we have to fade in and out, when we select another mixer input
+# values are in seconds
+# this is solved on engine level because it is kind of tough with liquidsoap
+[fading]
+fade_in_time="0.5"
+fade_out_time="2.5"
+
+#######################
+# Liquidsoap Settings #
+#######################
+
+# all these settings from here to the bottom require a restart of the liquidsoap server
+
+[lqs]
+liquidsoap_path="/home/engineuser/.opam/4.08.0/bin/liquidsoap"
+liquidsoap_working_dir="modules/liquidsoap/"
+liquidsoap_as_root="false"
+
+# Liquidsoap execution delay in seconds; Crucial to keep things in sync
+lqs_delay_offset=1
+
+[user]
+# the user and group under which this software will run
+daemongroup="engineuser"
+daemonuser="engineuser"
+
+[socket]
+socketdir="/opt/aura/engine/modules/liquidsoap"
+
+[audiosources]
+audio_source_folder="var/audio/source"
+audio_source_extension=".flac"
+
+[fallback]
+# track_sensitive => fallback_folder track sensitivity
+# max_blank => maximum time of blank from source (defaults to 20., seconds, float)
+# min_noise => minimum duration of noise on source to switch back over (defaults to 0, seconds, float)
+# threshold => power in dB under which the stream is considered silent (defaults to -40., float)
+fallback_max_blank="20."
+fallback_min_noise="0."
+fallback_threshold="-50."
+# A playlist holding music for Station Fallbacks (optonal)
+fallback_music_playlist= "/opt/aura/engine/configuration/playlists/station-fallback-playlist.m3u"
+# A folder holding music for Station Fallbacks (optional)
+fallback_music_folder="/var/audio/station"
+# The time in seconds how often the folder should be re-scanned
+# Do not reload too often when using large folders
+fallback_music_folder_reload="300"
+
+
+[soundcard]
+# choose your weapon
+# if you are starving for pain in the ass choose alsa
+# if you don't care about latency choose pulseaudio
+# if you want low latency and a bit of experimenting, choose jack
+soundsystem="alsa"
+
+# you can define up to 5 inputs and outputs
+# it is tested with
+#  - ALSA with ONE input and ONE output
+#  - pulseaudio with ONE input and ONE output (should work with multiple ins/outs)
+#  - jack with multiple inputs and outputs
+#
+# boundaries:
+#  - if you use jack, you have to kill liquidsoap. somehow liquidsoap cannot disconnect from jackd when shutting down
+#
+# with alsa you have to write the devicenames like hw:0
+# with pulse and jack => an non empty value means it is used
+# devices with empty string are ignored and not used
+input_device_0=""
+input_device_1=""
+input_device_2=""
+input_device_3=""
+input_device_4=""
+# same same, but different
+output_device_0="default"
+output_device_1=""
+output_device_2=""
+output_device_3=""
+output_device_4=""
+
+# if you are using alsa, you most probably have to tweak these values
+# out of the box you will hear alot of cracklings and artifacts
+
+# alsa_buffer => int
+#alsa_buffer="8192"
+alsa_buffer="16384"
+# alsa_buffer_length => int
+alsa_buffer_length="25"
+# alsa_periods => int
+alsa_periods="0"
+# frame_duration => double
+frame_duration=""
+# frame_size => int
+frame_size=""
+
+#####################
+# Recorder Settings #
+#####################
+
+# you can define up to 5 recorder types.
+# flac, mp3, ogg, opus and wav is supported
+
+[recording]
+# flac example
+# enable this recorder. everything else than 'y' is considered as disabled
+rec_0="n"
+# first set a folder
+rec_0_folder="/var/recordings/flac"
+# after how many minutes the recording will be cut
+rec_0_duration="30"
+# file (or encoding-) type
+rec_0_encoding="flac"
+# bitrate (with encoding types without bitrate like flac or wav it is substituted. 32 => very poor quality. 320 => very high quality)
+rec_0_bitrate="128"
+# channels: everything else than 2 is considered as mono
+rec_0_channels="2"
+
+# mp3 example
+rec_1="n"
+rec_1_folder="/var/audio/rec/mp3"
+rec_1_duration="30"
+rec_1_encoding="mp3"
+rec_1_bitrate="320"
+rec_1_channels="2"
+
+# mp3 example
+rec_2="n"
+rec_2_folder="/var/audio/rec/mp3"
+rec_2_duration="30"
+rec_2_encoding="mp3"
+rec_2_bitrate="192"
+rec_2_channels="2"
+
+# ogg example
+rec_3="n"
+rec_3_folder="/var/recordings/ogg"
+rec_3_duration="30"
+rec_3_encoding="ogg"
+rec_3_bitrate="320"
+rec_3_channels="2"
+
+# opus example
+rec_4="n"
+rec_4_folder="/var/recordings/opus"
+rec_4_duration="30"
+rec_4_encoding="opus"
+rec_4_bitrate="32"
+rec_4_channels="2"
+
+# wav example
+#rec_4="n"
+#rec_4_folder="/var/recordings/wav"
+#rec_4_duration="30"
+#rec_4_filetype="wav"
+#rec_4_bitrate="320"
+#rec_4_channels="2"
+
+###################
+# Stream Settings #
+###################
+
+# You can define up to outgoing 5 streams
+# flac, mp3, ogg and opus is supported
+
+[stream]
+# defines enabled or not
+stream_0="n"
+# possible values: flac, mp3, ogg, opus (depending on what liquidsoap-plugins you installed)
+stream_0_encoding="ogg"
+# bitrate (with encoding types without bitrate like flac or ogg it is substituted. 32 => very poor quality. 320 => very high quality)
+stream_0_bitrate="128"
+# how many channels? everything else than 2 is considered as mono
+stream_0_channels="2"
+# to where we are streaming..?
+stream_0_host="localhost"
+# and which port?
+stream_0_port="8888"
+# the name of the mountpoint
+stream_0_mountpoint="aura-test-0.ogg"
+# username
+stream_0_user="source"
+# and the password
+stream_0_password="source"
+# stream url
+stream_0_url="http://www.fro.at"
+# the name of the stream
+stream_0_name="AURA Test Stream 0"
+# the genre of the stream
+stream_0_genre="mixed"
+# description of the stream
+stream_0_description="Test Stream 0"
+
+stream_1="n"
+stream_1_encoding="flac"
+stream_1_bitrate="128"
+stream_1_channels="2"
+
+stream_1_host="localhost"
+stream_1_port="8888"
+stream_1_mountpoint="aura-test-1.flac"
+stream_1_user="source"
+stream_1_password="source"
+
+stream_1_url="http://www.fro.at"
+stream_1_name="AURA Test Stream 1"
+stream_1_genre="mixed"
+stream_1_description="Test Stream 1"
+
+stream_2="n"
+stream_2_encoding="mp3"
+stream_2_bitrate="64"
+stream_2_channels="2"
+
+stream_2_host="localhost"
+stream_2_port="8888"
+stream_2_mountpoint="aura-test-2.mp3"
+stream_2_user="source"
+stream_2_password="source"
+
+stream_2_url="http://www.fro.at"
+stream_2_name="AURA Test Stream 2"
+stream_2_genre="mixed"
+stream_2_description="Test Stream 2"
+
+stream_3="n"
+stream_3_encoding="ogg"
+stream_3_bitrate="64"
+stream_3_channels="2"
+
+stream_3_host="localhost"
+stream_3_port="8888"
+stream_3_mountpoint="aura-test-3.ogg"
+stream_3_user="source"
+stream_3_password="source"
+
+stream_3_url="http://www.fro.at"
+stream_3_name="AURA Test Stream 3"
+stream_3_genre="mixed"
+stream_3_description="Test Stream 3"
+
+stream_4="n"
+stream_4_encoding="opus"
+stream_4_bitrate="64"
+stream_4_channels="2"
+
+stream_4_host="localhost"
+stream_4_port="8888"
+stream_4_mountpoint="aura-test-4.opus"
+stream_4_user="source"
+stream_4_password="source"
+
+stream_4_url="http://www.fro.at"
+stream_4_name="AURA Test Stream 3"
+stream_4_genre="mixed"
+stream_4_description="Test Stream 3"

configuration/supervisor/aura-engine.conf

+[program:aura-engine]
+user = engineuser
+directory = /opt/aura/engine
+command = /opt/aura/engine/run.sh engine
+
+priority = 666
+autostart = true
+autorestart = true
+stopsignal = TERM
+
+redirect_stderr = true
+stdout_logfile = /opt/aura/engine/logs/engine-core-stdout.log
+stderr_logfile = /opt/aura/engine/logs/engine-core-error.log
\ No newline at end of file

configuration/systemd/aura-engine-core.service

+[Unit]
+Description=Aura Engine - Playout Server (Core)
+After=network.target
+Documentation=https://gitlab.servus.at/aura/engine
+
+[Service]
+Type=simple
+User=engineuser
+WorkingDirectory=/opt/aura/engine
+ExecStart=/opt/aura/engine/run.sh core
+ExecStop=/opt/aura/engine/guru.py --shutdown --quiet
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+Alias=aura-engine-core.service
\ No newline at end of file

configuration/systemd/aura-engine-lqs.service

+[Unit]
+Description=Aura Engine - Playout Server (Liquidsoap)
+Documentation=https://gitlab.servus.at/aura/engine
+After=network.target
+Requires=aura-engine-lqs.socket
+
+[Service]
+Type=simple
+User=engineuser
+WorkingDirectory=/opt/aura/engine
+ExecStart=/opt/aura/engine/engine/run.sh lqs
+Restart=always
+
+[Install]
+WantedBy=default.target
+Alias=aura-engine-lqs.service

configuration/systemd/aura-engine-lqs.socket

+[Unit]
+Description=Aura Engine - Liquidsoap Socket
+PartOf=aura-engine-lqs.service
+
+[Socket]
+ListenStream=/opt/aura/engine/modules/liquidsoap/engine.sock
+Accept=false
+
+[Install]
+WantedBy=sockets.target
\ No newline at end of file

configuration/systemd/aura-engine.service

+[Unit]
+Description=Aura Engine - Playout Server
+Documentation=https://gitlab.servus.at/aura/engine
+After=network.target
+
+[Service]
+Type=simple
+User=engineuser
+WorkingDirectory=/opt/aura/engine
+ExecStart=/opt/aura/engine/run.sh
+ExecStop=/opt/aura/engine/guru.py --shutdown --quiet
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+Alias=aura-engine.service
\ No newline at end of file