appdefs.yml

---

#
# Definitions for HandBrake docker container.
#
# This file is used as data source to generate README.md and unRAID template files
# from Jinja2 templates.
#

app:
  id: 3
  name: handbrake
  friendly_name: HandBrake
  gui_type: x11
  project:
    description: |-
      HandBrake is a tool for converting video from nearly any format to a selection
      of modern, widely supported codecs.
    url: https://handbrake.fr
  unraid:
    support_url: https://forums.unraid.net/topic/57420-support-handbrake/
    category: "MediaApp:Video"
  documentation:
    overview: |-
      A fully automated mode is also available: drop files into a watch folder and let
      {{ app.friendly_name }} process them without any user interaction.
    sections:
      - title: Access to Optical Drive(s)
        level: 2
        content: |-
          By default, a Docker container doesn't have access to host's devices.  However,
          access to one or more device can be granted with the `--device DEV` parameter.

          Optical drives usually have `/dev/srX` as device.  For example, the first drive
          is `/dev/sr0`, the second `/dev/sr1`, and so on.  To allow HandBrake to access
          the first drive, this parameter is needed:
          ```
          --device /dev/sr0
          ```

          To easily find devices of optical drives, start the container and look at its
          log for messages similar to these ones:
          ```
          ...
          [cont-init.d] 54-check-optical-drive.sh: executing...
          [cont-init.d] 54-check-optical-drive.sh: looking for usable optical drives...
          [cont-init.d] 54-check-optical-drive.sh: found optical drive /dev/sr0, but it is not usable because is not exposed to the container.
          [cont-init.d] 54-check-optical-drive.sh: no usable optical drive found.
          [cont-init.d] 54-check-optical-drive.sh: exited 0.
          ...
          ```

          Since HandBrake can decrypt DVD video discs, their conversion can be performed
          directly from the optical device.  From the graphical interface, click the
          `Open Source` button and browse through the file system to find your optical
          drive device (e.g. `/dev/sr0`).
      - title: Automatic Video Conversion
        level: 2
        content: |-
          This container has an automatic video converter built-in.  This is useful to
          batch-convert videos without user interaction.

          Basically, files copied to the `/watch` container folder are automatically
          converted by HandBrake to a pre-defined video format according to a pre-defined
          preset.

          All configuration parameters of the automatic video converter are
          defined via environment variables.  See the
          [Environment Variables](#environment-variables) section for the list of
          available variables.  The ones having their name starting with
          `AUTOMATED_CONVERSION_` apply to the automatic video converter.

          **NOTE**: A preset is identified by its category and its name.

          **NOTE**: All default presets, along with personalized/custom ones, can be seen
          and edited with the HandBrake GUI.

          **NOTE**: Converted videos are stored, by default, to the `/output` folder of
          the container.

          **NOTE**: The status and progression of conversions performed by the automatic
          video converter can be seen from both the GUI and the container's log.
          Container's log can be obtained by executing the command
          `docker logs handbrake`, where `handbrake` is the name of the container.  Also,
          full details about the conversion are stored in `/config/log/hb/conversion.log`
          (container path).
      - title: Multiple Watch Folders
        level: 3
        content: |-
          If needed, additionnal watch folders can be used:
            - `/watch2`
            - `/watch3`
            - `/watch4`
            - `/watch5`
            - etc.

          This is useful for scenarios where videos need to be converted by different
          presets.  For example, one could use a watch folder for movies and another watch
          folder for TV shows, both having different encoding quality requirements.

          By default, additional watch folders inherits the same settings has the main one
          (`/watch`).  A setting for a particular watch folder can be overriden by adding
          its index to the corresponding environment variable name.

          For example, to set the HandBrake preset used to convert videos in `/watch2`,
          the environment variable `AUTOMATED_CONVERSION_PRESET_2` is used.
          `AUTOMATED_CONVERSION_PRESET_3` is used for `/watch3`, and so on.

          All settings related to the automatic video converter (environment variables
          with name prefixed with `AUTOMATED_CONVERSION_`) can be overriden for each
          additional watch folder.

          The maximum number of watch folders handled by the automatic video converter
          is defined by the `AUTOMATED_CONVERSION_MAX_WATCH_FOLDERS` environment variable.

          **NOTE**: Each additional watch folder must be mapped to a folder on the host by
          adding a volume mapping during the creation of the container.

          **NOTE**: Each output folder defined via the `AUTOMATED_CONVERSION_OUTPUT_DIR`
          environment variable must be mapped to a folder on the host by adding a volume
          mapping during the creation of the container.
      - title: Video Discs
        level: 3
        content: |-
          The automatic video converter supports video discs, in the following format:
            - ISO image file.
            - DVD video disc folder containing the `VIDEO_TS` folder.
            - Blu-ray video disc folder containing the `BDMV` folder.

          Note that folder names are case sensitive.  For example, `video_ts`, `Video_Ts`
          or `Bdmv` won't be treated as discs, but as normal directories.

          When the source is a disc folder, the name of the converted video file will
          match to one of its folder.  For example, `/watch/MyMovie/VIDEO_TS` will produce
          a video file with name `MyMovie.mp4`.

          Video discs can have multiple titles (the main movie, previews, extras, etc).
          In a such case, each title is converted to its own file.  These files have the
          suffix `.title-XX`, where `XX` is the title number. For example, if the file
          `MyMovie.iso` has 2 titles, the following files would be generated:
            - `MyMovie.title-1.mp4`
            - `MyMovie.title-2.mp4`

          It is possible to ignore titles shorted than a specific amount of time.  By
          default, only titles longer than 10 seconds are processed.  This duration can be
          adjusted via the `AUTOMATED_CONVERSION_SOURCE_MIN_DURATION` environment
          variable.  See the [Environment Variables](#environment-variables) section for
          details about setting environment variables.
      - title: Hooks
        level: 3
        content: |-
          Custom actions can be performed using hooks.  Hooks are shell scripts executed
          by the automatic video converter.

          **NOTE**: Hooks are always invoked via `/bin/sh`, ignoring any shebang the
          script may have.

          Hooks are optional and by default, no one is defined.  A hook is defined and
          executed when the script is found at a specific location.

          The following table describe available hooks:

          | Container location | Description | Parameter(s) |
          |--------------------|-------------|--------------|
          | `/config/hooks/pre_conversion.sh` | Hook executed before the beginning of a video conversion. | The first argument is the path of the converted video.  The second argument is the path to the source file.  Finally, the third argument is the name of the Handbrake preset that will be used to convert the video. |
          | `/config/hooks/post_conversion.sh` | Hook executed when the conversion of a video file is terminated. | The first parameter is the status of the conversion.  A value of `0` indicates that the conversion terminated successfuly.  Any other value represent a failure.  The second argument is the path to the converted video (the output).  The third argument is the path to the source file.  Finally, the fourth argument is the name of the Handbrake preset used to convert the video. |
          | `/config/post_watch_folder_processing.sh` | Hook executed after all videos in the watch folder have been processed. | The path of the watch folder. |

          During the first start of the container, example hooks are installed in
          `/config/hooks/`.  Example scripts have the suffix `.example`.  For example,
          you can use `/config/hooks/post_conversion.sh.example` as a starting point.

          **NOTE**: Keep in mind that this container has the minimal set of packages
          required to run HandBrake.  This may limit actions that can be performed in
          hooks.
      - title: Temporary Conversion Directory
        level: 3
        content: |-
          A video being converted is written in a hidden, temporary directory under the
          root of the output directory (`/output` by default).  Once a conversion
          successfully terminates, the video file is moved to its final location.

          This feature can be useful for scenarios where the output folder is monitored
          by another application: with proper configuration, one can make sure this
          application only "sees" the final, converted video file and not the transient
          versions.

          If the monitoring application ignores hidden directories, then nothing special
          is required and the application should always see the final file.

          However, if the monitoring application handles hidden directories, the automatic
          video converter should be configured with the
          `AUTOMATED_CONVERSION_OUTPUT_SUBDIR` environment variable sets to a
          subdirectory.  The application can then be configured to monitor this
          subdirectory.  For example, if `AUTOMATED_CONVERSION_OUTPUT_SUBDIR` is set to
          `TV Shows` and `/output` is mapped to `/home/user/appvolumes/HandBrake` on the
          host, `/home/user/appvolumes/HandBrake/TV Shows` should be monitored by the
          application.
      - title: Intel Quick Sync Video
        level: 2
        content: |-
          Intel Quick Sync Video is Intel's brand for its dedicated video encoding and
          decoding hardware core.  It is a technology that is capable of offloading video
          decoding and encoding task to the integrated GPU, thus saving the CPU usage to
          do other tasks.  As a specialized hardware core on the processor die, Quick Sync
          offers a much more power efficient video processing which is much superior to
          video encoding on a CPU.

          For HandBrake to be able to use hardware-accelerated encoding, the following are
          required:

            - Have a compatible Intel processor.  To determine if your CPU has the Quick
              Sync Video hardware, consult this [list] from the [Intel Ark] website.  The
              model name of your processor is printed to the container's log during its
              startup.  Look for a message like this:
              ```
              [cont-init.d] 95-check-qsv.sh: Processor: Intel(R) Core(TM) i7-2600 CPU @ 3.40GHz
              ```
            - The Intel i915 graphic driver must be loaded on the **host**.
            - The `/dev/dri` device must be exposed to the container.  This is done by
              adding the `--device /dev/dri` parameter to the `docker run` command.

          When Intel Quick Sync Video is properly enabled, HandBrake offers the following
          video encoder:
          ```
          H.264 (Intel QSV)
          ```

          If this encoder is not part of the list, something is wrong and looking at the
          container's log can give more details about the issue.

          **NOTE**: In most cases, HandBrake can successfully access the `/dev/dri` device
          without changing anything on the host side.  This is possible because the user
          under which the container is running is automatically added to the group owning
          the `/dev/dri` device.  However, this method doesn't work if the device is owned
          by the group `root`.  The problem can be fixed using one of the following
          methods:
            - Running the container as root (`USER_ID=0`).
            - Adding, on the host, read/write permissions for all to the `/dev/dri`
              device:
              ```
              sudo chmod a+wr /dev/dri/*
              ```
            - Changing, on the host, the group owning the `/dev/dri` device.  For example,
              to change the group to `video`:
              ```
              sudo chown root:video /dev/dri/*
              ```

          [list]: https://ark.intel.com/Search/FeatureFilter?productType=processors&QuickSyncVideo=true
          [Intel Ark]: https://ark.intel.com
      - title: unRAID
        level: 3
        content: |-
          With recent versions of unRAID, the Intel i915 driver is already included in the
          distribution and is automatically loaded.
          
          With older versions, the following lines might need to be added to
          `/boot/config/go` for the driver to be loaded during the startup of unRAID:
          ```
          # Load the i915 driver.
          modprobe i915
          ```
      - title: Nightly Builds
        level: 2
        content: |-
          Nightly builds are based on the latest {{ app.friendly_name }} development code.
          This means that they may have bugs, crashes and instabilities.

          Nightly builds are available through Docker image tags.  These tags have the
          following format:
          ```
          nightly-<COMMIT_DATE>-<COMMIT_HASH>
          ```

          Where:
            - `COMMIT_DATE` is the date (in `YYMMDDHHMMSS` format) of the latest commit
              from the {{ app.friendly_name }} [Git repository].
            - `COMMIT_HASH` is the short hash of the latest commit from the {{ app.friendly_name }}
              [Git repository].

          The latest nightly build is available through the `nightly-latest` Docker image
          tag.  The list of available tags are available on [Docker Hub].

          To use a Docker image tag, it has to be appended to the name of the Docker image
          during the creation of the container.  Here is an example:
          ```
          docker run [OPTIONS..] jlesage/{{ app.name }}:nightly-latest
          ```

          [Git repository]: https://github.com/HandBrake/HandBrake
          [Docker Hub]: https://hub.docker.com/r/jlesage/{{ app.name }}/tags/
      - title: Debug Builds
        level: 2
        content: |-
          Debug builds can be used to better investigate problems that can occur with
          {{ app.friendly_name }}.  These builds have {{ app.friendly_name }}
          compiled in debug mode and all symbols are kept.

          The main use case of debug builds is debugging a crash.  To do this, a core dump
          needs to be generated when {{ app.friendly_name }} crashes.  To make sure
          this core dump is properly generated, two things are required:

            1. Core dumps must be enabled.  This is done by setting the maximum size of
               cores via the `--ulimit core=-1` parameter of the `docker run` command.
               A value of `-1` mean "unlimited".
            2. Location of the cores must be set.  This can be done by executing the
               following command on the **host**:
               ```
               echo 'CORE_PATTERN' | sudo tee /proc/sys/kernel/core_pattern
               ```
               Where `CORE_PATTERN` is the template that defines the naming of core dump
               files.  For example, to set the files in the configuration volume of the
               container (for easy retrieval from the host), use the pattern
               `/config/core.%e.%t`.

               **NOTE**: Because a core file contains the complete memory layout of an
               application, it is created with restrictive permissions.  If another user
               other than the one used to run {{ app.friendly_name }} needs to access
               the core file, permissions must be changed by executing
               `chmod a+r CORE`, where `CORE` is the path to the core file.

               **NOTE**: Since the core dump files pattern is shared between the host and
               the container, you may want to revert to the original pattern once
               done.

               **NOTE**: The current value of the pattern can be obtained by executing
               `cat /proc/sys/kernel/core_pattern`.

          Debug builds are available by using Docker image tags with the `debug` suffix.
          Make sure to look at available [tags on Docker Hub].

          When creating the container, the tag needs to be appended to the name of the
          Docker image, like this:
          ```
          docker run [OPTIONS..] jlesage/{{ app.name }}:v1.14.3-debug
          ```

          [tags on Docker Hub]: https://hub.docker.com/r/jlesage/{{ app.name }}/tags/
      - title: unRAID
        level: 3
        content: |-
          On systems running unRAID, the `--ulimit core=-1` parameter can be added to the
          `Extra Parameters` field of the container settings.
  changelog:
    - version: 23.06.1
      date: 2023-06-08
      changes:
        - 'Updated libva to version 2.18.'
        - 'Updated gmmlib to version 22.3.5.'
        - 'Updated Intel Media Driver to version 23.1.6.'
        - 'Updated OneVPL GPU Runtime to version 23.1.5.'
        - 'Validate the output folder used by the Automatic Video Converter.'
        - 'Updated baseimage to version 4.4.2, which brings the following changes:'
        - '2:Rebuilt against latest distro images to get security fixes.'
        - '2:Updated X server to version 1.20.14.'
    - version: 23.04.1
      date: 2023-04-29
      changes:
        - 'Updated baseimage to version 4.4.1, which brings the following changes:'
        - '2:Updated TigerVNC to version 1.13.1.'
    - version: 23.03.2
      date: 2023-03-05
      changes:
        - 'Fixed issue where the Automatic Video Converter was not running with the correct supplementary groups.'
    - version: 23.03.1
      date: 2023-03-05
      changes:
        - 'Fixed `AUTOMATED_CONVERSION_NO_GUI_PROGRESS` environment variable not being handled.'
        - 'Make sure the Automatic Video Converter does not report conversion progress to GUI when it is disabled.'
        - 'Improved QSV checks by handling virtualized hosts.'
        - 'Updated baseimage to version 4.4.0, which brings the following changes:'
        - '2:Updated components providing access to application''s UI over web.'
        - '2:Improved web UI usage with touch devices.'
        - '2:Fixed issue with initialization of Linux users and groups when the `GROUP_ID` is also part of `SUP_GROUP_IDS`.'
    - version: 23.02.1
      date: 2023-02-26
      changes:
        - 'Updated HandBrake to version 1.6.1.'
        - 'Updated libva, gmmlib, Intel Media Driver, Intel Media SDK and Intel OneVPL.'
        - 'The Automatic Video Converter now has the ability to move source files to trash instead of removing them.'
        - 'Improved robustness of the Automatic Video Converter.'
        - 'Added the ability to disable the HandBrake GUI.'
        - 'Added the ability to disable the Automatic Video Converter.'
        - 'Versioning scheme of the Docker image changed to `YY.MM.SEQUENCE`.'
        - 'Update of the baseimage to version 4.3.6 brings the following new features:'
        - '2:Support for dark mode.'
        - '2:Support for remote window resize.'
        - '2:Updated the web UI with a new, simplified and less intrusive look.'
    - version: 1.25.1
      date: 2022-06-28
      changes:
        - 'Fixed the Automatic Video Converter not working due to usage of undefined variable.'
        - 'The Automatic Video Converter now correctly uses the main feature detection.'
    - version: 1.25.0
      date: 2022-06-27
      changes:
        - 'Updated HandBrake to version 1.5.1.'
        - 'Updated libva to version 2.14.0.'
        - 'Updated gmmlib to version 22.1.4.'
        - 'Updated Intel Media Driver to version 22.3.1.'
        - 'Updated Intel Media SDK to version 22.3.0.'
        - 'Updated x264 library to get support for the H.264 10bit encoder.'
        - 'Added the `AUTOMATED_CONVERSION_SOURCE_MAIN_TITLE_DETECTION` environment variable that enables main feature title detection of HandBrake.'
        - 'Now using baseimage version 3.5.8, based on Alpine Linux 3.14, which brings the following changes:'
        - '2:Updated installed packages to get latest security fixes.'
    - version: 1.24.2
      date: 2021-10-04
      changes:
        - 'Updated HandBrake to version 1.4.2.'
        - 'Updated Intel Media SDK to version 21.3.5.'
        - 'Updated gmmlib to version 21.3.1.'
    - version: 1.24.1
      date: 2021-08-21
      changes:
        - 'Updated Handbrake to version 1.4.1.'
    - version: 1.24.0
      date: 2021-07-19
      changes:
        - 'Updated Handbrake to version 1.4.0.'
        - 'Updated libva to version 2.12.0.'
        - 'Updated gmmlib to version 21.2.1.'
        - 'Updated Intel Media Driver to version 21.2.3.'
        - 'Updated Intel Media SDK to version 21.2.3.'
        - 'Now using baseimage version 3.5.7, which brings the following changes:'
        - '2:Updated installed packages to get latest security fixes.'
    - version: 1.23.2
      date: 2021-03-13
      changes:
        - 'Fixed issue where the wrong parameter was passed to the post watch folder processing hook.'
    - version: 1.23.1
      date: 2021-02-06
      changes:
        - 'Fixed an issue where the automatic video converter would not process Blu-ray video disc folder.'
    - version: 1.23.0
      date: 2021-01-01
      changes:
        - 'Added the ability to overwrite the output file if it exists.'
        - 'Added the ability to define the file extensions to be considered as video files.'
        - 'Updated libva to version 2.10.0.'
        - 'Updated gmmlib to version 20.4.1.'
        - 'Updated Intel Media Driver to version 20.4.5.'
        - 'Updated Intel Media SDK to version 20.5.1.'
        - 'Now using baseimage based on Alpine 3.12.'
    - version: 1.22.4
      date: 2020-08-05
      changes:
        - 'Upgraded libva to version 2.8.0.'
        - 'Upgraded Intel Media SDK to version 20.2.1.'
        - 'Upgraded Intel Media Driver to version 20.2.0.'
        - 'Fixed an issue where non-video files would fail to be copied.'
        - 'Now using baseimage version 3.5.6, which brings the following changes:'
        - '2:Other small adjustments for the YAD log monitor target.'
    - version: 1.22.3
      date: 2020-06-22
      changes:
        - 'Upgraded HandBrake to version 1.3.3.'
        - 'Upgraded Intel VAAPI driver to version 2.4.1.'
        - 'Now using Alpine 3.11 baseimage.'
    - version: 1.22.2
      date: 2020-05-26
      changes:
        - 'Fixed issue where Intel QSV H.265 encoding would fail.'
    - version: 1.22.1
      date: 2020-05-09
      changes:
        - 'Fixed the default preset used by the automatic video converter.'
        - 'Fixed an issue where progress of a multi-pass encoding done by the automatic video converter would not be displayed correctly in the UI.'
    - version: 1.22.0
      date: 2020-05-04
      changes:
        - 'Upgraded HandBrake to version 1.3.2.'
        - '2:NOTE: Presets are now identified with their category. This means that any preset configured for the automatic video converter needs to be adjusted.'
        - 'Upgraded libva to version 2.7.1.'
        - 'Upgraded Intel Media Driver to version 20.1.1.'
        - 'Upgraded Intel Media SDK to version 20.1.1.'
    - version: 1.21.0
      date: 2020-03-08
      changes:
        - 'Custom packages for the Automatic Video Converter can now be installed via the `AUTOMATED_CONVERSION_INSTALL_PKGS` environment variable.'
    - version: 1.20.0
      date: 2020-02-10
      changes:
        - 'Upgraded HandBrake to version 1.3.1.'
        - 'Upgraded libva to version 2.6.1.'
        - 'Upgraded Intel Media SDK to version 19.4.0.'
        - 'Upgraded Intel Media Driver to version 19.4.0.'
        - 'Upgraded Intel VAAPI driver to version 2.4.0.'
    - version: 1.19.0
      date: 2019-12-08
      changes:
        - 'Added the ability to set a list of file extensions to be considered as non-video files.  This fixes an issue where the automatic video converter would successfully convert non-video files, like images.'
        - 'Added the ability to provide custom arguments to HandBrake when it is invoked by the automatic video converter.'
    - version: 1.18.0
      date: 2019-11-11
      changes:
        - 'Upgraded HandBrake to version 1.3.0.'
        - 'Action to take by the automatic video converter for non-video files is now configurable.'
        - 'The automatic video converter now fails the conversion if no title is found in video file.'
        - 'Now using baseimage v3.5.3, based on Alpine Liux 3.10, which brings the following changes:'
        - '2:Updated installed packages to get latest security fixes.'
        - '2:Make sure the tzdata is installed.'
    - version: 1.17.1
      date: 2019-05-04
      changes:
        - 'Fixed an issue where the progress output of the automatic video converter would hang.'
        - 'Enhanced the progress output of the automatic video converter by showing the path of the video being converted.'
        - 'Enhanced the progress output of the automatic video converter by adjusting the frequency of messages.'
    - version: 1.17.0
      date: 2019-04-26
      changes:
        - 'Progress of conversions performed by the automatic video converter can be seen in the HandBrake GUI.'
        - 'Fixed an issue where a video conversion failure would not be detected.'
        - 'Now using baseimage v3.5.2, which brings the following changes:'
        - '2:Updated installed packages to get latest security fixes.'
        - '2:Fixed issue where the container could have a zombie process.'
        - '2:Fixed issue where the password would not be submitted when pressing the enter key in the password modal.'
        - '2:Use relative path for favicon ressources to be more friendly with reverse proxy senarios.'
    - version: 1.16.0
      date: 2019-03-25
      changes:
        - 'Upgraded HandBrake to version 1.2.2.'
        - 'Upgraded libva to version 2.4.0.'
        - 'Upgraded Intel Media SDK to version 18.4.1.'
        - 'Upgraded Intel Media Driver to version 18.4.1.'
        - 'Use baseimage based on Alpine Linux 3.9.'
        - 'The number of watch folders is now configurable.'
        - 'The root output directory used by the automatic video converter is now configurable.'
        - 'Added hook invoked after all files in a watch folder are processed.'
    - version: 1.15.1
      date: 2019-02-12
      changes:
        - 'Fixed issue where Intel QSV would not be setup properly when its associated Linux devices where having different owners.'
    - version: 1.15.0
      date: 2019-01-14
      changes:
        - 'Upgraded HandBrake to version 1.2.0.'
        - 'The automatic video converter now creates the output folder just before moving the video.'
    - version: 1.14.11
      date: 2018-12-10
      changes:
        - 'Fixed issue where libraries required to use Intel QSV would not be found.'
    - version: 1.14.10
      date: 2018-12-10
      changes:
        - 'Fixed issues related to usage of QSV on recent processors:'
        - '2:Added Intel Media driver version 18.3.0.'
        - '2:Upgraded Intel VAAPI driver to version 2.3.0.'
        - '2:Upgraded to Intel Media SDK to version 18.3.1.'
        - '2:Upgraded libva to version 2.3.0.'
        - '2:By default, the new Intel Media driver is now used.'
        - '2:For processors not supported by the Intel Media driver, use the Intel VAAPI driver.'
    - version: 1.14.9
      date: 2018-11-12
      changes:
        - 'The automatic video converter now processes older files first.'
        - 'Fixed an issue where the automatic video converter would fail to start when `USER_ID` is set to `0`.'
        - 'Do not setup supplementary group if device for Intel QSV is already accessible.'
        - 'Added a new log message for a scenario where Intel QSV would not work.'
    - version: 1.14.8
      date: 2018-09-19
      changes:
        - 'Now using baseimage v3.5.1, which brings the following changes:'
        - '2:Updated installed packages to get latest security fixes.'
    - version: 1.14.7
      date: 2018-09-11
      changes:
        - 'Upgraded to HandBrake version 1.1.2.'
        - 'Fixes to the automatic video converter:'
        - '2:Gracefully handle the case where the pre-conversion hook removes the source video file.'
        - '2:Skip unreadable files.'
        - '2:Drop root privileges at start.'
        - '2:Better handling of unexisting cache files.'
    - version: 1.14.6
      date: 2018-07-30
      changes:
        - 'Fixed an issue where the automatic video converter would fail to convert video with multiple titles.'
        - 'Make sure to apply the `HANDBRAKE_DEBUG` environment variable to the automatic video converter.'
    - version: 1.14.5
      date: 2018-07-19
      changes:
        - 'A video being converted is now written to a temporary directory before being moved to its final location.'
    - version: 1.14.4
      date: 2018-07-17
      changes:
        - 'Fixed an issue where HandBrake could crash while encoding a video using x264.'
    - version: 1.14.3
      date: 2018-07-16
      changes:
        - 'Added support for debug images.'
    - version: 1.14.2
      date: 2018-07-13
      changes:
        - 'Upgraded HandBrake to version 1.1.1.'
        - 'Reduced the size of the container image.'
    - version: 1.14.1
      date: 2018-07-12
      changes:
        - 'Fixed an issue where the automatic video converter would not be able to access the device required to enable Intel Quick Sync Video hardware-accelerated encoding.'
    - version: 1.14.0
      date: 2018-07-09
      changes:
        - 'Added support for Intel Quick Sync Video hardware-accelerated encoding.'
        - 'Now using baseimage v3.4.0, which is based on Alpine Linux 3.8.'
        - 'Fixed issue where selecting a different video encoder would result in incorrect video preset selection.'
        - 'Fixed an issue where the automatic video converter would choose an incorrect output subfolder when `SAME_AS_SRC` is used.'
        - 'Fixed an issue where the automatic video converter, during source cleanup, would try to remove the watch folder itself.'
        - 'Fixed an issue where the automatic video converter would choose an incorrect output filename when the source is a DVD/Blu-Ray folder.'
    - version: 1.13.5
      date: 2018-06-18
      changes:
        - 'Fixed nightly build.'
    - version: 1.13.4
      date: 2018-06-11
      changes:
        - 'Fixed nightly build.'
    - version: 1.13.3
      date: 2018-05-21
      changes:
        - 'Moved the HandBrake debug log under the proper directory.'
        - 'Fixed the nightly build.'
    - version: 1.13.2
      date: 2018-05-09
      changes:
        - 'Fixed issue where handling DVD structure would cause a crash.'
    - version: 1.13.1
      date: 2018-04-26
      changes:
        - 'Improved fix for FLAC encoder crash.'
    - version: 1.13.0
      date: 2018-04-09
      changes:
        - 'Upgraded HandBrake to version 1.1.0.'
    - version: 1.12.0
      date: 2018-03-22
      changes:
        - 'Added pre-conversion hook for the automatic video converter.'
        - 'Added support for creation of image based on the latest HandBrake development code.'
        - 'Switched to a baseimage based on Alpine Linux 3.7.'
    - version: 1.11.5
      date: 2018-03-02
      changes:
        - 'Now using baseimage v3.3.4, which brings the following changes (since last used version):'
        - '2:Make sure the log monitor is started after the X server.'
        - '2:Fixed an issue where the log monitor `yad` target would use XDG folders of the application.'
        - '2:Fixed issue where log monitor states were not cleared during container startup.'
    - version: 1.11.4
      date: 2018-03-01
      changes:
        - 'Since HandBrake doesn''t work well with ffmpeg, reverted to libav.'
        - 'Thus, the FLAC encoder crash has been fixed in libav instead.'
        - 'Make sure the main window is always visible in background.'
    - version: 1.11.3
      date: 2018-02-13
      changes:
        - 'Fixed an issue where encoding audio to FLAC would cause a crash.'
        - 'Use AAC encoder from libavcodec.'
        - 'Fixed an issue where automatic conversion of a multi-titles medias would produce only the first one.'
        - 'Improved logging of the automatic video converter while processing multi-titles medias.'
    - version: 1.11.2
      date: 2018-02-03
      changes:
        - 'Now using baseimage v3.3.2, which brings the following changes:'
        - '2:Restored timezone support in Alpine Linux images with glibc.'
        - '2:Fixed issue in `add-pkg` helper where a package could be incorrectly detected as installed.'
    - version: 1.11.1
      date: 2018-01-30
      changes:
        - 'Now using baseimage v3.3.1, which brings the following changes:'
        - '2:Adjusted the way some ressources are accessed to better support reverse proxy to the container.'
    - version: 1.11.0
      date: 2018-01-22
      changes:
        - 'Now using baseimage v3.3.0, which brings the following changes (since last used version):'
        - '2:For Alpine Linux images with glibc, automatically update dynamic linker''s cache after new libraries are installed.'
        - '2:Fixed the LANG environment variable not being set properly.'
        - '2:Added the ability to automatically install a CJK (Chinese/Japanese/Korean) font.'
    - version: 1.10.0
      date: 2018-01-18
      changes:
        - 'Added support for multiple watch folders.'
        - 'Added environment variable to set the interval at which the automatic video converter checks for new files.'
        - 'Source file and HandBrake preset name are now passed to the post hook script.'
    - version: 1.9.4
      date: 2018-01-11
      changes:
        - 'Now using baseimage v3.2.2, which brings the following changes (since last used version):'
        - '2:Upgraded S6 overlay to version 1.21.2.2.'
        - '2:Upgraded glibc to version 2.26 (Alpine Linux glibc images).'
        - '2:Adjusted the way ownership of /config is taken to better support cases where the folder is mapped to a network share.'
        - 'Small adjustment to the way ownership of files are taken.'
    - version: 1.9.3
      date: 2017-12-12
      changes:
        - 'Now using baseimage v3.1.4, which brings the following changes:'
        - '2:Set 2 worker processes for nginx.'
    - version: 1.9.2
      date: 2017-11-20
      changes:
        - 'Now using baseimage v3.1.3, which brings the following changes:'
        - '2:Upgraded S6 overlay to version 1.21.2.1.'
        - 'Better output of automated conversions: encoding progress now seen in container''s log, while detailed output is redirected to a log file.'
    - version: 1.9.1
      date: 2017-11-07
      changes:
        - 'Now using baseimage v3.1.2, which brings the following changes (from last used version):'
        - '2:Fixed an issue where a self-disabled service could be restarted.'
        - '2:Upgraded S6 overlay to version 1.21.2.0.'
        - '2:Use a more efficient way to monitor status files.'
    - version: 1.9.0
      date: 2017-10-29
      changes:
        - 'Now using baseimage v3.1.0, which brings the following changes:'
        - '2:Upgraded S6 overlay to version 1.21.1.1.'
        - '2:Enhanced integration of service dependencies functionality.'
        - '2:Added a simple log monitor.'
        - '2:Fixed race condition where container''s exit code would not be the expected one.'
        - '2:Fixed issue where application''s GUI fails to displayed when accessing it through the web interface via standard ports 80/443.'
    - version: 1.8.0
      date: 2017-10-09
      changes:
        - 'Now using baseimage v3.0.2, which brings the following changes:'
        - '2:Better support for service dependencies.'
        - '2:Added support for secure access to the application''s GUI.'
    - version: 1.7.0
      date: 2017-09-18
      changes:
        - 'Added support for optical drive(s) access.'
        - 'Removed some useless shortcuts in the video source selection window.'
    - version: 1.6.1
      date: 2017-09-08
      changes:
        - 'Now using baseimage v2.0.8, which brings the following changes (from last used version):'
        - '2:Fixed timezone support on alpine-glibc images.'
        - '2:Fixed duplicated entries in /etc/passwd and /etc/group that were created after a restart of the container.'
    - version: 1.6.0
      date: 2017-08-16
      changes:
        - 'Added libdvdcss to allow reading of encrypted DVD video files.'
    - version: 1.5.9
      date: 2017-08-14
      changes:
        - 'Now using baseimage v2.0.6, which brings the following changes:'
        - '2:Upgraded S6 overlay to version 1.20.0.0.'
    - version: 1.5.8
      date: 2017-08-12
      changes:
        - 'Fixed conversion of videos containing multiple titles.'
    - version: 1.5.7
      date: 2017-07-31
      changes:
        - 'Now using baseimage v2.0.5, which brings the following changes (from last used version):'
        - '2:Clear the environment of the container during startup.'
        - '2:Clear the /tmp folder during startup.'
        - '2:Cleanly terminate the X server when container is restarted/stopped.'
        - '2:Improved robustness of X server starting process.'
        - '2:Removed unneeded files from the image.'
    - version: 1.5.6
      date: 2017-07-27
      changes:
        - 'Watch folder: recursively remove empty directories.'
    - version: 1.5.5
      date: 2017-07-27
      changes:
        - 'Now using baseimage v2.0.3, which brings the following changes:'
        - '2:Improved robustness of the X server starting process.'
    - version: 1.5.4
      date: 2017-07-26
      changes:
        - 'Watch folder: properly support video discs (ISO files, DVD/Blu-ray folders).'
        - 'Watch folder: when removing empty folders, ignore the watch folder itself.'
        - 'Watch folder: make sure to abort if destination file already exists.'
    - version: 1.5.3
      date: 2017-07-25
      changes:
        - 'Fixed HandBrake CLI crash that was occuring when working with ISO files or DVD folders.'
        - 'Small adjustments to the default configuration file.'
    - version: 1.5.2
      date: 2017-07-23
      changes:
        - 'Now using baseimage v2.0.2, which brings the following changes:'
        - '2:Proper VNC port is exposed.'
    - version: 1.5.1
      date: 2017-07-18
      changes:
        - 'Now using baseimage v2.0.1, which brings the following changes:'
        - '2:Internal enhancements.'
        - '2:Clean temporary files left by npm.'
    - version: 1.5.0
      date: 2017-07-17
      changes:
        - 'Now using baseimage v2.0.0, which brings the following changes:'
        - '2:Various internal enhancements.'
        - '2:Fixed the way a service waits for another one.'
        - 'Watch folder: ignore hidden files and folders.'
        - 'Watch folder: adjusted the way empty folders are removed.'
    - version: 1.4.0
      date: 2017-07-04
      changes:
        - 'Watch folder: Make sure to respect the configured umask.'
        - 'Now using baseimage v1.5.0, which brings the following changes:'
        - '2:Added the UMASK environment variable to control how file permissions are set for newly created files.'
        - '2:Added the X11VNC_EXTRA_OPTS environment variable used to pass additional arguments to the x11vnc server.'
        - '2:By default, activate auto-scaling of application''s window.'
        - '2:Applied latest Alpine Linux security updates.'
    - version: 1.3.3
      date: 2017-06-30
      changes:
        - 'Watch folder: Added handling of environment variable AUTOMATED_CONVERSION_OUTPUT_SUBDIR, which allows customization of the output location of automatically converted videos..'
        - 'The default source folder is now /storage.'
    - version: 1.3.2
      date: 2017-06-27
      changes:
        - 'Watch folder: also process files in subfolders.'
    - version: 1.3.1
      date: 2017-06-22
      changes:
        - 'Now using baseimage v1.4.3, which brings the following changes:'
        - '2:Updated Alpine Linux to version 3.6.2.'
    - version: 1.3.0
      date: 2017-06-21
      changes:
        - 'Now using baseimage v1.4.2, which brings the following changes (from last used version):'
        - '2:Switched to Alpine Linux 3.6.'
        - '2:Associate the application''s icon to a unique version to avoid browser cache issues.'
        - '2:Fixed prefix of some service related messages.'
        - '2:Added support for supplying supplementary groups of the application.'
        - '2:Improved process startup and shutdown.'
        - '2:When container is stopped or restarted, processes are now terminated gracefully and in proper order. This allow the GUI application to execute its termination routine.'
        - '2:No more error messages when container is stopped or restarted.'
    - version: 1.2.0
      date: 2017-05-31
      changes:
        - 'Added support for post-conversion hook.'
    - version: 1.1.4
      date: 2017-05-30
      changes:
        - 'Now using baseimage v1.3.2, which brings the following changes:'
        - '2:Fixed password modal window not showing up when required.'
    - version: 1.1.3
      date: 2017-05-26
      changes:
        - 'Watch folder: Fixed issue where, after a first successful conversion, conversion of next available video files would not start.'
        - 'Renamed the ''Watch Folder'' service to ''Automatic Video Converter''.'
    - version: 1.1.2
      date: 2017-05-24
      changes:
        - 'Watch folder: Changed the way files being transferred are detected. Method used previously was not working properly in all cases.'
    - version: 1.1.1
      date: 2017-05-24
      changes:
        - 'Watch folder: temporarily skip files being accessed/transferred.'
        - 'Watch folder: improved robustness.'
    - version: 1.1.0
      date: 2017-05-23
      changes:
        - 'Watch folder: properly support filenames containing spaces.'
        - 'Watch folder: added support for symbolic links.'
        - 'HandBrake debug can now be enabled via the HANDBRAKE_DEBUG environment variable.'
        - 'Take ownership of the `/output` folder.'
        - 'Added the ability to remove video source files from the watch folder after successfully conversion.'
    - version: 1.0.1
      date: 2017-05-18
      changes:
        - 'The watch folder is now monitored without inotify for better compatibility.'
    - version: 1.0.0
      date: 2017-05-18
      changes:
        - 'Initial release.'

container:
  storage_permissions: ro

  # Environment variables.
  environment_variables:
    - name: HANDBRAKE_DEBUG
      description: >-
        Setting this to `1` enables HandBrake debug logging for both the GUI and
        the automatic video converter.  For the latter, the increased verbosity
        is reflected in `/config/log/hb/conversion.log` (container path).  For
        the GUI, log messages are sent to `/config/log/hb/handbrake.debug.log`
        (container path).  **NOTE**: When enabled, a lot of information is
        generated and the log file will grow quickly.  Make sure to enable this
        temporarily and only when needed.
      type: public
      default: 0
    - name: HANDBRAKE_GUI
      description: >-
        Setting this to `1` enables the HandBrake GUI, `0` disables it.
      type: public
      default: 1
      unraid_template:
        title: "HandBrake GUI State"
        description: >-
          Setting this to 1 enables the HandBrake GUI, 0 disables it.
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION
      description: >-
        Setting this to `1` enables the automatic video converter, `0` disables
        it.
      type: public
      default: 1
      unraid_template:
        title: "Automatic Video Converter: State"
        description: >-
          Setting this to 1 enables the automatic video converter, 0 disables
          it.
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_PRESET 
      description: >-
        HandBrake preset used by the automatic video converter.  Identification
        of a preset must follow the format `<CATEGORY>/<PRESET NAME>`.  See the
        [Automatic Video Conversion](#automatic-video-conversion) section for
        more details.
      type: public
      default: "General/Very Fast 1080p30"
      unraid_template:
        title: "Automatic Video Converter: Preset"
        description: >-
          Preset used by the automatic video converter.  Identification of the
          preset must follow the format 'CATEGORY/PRESET NAME'.  Name of all
          available presets can be seen via the HandBrake GUI.
        display: always
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_FORMAT
      description: >-
        Video container format used by the automatic video converter for output
        files.  This is typically the video filename extension.  See the
        [Automatic Video Conversion](#automatic-video-conversion) section for
        more details.
      type: public
      default: mp4
      unraid_template:
        title: "Automatic Video Converter: Format"
        description: >-
          Video container format used by the automatic video converter for
          output files.  This is typically the video filename extension.
        display: always
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_KEEP_SOURCE
      description: >-
        When set to `0`, a video that has been successfully converted is removed
        from the watch folder.
      type: public
      default: 1
      unraid_template:
        title: "Automatic Video Converter: Keep Source Files"
        description: >-
          Set to 0 to remove successfully converted videos from the watch folder, 1 to keep them.
        display: always
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_VIDEO_FILE_EXTENSIONS
      description: >-
        Space-separated list of file extensions to be considered as video files.
        By default, this list is empty, meaning that the automatic video
        converter will let HandBrake automatically detects if a file, no matter
        its extension, is a video or not (note that extensions defined by the
        `AUTOMATED_CONVERSION_NON_VIDEO_FILE_EXTENSIONS` environment variable
        are always considered as non-video files).  Normally, this variable
        doesn't need to be set.  Usage of this variable is useful when only
        specific video files need to converted.
      type: public
      unraid_template:
        title: "Automatic Video Converter: Video File Extensions"
        description: >-
          Space-separated list of file extensions to be considered as video
          files.  By default, this list is empty, meaning that the automatic
          video converter will let HandBrake automatically detects if a file,
          no matter its extension, is a video or not (note that extensions
          defined by the Non-Video File Extensions list are always considered as
          non-video files).  Normally, this variable doesn't need to be set.
          Usage of this variable is useful when only specific video files need
          to converted.
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_NON_VIDEO_FILE_ACTION
      description: >-
        When set to `ignore`, a non-video file found in the watch folder is
        ignored.  If set to `copy`, a non-video file is copied as-is to the
        output folder.
      type: public
      default: ignore
      unraid_template:
        title: "Automatic Video Converter: Non-Video File Action"
        description: >-
          Set to "ignore" to ignore non-video files from the watch folder, or
          set to "copy" to copy them as-is to the output folder.
        display: always
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_NON_VIDEO_FILE_EXTENSIONS
      description: >-
        Space-separated list of file extensions to be considered as not being
        videos.  Most non-video files are properly rejected by HandBrake.
        However, some files, like images, are convertible by HandBrake even if
        they are not video files.
      type: public
      default: jpg jpeg bmp png gif txt nfo
      unraid_template:
        title: "Automatic Video Converter: Non-Video File Extensions"
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_OUTPUT_DIR
      description: >-
        Root directory, inside the container, where converted videos should be
        written.  **NOTE**: Make sure a volume mapping for this directory is
        defined when creating the container.
      type: public
      default: /output
      unraid_template:
        title: "Automatic Video Converter: Output directory"
        description: >-
          Root directory, inside the container, where converted videos should be
          written.
        display: always
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_OUTPUT_SUBDIR
      description: >-
        Subdirectory of the output folder into which converted videos should be
        written.  By default, this variable is not set, meaning that videos are
        saved directly into `/output/`.  If `Home/Movies` is set, converted
        videos will be written to `/output/Home/Movies`.  Use the special value
        `SAME_AS_SRC` to use the same subfolder as the source.  For example, if
        the video source file is `/watch/Movies/mymovie.mkv`, the converted
        video will be written to `/output/Movies/`.
      type: public
      unraid_template:
        title: "Automatic Video Converter: Output Subdirectory"
        description: >-
          Subdirectory of the output folder into which converted videos should
          be written.  Leave value empty to save converted videos directly into
          "/output/".  Use the special value "SAME_AS_SRC" to use the same
          subfolder as the source.  For example, if the video source file is
          "/watch/Movies/mymovie.mkv", the converted video will be written to
          "/output/Movies/".  Any other value is considered as the subfolder
          name.  For example, setting the value "Home/Movies" will make
          converted videos to be written to "/output/Home/Movies".
        display: always
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_OVERWRITE_OUTPUT
      description: >-
        Setting this to `1` allows the final destination file to be overwritten if it already exists.
      type: public
      default: 0
      unraid_template:
        title: "Automatic Video Converter: Overwrite Destination"
        description: >-
          Setting this to 1 allows the final destination file to be overwritten if it already exists.
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_SOURCE_STABLE_TIME
      description: >-
        Time (in seconds) during which properties (e.g. size, time, etc) of a
        video file in the watch folder need to remain the same.  This is to
        avoid processing a file that is being copied.
      type: public
      default: 5
      unraid_template:
        title: "Automatic Video Converter: Source File Stable Time"
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_SOURCE_MIN_DURATION
      description: >-
        Minimum title duration (in seconds).  Shorter titles will be ignored. 
        This applies only to video disc sources (ISO file, `VIDEO_TS` folder
        or `BDMV` folder).
      type: public
      default: 10
      unraid_template:
        title: "Automatic Video Converter: Minimum Title Duration"
        description: >-
          Minimum title duration (in seconds).  Shorter titles will be ignored.
          This applies only to video disc sources (ISO file, VIDEO_TS folder or
          BDMV folder).
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_SOURCE_MAIN_TITLE_DETECTION
      description: >-
        Setting this to `1` enables HandBrake main feature title detection to
        try to guess and select the main title.
      type: public
      default: 0
      unraid_template:
        title: "Automatic Video Converter: Main Title Detection"
        description: >-
          Setting this to 1 enables HandBrake main feature title detection to
          try to guess and select the main title.
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_CHECK_INTERVAL
      description: >-
        Interval (in seconds) at which the automatic video converter checks for new files.
      type: public
      default: 5
      unraid_template:
        title: "Automatic Video Converter: Check Interval"
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_MAX_WATCH_FOLDERS
      description: >-
        Maximum number of watch folders handled by the automatic video converter.
      type: public
      default: 5
      unraid_template:
        title: "Automatic Video Converter: Number of Watch Folders"
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_NO_GUI_PROGRESS
      description: >-
        When set to `1`, progress of videos converted by the automatic video converter is not shown in the HandBrake GUI.
      type: public
      default: 0
      unraid_template:
        title: "Automatic Video Converter: Disable Progress in GUI"
        description: >-
          Set to 1 to disable display of the video conversion progress in HandBrake GUI.
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_HANDBRAKE_CUSTOM_ARGS
      description: >-
        Custom arguments to pass to HandBrake when performing a conversion.
      type: public
      unraid_template:
        title: "Automatic Video Converter: Custom HandBrake Arguments"
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_INSTALL_PKGS
      description: >-
        Space-separated list of Alpine Linux packages to install.  This is
        useful when the automatic video converter's hooks require tools not
        available in the container image.  See https://pkgs.alpinelinux.org
        for the list of available Alpine Linux packages.
      type: public
      unraid_template:
        title: "Automatic Video Converter: Install Packages"
        display: advanced
        required: false
        mask: false
    - name: AUTOMATED_CONVERSION_USE_TRASH
      description: >-
        When set to `1`, the automatic video converter uses the trash directory.
        So when the automatic video converter is configured to *not* keep
        sources, it will move them to the trash directory (`/trash` inside the
        container) instead of deleting them.
      type: public
      default: 0
      unraid_template:
        title: "Automatic Video Converter: Use Trash Directory"
        description: >-
          Set to 1 to enable usage of the trash directory. So when the automatic
          video converter is configured to not keep sources, it will move files
          to the trash directory (/trash inside the container) instead of
          deleting them.
        display: advanced
        required: false
        mask: false

  # Volumes
  volumes:
    - container_path: /watch
      host_path_example: "/home/user/HandBrake/watch"
      description: >-
        This is where videos to be automatically converted are located
      permissions: rw
      include_in_quick_start: true
      unraid_template:
        title: Watch Directory
        description: >-
          This is the watch folder of the automatic video converter.  Any video
          copied into this folder will be automatically converted by HandBrake.
        display: always
        required: false
        mask: false
    - container_path: /output
      host_path_example: "/home/user/HandBrake/output"
      description: >-
        This is where automatically converted video files are written.
      permissions: rw
      include_in_quick_start: true
      unraid_template:
        title: Output Directory
        description: >-
          This is the default output folder for converted videos.  Also used by
          the automatic video converter.
        display: always
        required: true
        mask: false
    - container_path: /trash
      host_path_example: "/home/user/HandBrake/trash"
      description: >-
        When trash usage is enabled, this is where the automatic video converter moves
        converted files instead of deleting them.
      permissions: rw
      unraid_template:
        title: Trash Directory
        display: advanced
        required: false
        mask: false

  # Network ports
  ports: []

  # Devices
  devices: []