Ansible Playbooks for yaVDR 0.7

1.1.1 Using vdr, pulseaudio and xorg together

7.1.1 tasks

1. main.yml
   

   ---
   
   - name: apt | install packages
     apt:
       name: '{{ packages }}'
       state: present
       install_recommends: no
       cache_valid_time: 60
   

7.2.1 tasks

1. main.yml
   

   ---
   
   - name: add ppa:graphics-drivers/ppa
     apt_repository:
         repo: 'ppa:graphics-drivers/ppa'
         state: present
         update_cache: yes
     tags:
       - ppa
   
   - name: install nvidia-396 and other required packages
     apt:
       name:
         - nvidia-396
         - nvidia-settings
       state: present
       install_recommends: no
     tags:
       - packages
   

7.3.1 default variables

---
# file: roles/yavdr-common/defaults/main.yml

1. Repositories
   

   You can set a list of package repositories which provide the necessary packages. Feel free to use own PPAs if you need special customization to the VDR and it’s plugins.

   branch: unstable
   repositories:
     - 'ppa:yavdr/main'
     - 'ppa:yavdr/unstable-main'
     - 'ppa:yavdr/{{branch}}-vdr'
     - 'ppa:yavdr/{{branch}}-kodi'
     - 'ppa:yavdr/{{branch}}-yavdr'
   

2. Drivers
   

   Automatically installed drivers can be very useful, but if you know you need a certain driver, you can simply set it’s value to true. If you don’t want a driver to be installed, set it’s value to false.

   drivers:
     sundtek: auto
     ddvb-dkms: auto
   

3. Additional Packages
   

   Add additional packages you would like to have on your installation to this list

   extra_packages:
     - vim
     - tree
     - w-scan
   

4. VDR
   

   This section allows you to set the recording directory, the user and group that runs the vdr and it’s home directory.

   user

   the vdr user name

   group

   the main group for the user vdr

   uid

   the user id for the user vdr

   gid

   the group id for the group vdr

   home

   the home directory for the user vdr

   recdir

   the recording directory used by VDR

   hide_first_recording_level

   let vdr hide the first directory level of it’s recording directory so the content of multiple directories is shown merged together

   safe_dirnames

   replace special characters which are not compatible with Windows file systems and Samba shares

   override_vdr_charset

   workaround for channels with weird EPG encodings, e.g. Sky

   vdr:
       user: vdr
       group: vdr
       uid: 666
       gid: 666
       home: /var/lib/vdr
       recdir: /srv/vdr/video
       hide_first_recording_level: false
       safe_dirnames: true
       override_vdr_charset: false
   

7.3.2 tasks

1. main.yml
   

   ---
   # file: roles/yavdr-common/tasks/main.yml 
   
   - name: basic installation
     block:
           - import_tasks: configure_apt.yml
           - import_tasks: configure_system.yml
           - import_tasks: create_directories.yml
           - import_tasks: create_sudoers.yml
           - import_tasks: standby_support.yml
     tags: [install]
   

   1. Disable default installation of recommended packages
      

      This task prevents apt to automatically install all recommended dependencies for packages:

      ---
      
      - name: apt | prevent automatic installation of recommended packages
        template:
          src: templates/90-norecommends.j2
          dest: /etc/apt/apt.conf.d/90norecommends
      
      

   2. Set up package repositories
      

      - name: add PPAs
        apt_repository:
            repo: '{{ item }}'
            state: present
            update_cache: no
        with_items: '{{ repositories }}'
        tags:
          - ppa
      
      - name: run apt-get dist-upgrade
        apt:
            upgrade: dist
            update_cache: yes
      

   3. Use bash instead of dash
      

      - name: use bash instead of dash
        shell: |
          echo "set dash/sh false" | debconf-communicate
          dpkg-reconfigure -f noninteractive dash
      

   4. create user vdr
      
   5. Disable release-upgrade notifications
      
      1. SOMEDAY move from lineinfile to template
         

         - name: disable release-upgrade notifications
           lineinfile:
             dest: /etc/update-manager/release-upgrades
             backrefs: yes
             state: present
             regexp: '^(Prompt=).*$'
             line: '\1never'
           ignore_errors: yes
           with_first_found:
             - files:
               - /etc/update-manager/release-upgrades
               skip: true
         
         

   6. Install essential packages
      

      - name: apt | install basic packages
        apt:
          name:
            - anacron
            - acl
            - at
            - bash-completion
            #- biosdevname  # caution: may change device names after a minimal installation!
            - debconf-utils
            - linux-firmware
            - psmisc
            - python-jmespath
            - python-kmodpy
            - python-requests
            - python-usb
            - python3-usb
            - software-properties-common
            - ssh
            - wget
            - wpasupplicant
            - usbutils
            - xfsprogs
          state: present
          install_recommends: no
      
      

   7. Install additional packages (user defined)
      

      - name: apt | install extra packages
        apt:
          name: '{{ extra_packages }}'
          state: present
          install_recommends: no
            
      

   8. create directories
      
   9. create sudoers drop-in for vdr
      
   10. basic scripts for standby support
       

       Stop vdr before entering suspend and unload dvb modules, reverse this operation on resume

7.3.3 templates

{{ ansible_managed | comment('c') }}
// Recommends are as of now still abused in many packages
APT::Install-Recommends "0";
APT::Install-Suggests "0";

1. yavdr sudoers drop-in
   

   Allow the vdr user to restart vdr.service and reboot the system

   {{ vdr.user }} ALL=NOPASSWD: /bin/systemctl --no-block restart vdr.service
   {{ vdr.user }} ALL=NOPASSWD: /bin/systemctl --no-block reboot
   

2. suspend hooks
   

   #!/bin/bash
   {{ ansible_managed | comment }}
   
   case $1 in
     pre)
       /bin/systemctl stop vdr
       /usr/local/bin/module-helper -u dvb_core
       ;;
     post)
       # reload rc-core keytables
       [ -x /usr/bin/ir-keytable ] && {
           for remote in $(ir-keytable 2>&1 | grep rc/rc | egrep -o "rc[0-9]{1,}")
           do 
               ir-keytable -a /etc/rc_maps.cfg --sysdev $remote
           done
       }
   
       /usr/local/bin/module-helper -r
       /bin/systemctl start vdr
       ;;
   esac
   
   

3. module-helper
   

   #!/usr/bin/env python3
   # {{ ansible_managed | comment }}
   # based on http://www.e-tobi.net/blog/files/module-helper
   # http://www.e-tobi.net/blog/2010/11/06/squeeze-vdr-teil-9-suspend-to-ram
   # ported to python3 by Alexander Grothe
   #
   # This script resolves linux kernel module dependencies automatically, so only
   # the base module has to be specified (e.g. dvb_core)
   
   import argparse
   import subprocess
   import pickle
   
   dependency_map = {}
   
   
   def find_dependencies(module, dependencies=[]):
       dependencies.append(module)
       if module in dependency_map:
           for dependency in dependency_map[module]:
               find_dependencies(dependency, dependencies)
       return dependencies
   
   
   def build_module_dependency_map():
       with subprocess.Popen(['lsmod'],
                             stdout=subprocess.PIPE,
                             universal_newlines=True
                             ) as p:
           for line in p.stdout:
               values = line.split()
               if len(values) > 3:
                   #print("module {} depends on {}".format(values[0], values[3]))
                   dependency_map[values[0]] = values[3].split(',')
   
   
   def run_command_on_module_list(command, module_list):
       for module in module_list:
           cmd = [command, module]
           subprocess.call(cmd)
   
   
   def create_argparser():
       parser = argparse.ArgumentParser(description="load or unload modules")
       group = parser.add_mutually_exclusive_group()
       group.add_argument('-u', '--unload', metavar='MODULE', nargs='+',
                          help='unload modules')
       group.add_argument('-r', '--reload', action='store_true',
                          help='reload modules')
       parser.add_argument('-t', '--temp-file', nargs='?',
                           default='/tmp/modules.list',
                           help='''store names of unloaded modules in a file,
                                 default location is /tmp/modules.list''')
       return parser
   
   if __name__ == '__main__':
       parser = create_argparser()
       args = parser.parse_args()
       if args.unload:
           build_module_dependency_map()
           all_modules = []
           for module in args.unload:
               all_modules.extend(find_dependencies(module))
           all_modules.reverse()
           try:
               with open(args.temp_file, 'wb') as f:
                   pickle.dump(all_modules, f)
               run_command_on_module_list('rmmod', all_modules)
           except Exception as e:
               print(e)
               pass
       elif args.reload:
           with open(args.temp_file, 'rb') as f:
               all_modules = pickle.load(f)
           run_command_on_module_list('modprobe', all_modules)
       else:
           parser.print_help()
   

7.4.1 variables

first_run: False

7.4.2 tasks

1. main.yml
   

   - name: get information about usb and pci hardware and loaded kernel modules
     hardware_facts:
       usb: True
       pci: True
       modules: True
       gpus: True
       acpi_power_modes: True
     tags:
       - always
   
   - debug:
       var: '{{ item }}'
       verbosity: 1
     with_items:
       - usb
       - pci
       - gpus
       - modules
       - acpi_power_modes
       - nvidia_detected
       - intel_detected
       - amd_detected
       - virtualbox_detected
   
   - name: get detailed PCI device information
     pci_facts:
     tags:
       - always
   
   - debug:
       var: pci_devices
       verbosity: 1
   
   - name: known vdr output plugins
     set_fact:
       vdr_output_plugins:    
         - softhddevice
         - xineliboutput
         - xine
   

7.5.1 tasks

1. install the basic vdr packages
   

   ---
   # file: roles/vdr/tasks/main.yml
   
   - name: apt | install basic vdr packages
     apt:
       name:
         - vdr
         - vdrctl
         - vdr-plugin-dbus2vdr
       state: present
       install_recommends: no
   

2. Add svdrp/svdrp-disc to /etc/services
   

   - name: add svdrp and svdrp-disc to /etc/services
     lineinfile:
       dest: /etc/services
       state: present
       line: "{{ item }}"
     with_items:
       - "svdrp            6419/tcp"
       - "svdrp-disc       6419/udp"
   

3. Set up the recording directory for the vdr user
   

   - name: create vdr recdir
     file:
       state: directory
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
       mode: 0775
       dest: '{{ vdr.recdir }}'
   
   - name: set option to use hide-first-recording-level patch
     blockinfile:
       dest: /etc/vdr/conf.d/04-vdr-hide-first-recordinglevel.conf
       create: true
       state: "{{ 'present' if vdr.hide_first_recording_level else 'absent' }}"
       block: |
         [vdr]
         --hide-first-recording-level
   
   - name: create local dir in recdir
     file:
       state: directory
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
       mode: '0775'
       dest: '{{ vdr.recdir }}/local'
     when:
       vdr.hide_first_recording_level
   
   # TODO: set recdir, user etc. in /etc/vdr/conf.d/
   

4. Install additional vdr plugins
   

   The additional plugins to install can be set in the variable {{vdr_plugins}} in the group variables

   - name: apt | install additional vdr plugins
     apt:
       name: '{{ vdr_plugins | default([]) }}'
       state: present
       install_recommends: no
     notify: [ 'Restart VDR' ]
   

5. copy vdr configuration files (if they don’t exist yet)
   

   - name: ensure vdr is stopped
     systemd:
       name: vdr.service
       state: stopped
     notify: [ 'Start VDR' ]
   
   - name: "vdr configuration | copy remote.conf if it doesn't exist yet"
     copy:
       src: files/remote.conf
       dest: '{{ vdr.confdir }}/remote.conf'
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
       mode: 0644
       force: no
   
   - name: "vdr configuration | copy keymacros.conf if it doesn't exist yet"
     copy:
       src: files/keymacros.conf
       dest: '{{ vdr.confdir }}/keymacros.conf'
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
       mode: 0644
       force: no
   

6. start vdr after network-online.target
   

   - name: create directory for vdr.service systemd drop-in files
     file:
       dest: '{{ item }}'
       state: directory
     with_items:
       - "/etc/systemd/system/vdr.service.d/"
   
   - name: systemd-drop-in | start vdr.service after network-online.target
     template:
       src: templates/systemd/network-online.j2
       dest: /etc/systemd/system/vdr.service.d/network-online.conf
   

7.5.2 templates

[Unit]
After=network-online.target

7.5.3 files

1. remote.conf
   

   LIRC.Up KEY_UP
   LIRC.Down KEY_DOWN
   LIRC.Menu KEY_MENU
   LIRC.Ok KEY_OK
   LIRC.Back KEY_ESC
   LIRC.Left KEY_LEFT
   LIRC.Right KEY_RIGHT
   LIRC.Red KEY_RED
   LIRC.Green KEY_GREEN
   LIRC.Yellow KEY_YELLOW
   LIRC.Blue KEY_BLUE
   LIRC.0 KEY_0
   LIRC.1 KEY_1
   LIRC.2 KEY_2
   LIRC.3 KEY_3
   LIRC.4 KEY_4
   LIRC.5 KEY_5
   LIRC.6 KEY_6
   LIRC.7 KEY_7
   LIRC.8 KEY_8
   LIRC.9 KEY_9
   LIRC.Info KEY_INFO
   LIRC.Play KEY_PLAY
   LIRC.Pause KEY_PAUSE
   LIRC.Play/Pause KEY_PLAYPAUSE
   LIRC.Stop KEY_STOP
   LIRC.Record KEY_RECORD
   LIRC.FastFwd KEY_FASTFORWARD
   LIRC.FastRew KEY_REWIND
   LIRC.Next KEY_NEXT
   LIRC.Prev KEY_BACK
   LIRC.Power KEY_POWER2
   LIRC.Channel+ KEY_CHANNELUP
   LIRC.Channel- KEY_CHANNELDOWN
   LIRC.PrevChannel KEY_PREVIOUS
   LIRC.Volume+ KEY_VOLUMEUP
   LIRC.Volume- KEY_VOLUMEDOWN
   LIRC.Mute KEY_MUTE
   LIRC.Subtitles KEY_SUBTITLE
   LIRC.Schedule KEY_EPG
   LIRC.Channels KEY_CHANNEL
   LIRC.Commands KEY_FAVORITES
   LIRC.Audio KEY_MODE
   LIRC.Timers KEY_TIME
   LIRC.Recordings KEY_PVR
   LIRC.Setup KEY_SETUP
   LIRC.User0 KEY_TEXT
   LIRC.User1 KEY_PROG1
   LIRC.User2 KEY_PROG2
   LIRC.User3 KEY_PROG3
   LIRC.User4 KEY_PROG4
   LIRC.User5 KEY_AUDIO
   LIRC.User6 KEY_VIDEO
   LIRC.User7 KEY_IMAGES
   LIRC.User8 KEY_FN
   LIRC.User9 KEY_SCREEN
   
   XKeySym.Up         Up
   XKeySym.Down       Down
   XKeySym.Menu       Home
   XKeySym.Menu       Tab
   XKeySym.Menu       KP_Home
   XKeySym.Ok         Return
   XKeySym.Ok         KP_Enter
   XKeySym.Back       BackSpace
   XKeySym.Back       KP_Separator
   XKeySym.Left       Left
   XKeySym.Right      Right
   XKeySym.Up         KP_Up
   XKeySym.Down       KP_Down
   XKeySym.Left       KP_Left
   XKeySym.Right      KP_Right
   XKeySym.Red        F1
   XKeySym.Green      F2
   XKeySym.Yellow     F3
   XKeySym.Blue       F4
   XKeySym.0          0
   XKeySym.1          1
   XKeySym.2          2
   XKeySym.3          3
   XKeySym.4          4
   XKeySym.5          5
   XKeySym.6          6
   XKeySym.7          7
   XKeySym.8          8
   XKeySym.9          9
   XKeySym.0          KP_0
   XKeySym.1          KP_1
   XKeySym.2          KP_2
   XKeySym.3          KP_3
   XKeySym.4          KP_4
   XKeySym.5          KP_5
   XKeySym.6          KP_6
   XKeySym.7          KP_7
   XKeySym.8          KP_8
   XKeySym.9          KP_9
   XKeySym.Info       End
   XKeySym.Info       KP_End
   XKeySym.Pause      F9
   XKeySym.FastFwd    F6
   XKeySym.FastRew    F5
   XKeySym.Power      Pause
   XKeySym.Volume+    F12
   XKeySym.Volume-    F11
   XKeySym.Volume+    KP_Add
   XKeySym.Volume-    KP_Subtract
   XKeySym.Mute       F10
   XKeySym.User1      F5
   XKeySym.User2      F6
   XKeySym.User3      F7
   XKeySym.User4      F8
   XKeySym.User5      Print
   XKeySym.User6      Scroll_Lock
   XKeySym.User7      Insert
   XKeySym.User8      KP_Divide
   XKeySym.User9      KP_Multiply
   XKeySym.Audio      Menu
   XKeySym.Channel+   Prior
   XKeySym.Channel-   Next
   XKeySym.Channel+   KP_Prior
   XKeySym.Channel-   KP_Next
   XKeySym.Volume+    XF86AudioRaiseVolume
   XKeySym.Volume-    XF86AudioLowerVolume
   XKeySym.Mute       XF86AudioMute
   XKeySym.Stop       XF86AudioStop
   XKeySym.Play/Pause  XF86AudioPlay
   XKeySym.Prev       XF86AudioPrev
   XKeySym.Next       XF86AudioNext
   

2. keymacros.conf
   

   # Remote control key macros for VDR
   #
   # Format:
   #
   # macrokey  key1 key2 key3...
   # macrokey  @plugin key1 key2 key3...
   #
   # See man vdr(5)
   
   Red       Recordings
   Green     Schedule
   Yellow    Info
   Blue      Timers
   User0     @osdteletext
   
   
   

7.6.1 default variables

install_avahi: true

7.6.2 tasks

---
# this playbook sets up network services for a yaVDR installation

- name: apt | install packages for network services
  apt:
      name:
          - avahi-daemon
          - avahi-utils
          #- biosdevname # caution: this may change device names after a minimal installation!
          - ethtool
          - nfs-common
          - vdr-addon-avahi-linker
          - wakeonlan
      state: present
      install_recommends: no

# Does this really work? We need a way to check if an interface supports WOL - Python Skript?
# - name: check WOL capabilities of network interfaces
#   shell: 'ethtool {{ item }} | grep -Po "(?<=Supports\sWake-on:\s).*$"'
#   register: wol
#   with_items: '{% for interface in ansible_interfaces if interface != 'lo' and interface != 'bond0' %}'

- name: restart autofs if running
  systemd:
    name: autofs
    state: restarted
    enabled: yes
    masked: no

- name: ensure autofs is running
  systemd:
    name: autofs
    state: started
    enabled: yes
    masked: no

- name: restart avahi-linker if running
  systemd:
    name: avahi-linker
    state: restarted
    enabled: yes
    masked: no

- name: start avahi-linker
  systemd:
    name: avahi-linker
    state: started
    enabled: yes
    masked: no

- name: enable and start additional services for avahi-linker
  systemd:
    name: '{{ item }}'
    state: started
    enabled: yes
    masked: no
  with_items:
    - vdr-net-monitor
    - vdr-update-monitor
    - prevent-umount-on-pause

7.7.1 tasks

---
# file: roles/vdr-plugin-menuorg/tasks/main.yml

- name: apt | install vdr-plugin-menuorg and yavdr-i18n
  apt:
    name:
      - vdr-plugin-menuorg 
      - yavdr-i18n
    state: present
    install_recommends: no

- name: create /var/lib/vdr/plugins/menuorg.xml
  template:
    src: templates/menuorg.xml.j2
    dest: /var/lib/vdr/plugins/menuorg.xml

7.7.2 templates

<?xml version="1.0" encoding="UTF-8"?>                                                                                                                      
{{ ansible_managed | comment('xml') }}
<!--
This is the config file for the Menuorg plug-in.
See /usr/share/doc/vdr-plugin-menurg for examples and a full
description of the config file format.
-->
<menus>
    <system name="Schedule" />
    <system name="Channels" />
    <system name="Timers" />
    <system name="Recordings" />
    <plugin name="tvguide" />
    <command name="Kodi" execute="frontend-dbus-send switchto kodi" />
    <plugin name="desktop" />
    <menu name="{{ 'VDR Plugins' | translate }}">
        <plugin name="epgsearchonly" />
        <plugin name="quickepgsearch" />
        <plugin name="conflictcheckonly" />
        <plugin name="markad" />
        <plugin name="recsearch" />
        <plugin name="undelete" />
        <plugin name="radio" />
        <plugin name="osd2web" />
    </menu>
    <menu name="{{ 'System' | translate }}">
         <menu name="{{ 'Commands' | translate }}">
               <command name="{{ "Safely remove usb mass storage" | translate }}" confirm="yes" execute="/usr/bin/vdr-mounter --unmount-all &amp;> /dev/null" />
               <command name="{{ "Update vdr recordings list" | translate }}" execute="/usr/bin/vdr-dbus-send /Recordings recording.Update &amp;> /dev/null " />
               <command name="{{ "Restart VDR" |translate }}" confirm="yes" execute="sudo /sbin/initctl restart vdr" />
               <command name="{{ "Reboot system"| translate }}" confirm="yes" execute="/usr/bin/at now -M -f /usr/bin/vdr-reboot" />
               <command name="{{ "Shutdown system" | translate }}" execute="/usr/bin/lircd2uinput-send KEY_POWER2 &amp;> /dev/null &amp; " />
         </menu>
         <system name="Setup" />
         <plugin name="femon" />
         <plugin name="devstatus" />
         <plugin name="epg2vdr" />
         <plugin name="scraper2vdr" />
         <plugin name="sndctl" />
         <plugin name="suspendoutput" />
         <plugin name="recstatus" />
         <plugin name="dynamite" />
         <plugin name="noepgmenu" />
         <plugin name="systeminfo" />
         <plugin name="filebrowser" />
         <plugin name="pin" />
         <plugin name="pulsecontrol" />
         <plugin name="softhddevice" />
         </menu>
    <system name="Commands" />
</menus>

7.8.1 TODO avahi-services für NFS beim Stoppen des nfs-kernel-servers depublizieren, beim Start wieder announcen

7.8.2 tasks

---

- name: install nfs server packages
  apt:
    name:
      - nfs-kernel-server
      - nfs-common
    state: present
    install_recommends: no

- name: create /etc/exports
  template:
    src: templates/nfs-exports.j2
    dest: /etc/exports
  notify: [ 'Restart NFS Kernel Server' ]

- name: populate /etc/avahi/services
  template:
    src: templates/avahi/service.j2
    dest: '/etc/avahi/services/yavdr-{{ item.key }}.service'
  with_dict: '{{ media_dirs }}'

7.8.3 templates

1. /etc/exports
   

   /srv *(rw,fsid=0,sync,no_subtree_check,all_squash,anongid={{ vdr.gid }},anonuid={{ vdr.uid }})
   {% for name, path in media_dirs.items() | list %}
   {{ path }} *(rw,fsid={{ loop.index }},sync,no_subtree_check,all_squash,anongid={{ vdr.gid }},anonuid={{ vdr.uid }}{{ ',insecure' if nfs.insecure else '' }})
   {% endfor %}
   

2. avahi services
   

   <?xml version="1.0" standalone='no'?>
   <!DOCTYPE service-group SYSTEM "avahi-service.dtd">
   <service-group>
   <name replace-wildcards="yes">{{ item.key|capitalize }} on %h</name> ## Name
   <service>
          <type>_nfs._tcp</type>
          <port>2049</port>
          <txt-record>path={{ item.value }}</txt-record> ## path to shared Folder
          <txt-record>subtype={{ 'vdr' if item.key == 'recordings' else item.key }}</txt-record> ## subtype
   </service>
   </service-group>
   

7.9.1 default variables

lircd0_socket: /var/run/lirc/lircd0

7.9.2 tasks

---
# This role is used to set up the yaVDR remote control configuration.

- name: apt | install packages for remote support
  apt:
    name:
      - yavdr-remote
      - lirc
    state: present
  tags:
    - packages

- name: add systemd drop-in for lircd to use lircd2uinput
  block:
    - name: create directory /etc/systemd/system/lircd.service.d/
      file:
        path: /etc/systemd/system/lircd.service.d/
        state: directory
    - name: expand template for /etc/systemd/system/lircd.service.d/lircd2uinput.conf
      template:
        src: templates/lircd.service.d/lircd2uinput.conf.j2
        dest: /etc/systemd/system/lircd.service.d/lircd2uinput.conf
  tags:
    - config

- name: stop, mask and disable lircd.socket, lircd.service, lircmd.service and lircd-uinput.service # (the default lirc configuration conflicts with eventlircd)
  systemd:
    name: '{{ item }}'
    enabled: no
    state: stopped
    masked: yes
  with_items:
    - lircd.service
    - lircd.socket
    - lircmd.service
    - lircd-uinput.service
  ignore_errors: yes
  tags:
    - systemd

- name: apt | install eventlircd and lircd2uinput
  apt:
    name:
      - eventlircd
      - lircd2uinput
    state: present
  tags:
    - packages

- name: configure vdr to read from a lircd-compatible socket
  template:
    src: templates/03-vdr-lirc.conf.j2
    dest: /etc/vdr/conf.d/03-vdr-lirc.conf
  notify: ['Restart VDR']
  tags:
    - config

- name: expand template for /etc/rc_maps.cfg
  template:
    src: templates/rc_maps.cfg.j2
    dest: /etc/rc_maps.cfg
  notify: ['Trigger Udev']
  tags:
    - config

7.9.3 templates

1. Systemd Drop-in to start vdr with lirc support
   

   {% if frontend != 'kodi' %}
   [vdr]
   --lirc=/var/run/lirc/lircd
   {% endif %}
   

2. Systemd Drop-in to start lircd2uinput with lircd
   

   [Service]
   ExecStartPost=/usr/bin/lircd2uinput-add /var/run/lirc/lircd0
   ExecStopPost=/usr/bin/lircd2uinput-remove /var/run/lirc/lircd0
   

3. create /etc/rc_maps.cfg
   

   {{ ansible_managed | comment }}
   #
   # Keymaps table
   #
   # This table creates an association between a keycode file and a kernel
   # driver. It can be used to automatically override a keycode definition.
   #
   # Although not yet tested, it is mented to be added at udev.
   #
   # To use, you just need to run:
   #       ./ir-keytable -a
   #
   # Or, if the remote is not the first device:
   #       ./ir-keytable -a -s rc1         # for RC at rc1
   #
   
   # Format:
   #       driver - name of the driver provided via uevent - use * for any driver
   #       table -  RC keymap table, provided via uevent - use * for any table
   #       file - file name. If directory is not specified, it will default to
   #               /etc/rc_keymaps.
   # For example:
   # driver        table                           file
   # cx8800        *                               ./keycodes/rc5_hauppauge_new
   # *             rc-avermedia-m135a-rm-jx        ./keycodes/kworld_315u
   # saa7134       rc-avermedia-m135a-rm-jx        ./keycodes/keycodes/nec_terratec_cinergy_xs
   # em28xx        *                               ./keycodes/kworld_315u
   # *             *                               ./keycodes/rc5_hauppauge_new
   
   # Table to automatically load the rc maps for the bundled IR's provided with the
   # devices supported by the linux kernel
   
   #driver table                    file
   ite-cir     rc-rc6-mce          /lib/udev/rc_keymaps/rc-rc6-mce
   nuvoton-cir rc-rc6-mce          /lib/udev/rc_keymaps/rc-rc6-mce
   serial_ir   rc-rc6-mce          /lib/udev/rc_keymaps/rc-rc6-mce
   mceusb      rc-rc6-mce          /lib/udev/rc_keymaps/HOPLOrc6
   
   # Hauppauge PVR 350
   ir-kbd-i2c  rc-hauppauge        /lib/udev/rc_keymaps/rc-hauppauge
   
   # imon-pad
   imon        rc-imon-mce         /lib/udev/rc_keymaps/rc-imon-mce
   imon        rc-imon-pad         /lib/udev/rc_keymaps/rc-imon-pad
   
   # TT-1500/1501
   budget_ci   rc-tt-1500          /lib/udev/rc_keymaps/rc-tt-1501
   
   
   # Skystarhd2
   mantis_core * /lib/udev/rc_keymaps/skystarhd2
   
   # Medion X10
   ati_remote    rc-medion-x10              /lib/udev/rc_keymaps/rc-medion-x10
   ati_remote    rc-medion-x10-or2x         /lib/udev/rc_keymaps/rc-medion-x10-or2x
   ati_remote    rc-medion-x10-digitainer   /lib/udev/rc_keymaps/rc-medion-x10-digitainer
   
   # other devices (which still mostly need a customized keymap for yaVDR)
   *       rc-adstech-dvb-t-pci     adstech_dvb_t_pci
   *       rc-alink-dtu-m           alink_dtu_m
   *       rc-anysee                anysee
   *       rc-apac-viewcomp         apac_viewcomp
   *       rc-asus-pc39             asus_pc39
   *       rc-asus-ps3-100          asus_ps3_100
   *       rc-ati-tv-wonder-hd-600  ati_tv_wonder_hd_600
   *       rc-ati-x10               ati_x10
   *       rc-avermedia-a16d        avermedia_a16d
   *       rc-avermedia-cardbus     avermedia_cardbus
   *       rc-avermedia-dvbt        avermedia_dvbt
   *       rc-avermedia-m135a       avermedia_m135a
   *       rc-avermedia-m733a-rm-k6 avermedia_m733a_rm_k6
   *       rc-avermedia-rm-ks       avermedia_rm_ks
   *       rc-avermedia             avermedia
   *       rc-avertv-303            avertv_303
   *       rc-azurewave-ad-tu700    azurewave_ad_tu700
   *       rc-behold-columbus       behold_columbus
   *       rc-behold                behold
   *       rc-budget-ci-old         budget_ci_old
   *       rc-cec                   cec
   *       rc-cinergy-1400          cinergy_1400
   *       rc-cinergy               cinergy
   *       rc-delock-61959          delock_61959
   *       rc-dib0700-nec           dib0700_nec
   *       rc-dib0700-rc5           dib0700_rc5
   *       rc-digitalnow-tinytwin   digitalnow_tinytwin
   *       rc-digittrade            digittrade
   *       rc-dm1105-nec            dm1105_nec
   *       rc-dntv-live-dvb-t       dntv_live_dvb_t
   *       rc-dntv-live-dvbt-pro    dntv_live_dvbt_pro
   *       rc-dtt200u               dtt200u
   *       rc-dvbsky                dvbsky
   *       rc-em-terratec           em_terratec
   *       rc-encore-enltv-fm53     encore_enltv_fm53
   *       rc-encore-enltv          encore_enltv
   *       rc-encore-enltv2         encore_enltv2
   *       rc-evga-indtube          evga_indtube
   *       rc-eztv                  eztv
   *       rc-flydvb                flydvb
   *       rc-flyvideo              flyvideo
   *       rc-fusionhdtv-mce        fusionhdtv_mce
   *       rc-gadmei-rm008z         gadmei_rm008z
   *       rc-genius-tvgo-a11mce    genius_tvgo_a11mce
   *       rc-gotview7135           gotview7135
   *       rc-hauppauge             /lib/udev/rc_keymaps/rc-hauppauge
   *       rc-imon-mce              /lib/udev/rc_keymaps/rc-imon-mce
   *       rc-imon-pad              /lib/udev/rc_keymaps/rc-imon-pad
   *       rc-iodata-bctv7e         iodata_bctv7e
   *       rc-it913x-v1             it913x_v1
   *       rc-it913x-v2             it913x_v2
   *       rc-kaiomy                kaiomy
   *       rc-kworld-315u           kworld_315u
   *       rc-kworld-pc150u         kworld_pc150u
   *       rc-kworld-plus-tv-analog kworld_plus_tv_analog
   *       rc-leadtek-y04g0051      leadtek_y04g0051
   *       rc-lme2510               lme2510
   *       rc-manli                 manli
   #*      rc-medion-x10-digitainer medion_x10_digitainer
   #*      rc-medion-x10-or2x       medion_x10_or2x
   #*      rc-medion-x10            medion_x10
   *       rc-msi-digivox-ii        msi_digivox_ii
   *       rc-msi-digivox-iii       msi_digivox_iii
   *       rc-msi-tvanywhere-plus   msi_tvanywhere_plus
   *       rc-msi-tvanywhere        msi_tvanywhere
   *       rc-nebula                nebula
   *       rc-nec-terratec-cinergy-xs nec_terratec_cinergy_xs
   *       rc-norwood               norwood
   *       rc-npgtech               npgtech
   *       rc-pctv-sedna            pctv_sedna
   *       rc-pinnacle-color        pinnacle_color
   *       rc-pinnacle-grey         pinnacle_grey
   *       rc-pinnacle-pctv-hd      pinnacle_pctv_hd
   *       rc-pixelview-002t        pixelview_002t
   *       rc-pixelview-mk12        pixelview_mk12
   *       rc-pixelview-new         pixelview_new
   *       rc-pixelview             pixelview
   *       rc-powercolor-real-angel powercolor_real_angel
   *       rc-proteus-2309          proteus_2309
   *       rc-purpletv              purpletv
   *       rc-pv951                 pv951
   *       rc-rc6-mce               /lib/udev/rc_keymaps/rc-rc6-mce
   *       rc-real-audio-220-32-keys real_audio_220_32_keys
   *       rc-reddo                 reddo
   *       rc-snapstream-firefly    snapstream_firefly
   *       rc-streamzap             streamzap
   *       rc-su3000                su3000
   *       rc-tbs-nec               tbs_nec
   *       rc-technisat-ts35        technisat_ts35
   *       rc-technisat-usb2        technisat_usb2
   *       rc-terratec-cinergy-c-pci terratec_cinergy_c_pci
   *       rc-terratec-cinergy-s2-hd terratec_cinergy_s2_hd
   *       rc-terratec-cinergy-xs   terratec_cinergy_xs
   *       rc-terratec-slim-2       terratec_slim_2
   *       rc-terratec-slim         terratec_slim
   *       rc-tevii-nec             tevii_nec
   *       rc-tivo                  tivo
   *       rc-total-media-in-hand-02 total_media_in_hand_02
   *       rc-total-media-in-hand   total_media_in_hand
   *       rc-trekstor              trekstor
   *       rc-tt-1500          /lib/udev/rc_keymaps/rc-tt-1500
   *       rc-twinhan-dtv-cab-ci    twinhan_dtv_cab_ci
   *       rc-twinhan1027           twinhan_vp1027_dvbs
   *       rc-videomate-k100        videomate_k100
   *       rc-videomate-s350        videomate_s350
   *       rc-videomate-tv-pvr      videomate_tv_pvr
   *       rc-winfast-usbii-deluxe  winfast_usbii_deluxe
   *       rc-winfast               winfast
   # *     *                        a800                 # found in a800.c
   # *     *                        af9005               # found in af9005-remote.c
   # *     *                        cinergyt2            # found in cinergyT2-core.c
   # *     *                        dvico_mce            # found in cxusb.c
   # *     *                        dvico_portable       # found in cxusb.c
   # *     *                        d680_dmb             # found in cxusb.c
   # *     *                        dibusb               # found in dibusb-common.c
   # *     *                        digitv               # found in digitv.c
   # *     *                        megasky              # found in m920x.c
   # *     *                        tvwalkerir-kbd-i2c   # found in m920x.c
   # *     *                        pinnacle310e         # found in m920x.c
   # *     *                        haupp                # found in nova-t-usb2.c
   # *     *                        opera1               # found in opera1.c
   # *     *                        vp702x               # found in vp702x.c
   # *     *                        vp7045               # found in vp7045.c
   
   

7.10.1 tasks

---

- name: apt | install pulseaudio, pavucontrol and vdr-plugin-pulsecontrol
  apt:
    name:
      - pulseaudio
      - pavucontrol
      - vdr-plugin-pulsecontrol
    state: present
    install_recommends: no

- name: create /etc/asound.conf with pulseaudio as default device
  template:
    src: templates/alsa/asound.conf.j2
    dest: /etc/asound.conf

7.10.2 templates

# Use PulseAudio by default
pcm.!default {
  type pulse
  fallback "sysdefault"
  hint {
    show on
    description "Default ALSA Output (currently PulseAudio Sound Server)"
  }
}

ctl.!default {
  type pulse
  fallback "sysdefault"
}

7.11.1 About the GUI session

7.11.2 default variables

first_run: False
preferred_outputs:
  - HDMI
  - DP
  - DVI
  - VGA
  - TV
preferred_resolutions:
  - 7680x4320
  - 3840x2160
  - 1920x1080
  - 1280x720
  - 720x576
preferred_refreshrates:
  - 50
  - 60

7.11.3 tasks

1. main.yml
   

   ---
   # file: roles/yavdr-xorg/tasks/main.yml
   - import_tasks: setup-xorg.yml
     tags: [install,update]
   - import_tasks: detect-xorg.yml
     tags: [xorg.detect,install]
   

2. setup-xorg.yml
   

   ---
   # file: roles/yavdr-xorg/tasks/setup-xorg.yml
   - name: create directories for systemd drop-in files
     file:
       dest: '{{ item }}'
       state: directory
     with_items:
       - "/etc/systemd/system/x@.service.d/"
       - "/etc/systemd/system/vdr.service.d/"
       - "/etc/systemd/system/user@{{ vdr.uid }}.service.d/"
       - "/etc/X11/xorg.conf.d/"
   
   - name: systemd-drop-in | add dependency to X-server for vdr.service
     template:
       src: templates/vdr-xorg.conf
       dest: /etc/systemd/system/vdr.service.d/vdr-xorg.conf
   
   - name: systemd-drop-in | start x@.service after plymouth.service
     template:
       src: templates/x@service.d/plymouth.conf.j2
       dest: /etc/systemd/system/x@.service.d/plymouth.conf
   
   - name: systemd-drop-in | start x@.service before xlogin@.service
     template:
       src: templates/x@service.d/xlogin.conf.j2
       dest: /etc/systemd/system/x@.service.d/xlogin.conf
   
   - name: systemd-drop-in | load environment file for vdr.service
     template:
       src: templates/systemd/vdr-environ.j2
       dest: /etc/systemd/system/vdr.service.d/load-environ.conf
   
   - name: systemd-drop-in | user@{{ vdr.uid }}.service depends on x@vt7.service
     template:
       src: templates/user@666.service.d/x-dependency.conf.j2
       dest: '/etc/systemd/system/user@{{ vdr.uid }}.service.d/x-dependency.conf'
   
   - name: vdr-config | start softhddevice detached and set audio to pulseaudio
     lineinfile:
       path: /etc/vdr/conf.avail/softhddevice.conf
       line: '{{ item }}'
     with_items:
         - '-D'
         - '-w alsa-driver-broken'
         # - '-a pulse' # do we need this with our existing asound.conf?
   
   - name: vdr-config | use vaapi for softhddevice if we got an intel IGP
     lineinfile:
       path: /etc/vdr/conf.avail/softhddevice.conf
       line: '-v va-api'
       state: '{{ "present" if intel_detected else "absent" }}'
   
   - name: add a login shell for the user vdr
     user:
         name: '{{ vdr.user }}'
         shell: '/bin/bash'
         state: present
         uid: '{{ vdr.uid }}'
         groups: '{{ vdr.group }}'
         append: yes
   
   - name: apt | install packages for xorg
     apt:
       name:
         - xlogin
         - yavdr-xorg
         - xorg
         - xserver-xorg-input-all
         - xserver-xorg-video-all
         - openbox
         - python3-dbus2vdr
         - python3-yavdrfrontend
         - read-edid
         - tmux
         - vdr-plugin-desktop
         - vdr-plugin-osd2web
         - feh
         #- yavdr-xorg
       state: present
   
   - name: apt | install packages for Intel IGP
     apt:
       name:
         - xserver-xorg-video-intel
         - i965-va-driver-shaders
       state: present
     when: intel_detected
   
   - name: Install yaVDR Media (e.g. Backgrounds)
     apt:
       name: yavdr-media
   
   - name: command | write keyboard configuration to /etc/X11/xorg.conf.d/00-keyboard.conf
     command: write-x11-keyboard-config
     args:
       creates: /etc/X11/xorg.conf.d/00-keyboard.conf
     # NOTE: write-x11-keyboard-config is in the xlogin package
     # Ubuntu's systemd is patched, so it does not create the file automatically
   
   - name: add snippet to ignore eventlircd devices in xorg
     template:
       src: templates/xorg-ignore-eventlircd.conf.j2
       dest: /etc/X11/xorg.conf.d/40-ignore-eventlircd.conf
   
   - name: apt | install desktop programs
     apt:
       name:
         - xterm
         - firefox
         - kiosk-browser
       state: present
   

3. detect-xorg.yml
   

   ---
   # file: roles/yavdr-xorg/tasks/detect-xorg.yml
   
   - name: "expand template for x-verbose@.service"
     template:
       src: "templates/systemd/system/x-verbose@.service.j2"
       dest: "/etc/systemd/system/x-verbose@.service"
   
   - name: "expand template for xorg-verbose.conf"
     template:
       src: "templates/xorg-verbose.conf.j2"
       dest: "/etc/X11/xorg-verbose.conf"
   
   - name: "remove intel snippet"
     file:
       path: /etc/X11/xorg.conf.d/20-intel.conf
       state: absent
   
   - name: Stop VDR
     systemd:
       name: vdr.service
       state: stopped
       enabled: yes
     notify: ['Start VDR']
   
   - name: Stop yavdr-xorg
     systemd:
       name: 'yavdr-xorg'
       state: stopped
       enabled: yes
     notify: ['Start yavdr-xorg']
   
   - name: Stop xlogin
     systemd:
       name: 'xlogin@{{ vdr.user }}.service'
       state: stopped
     notify: ['Start xlogin']
   
   - name: Stop x
     systemd:
       name: x@vt7.service
       state: stopped
   
   - name: Workaround for wrong connector names on first run
     block:
       - name: "wait a little bit before starting x-verbose@vt7.service (needed?)"
         wait_for:
           timeout: 10
       
       - name: "start x-verbose@.service"
         systemd:
             name: "x-verbose@vt7.service"
             state: started
             enabled: false
             masked: false
             daemon_reload: true
       
       - name: "wait a little bit, so X has some time to start up (needed?)"
         wait_for:
           timeout: 3
       
       - name: "stop x-verbose@vt7.service"
         systemd:
           name: "x-verbose@vt7.service"
           state: stopped
           enabled: false
           masked: true
     when: first_run
   
   - name: "wait a little bit, so X has some time to shut down (needed?)"
     wait_for:
       timeout: 3
   
   - name: "trigger udevadm reload"
     command: 'udevadm trigger '
   
   - name: "wait a little bit, so udev has some time to reapply rules (needed?)"
     wait_for:
       timeout: 3
   
   - name: "start x-verbose@.service"
     systemd:
       name: "x-verbose@vt7.service"
       state: started
       enabled: false
       masked: false
       daemon_reload: true
   
   - name: "wait a little bit, so X has some time to start up (needed?)"
     wait_for:
       timeout: 3
   
   - name: "detect xorg configuration"
     xrandr_facts:
       preferred_refreshrates: '{{ preferred_refreshrates }}'
       preferred_resolutions: '{{ preferred_resolutions }}'
       preferred_outputs: '{{ preferred_outputs }}'
   
   - debug:
       var: xorg.primary
   
   - debug:
       var: xorg.secondary
     when: xorg.secondary is defined
   
   - debug:
       var: drm
     when: drm is defined
   
   - name: "stop x-verbose@vt7.service"
     systemd:
       name: "x-verbose@vt7.service"
       state: stopped
       enabled: false
       masked: true
   
   - name: "wait a little bit, so X has some time to shut down (needed?)"
     wait_for:
       timeout: 3
   
   - name: save results
     block:
       - name: ensure facts.d directory exists
         file:
           state: directory
           path: /etc/ansible/facts.d
   
       - name: write xorg variable as local fact
         copy:
           content: '{{ {"xorg": xorg} | to_nice_json }}'
           dest: /etc/ansible/facts.d/xorg.fact
   
       - name: write xrandr variable as local fact
         copy:
           content: '{{ {"xrandr": xrandr} | to_nice_json }}'
           dest: /etc/ansible/facts.d/xrandr.fact
   
       - name: write drm variable as local fact
         copy:
           content: '{{ {"drm": drm} | to_nice_json }}'
           dest: /etc/ansible/facts.d/drm.fact
     when:
       - xrandr is defined
       - xorg is defined
       - drm is defined
   
   - name: update xorg, xrandr and drm variables with values from local facts if needed
     set_fact:
       xorg: '{{ ansible_local.xorg.xorg }}'
       xrandr: '{{ ansible_local.xrandr.xrandr }}'
       drm: '{{ ansible_local.drm.drm }}'
     when:
       - xrandr is undefined
       - xorg is undefined
       - drm is undefined
   
   # TODO: expand template for xorg.conf (or snippets)
   #       with respect for the available graphics card driver
   #       nvidia, noveau, intel, radeon
   
   - name: nvidia related config
     block:
     - name: create xorg.conf (for nvidia driver)
       template:
           src: templates/xorg.conf.j2
           dest: /etc/X11/xorg.conf
           backup: yes
     when:
       - nvidia_detected
   
   - name: intel xorg config snippet
     template:
       src: templates/20-intel.conf.j2
       dest: /etc/X11/xorg.conf.d/20-intel.conf
     when:
       - intel_detected
   
   - name: server flags config snippet to disable screen blanking
     template:
       src: templates/10-serverflags.conf.j2
       dest: /etc/X11/xorg.conf.d/10-serverflags.conf
   

4. intel.yml
   

   KMS drivers (like for intel (i915) and amd (radeon)) require additional configuration besides a customized xorg.conf - for a „static“ output configuration (which works if the TV or AV receiver is not turned on) we need to force loading the display(s) EDID early during the boot process.

   This task therefore performs the following actions after the xrandr detection has been executed:

   • create an initramfs-hook to copy the EDID(s) into the initramfs
   • get the connector names and match them to the ones determined by xrandr (this is done by xrandr_facts.py)
   • add kernel boot arguments to set EDID and mode (refreshrate and resolution) for all outputs
   • recreate and update initramfs and grub config

   Please note that rescanning the connected displays works only after removing the forced loading of EDID(s) during boot (call clean-edids) and a reboot.

   Programmlisting 1 roles/yavdr-xorg/tasks/intel.yml

   - name: "create initramfs hook to copy EDID files"
     copy:
       src: files/include-edid-data.sh
       dest: '/etc/initramfs-tools/hooks/include-edid-data'
       mode: 0755
       force: yes
   
   - name: "create /lib/firmware/edid"
     file:
       state: directory
       dest: /lib/firmware/edid
   # TODO:
   # - write EDID files to /lib/firmware/edid/
   # - complete template for grub.d
   name: "add kernel boot parameters for static display configuration"
   template:
     src: templates/grub.d/intel.j2
     dest: /etc/grub.d/99_intel
     mode: 0755
     notify: ['Update Initramfs', 'Update GRUB']
   
   

7.11.4 templates

1. grub
   

   {{ ansible_managed | comment }}
   {% set output_flag = 'D' if ("HDMI" in xorg.primary.connector or "DVI" in xorg.primary.connector or "DP" in xorg.primary.connector) else 'e' %} 
   GRUB_CMDLINE_LINUX+=" video={{ drm.primary.drm_connector }}:{{ xorg.primary.mode|replace('_', '@') }}{{ output_flag }} drm.edid_firmware={{ drm.primary.drm_connector }}:edid/{{ drm.primary.edid }} {% for ignored_c in drm.ignored_outputs %}video={{ ignored_c }}:d{% endfor %}"
   

2. xorg
   
   1. x-verbose@.service
      

      # file: roles/yavdr-xorg/templates/systemd/system/x-verbose@.service.j2
      [Unit]
      Description=X with verbose logging on %I
      Wants=graphical.target
      Before=graphical.target
      
      [Service]
      Type=forking
      ExecStart=/usr/bin/x-daemon -logverbose 6 -noreset %I -config /etc/X11/xorg-verbose.conf
      

   2. Drop-in snippet for x@.service
      

      [Unit]
      After=plymouth.service
      

      [Unit]
      Before=xlogin@{{ vdr.user }}.service
      

      [Unit]
      Wants=x@vt7.service
      After=x@vt7.service
      
      [Service]
      TimeoutStopSec=20
      KillMode=mixed
      

   3. Drop-in snippet for vdr.service
      

      {{ ansible_managed | comment }}
      [Unit]
      After=x@vt7.service
      Wants=x@vt7.service
      #BindsTo=x@vt7.service
      

   4. xorg.conf snippets
      

      {{ ansible_managed | comment }}
      
      Section "InputClass"
          Identifier "exclude eventlircd devices"
          MatchTag   "eventlircd"
          Option     "Ignore"    "True"
      EndSection
      

   5. intel graphics xorg.conf snippet
      

      {{ ansible_managed | comment }}
      {% set primary_output = xorg.primary.connector|replace("-", "") %}
      {% if xorg.secondary is defined %}
        {% set secondary_output = xorg.secondary.connector|replace("-", "") %}
      {% endif %}
      
      Section "Device"
        Identifier  "Device0"
        Driver      "intel"
        Option      "TearFree" "true"
      {% if xorg.secondary is defined %}
        Option      "ZaphodHeads" "{{ primary_output }}"
        Screen      0  
      {% endif %}
      EndSection
      
      {% if xorg.secondary is defined %}
      Section "Device"
        Identifier  "Device1"
        Driver      "intel"
        Option      "TearFree" "true"
        Option      "ZaphodHeads" "{{ secondary_output }}"
        Screen      1  
      EndSection
      
      Section "ServerLayout"
          Identifier     "Layout0"
          Screen      0  "Screen0" 0 0
          Screen      1  "Screen1" RightOf "Screen0"
      EndSection
      {% endif %}
      
      Section "Screen"
        Identifier  "Screen0"
        Device      "Device0"
        Monitor     "{{ primary_output }}"
        DefaultDepth  24
        SubSection "Display"
          Depth       24
      {% if xorg.primary.mode %}
          Modes     "{{ xorg.primary.mode }}"
      {% else %}
          Modes     "1920x1080_50" "1920x1080_60" "1920x1080_24"
      {% endif %}
        EndSubSection
      EndSection
      
      {% if xorg.secondary is defined %}
      Section "Screen"
        Identifier  "Screen1"
        Device      "Device1"
        Monitor     "{{ secondary_output }}"
        DefaultDepth  24
        SubSection "Display"
          Depth       24
      {% if xorg.secondary.mode %}
          Modes     "{{ xorg.secondary.mode }}"
      {% else %}
          Modes     "1920x1080_50" "1920x1080_60" "1920x1080_24"
      {% endif %}
        EndSubSection
      EndSection
      
      {% endif %}
      Section "Monitor"
        Identifier  "{{ primary_output }}"
      {% if xorg.primary.modelines %}
      {% for modeline in xorg.primary.modelines %}
        {{ modeline }}
      {% endfor %}
      {% else %}
        Modeline    "1920x1080_24"     74.230 1920 2560 2604 2752 1080 1084 1089 1125 +hsync +vsync
        Modeline    "1920x1080_50"    148.500 1920 2448 2492 2640 1080 1084 1089 1125 +hsync +vsync
        Modeline    "1920x1080_60"    148.500 1920 2008 2056 2200 1080 1084 1089 1125 +hsync +vsync
      {% endif %}
      EndSection
      
      {% if xorg.secondary is defined %}
      Section "Monitor"
        Identifier  "{{ secondary_output }}"
      {% if xorg.secondary.modelines %}
      {% for modeline in xorg.secondary.modelines %}
        {{ modeline }}
      {% endfor %}
      {% else %}
        Modeline    "1920x1080_24"     74.230 1920 2560 2604 2752 1080 1084 1089 1125 +hsync +vsync
        Modeline    "1920x1080_50"    148.500 1920 2448 2492 2640 1080 1084 1089 1125 +hsync +vsync
        Modeline    "1920x1080_60"    148.500 1920 2008 2056 2200 1080 1084 1089 1125 +hsync +vsync
      {% endif %}
      EndSection
      
      {% endif %}
      {% for connector, data in xrandr["Screen 0:"].items() | list %}
      {% if not data.is_connected or connector != xorg.primary.connector or (xorg.secondary is defined and connector != xorg.secondary.connector) %}
      Section "Monitor"
        Identifier "{{ connector|replace("-","") }}"
        Option "Ignore" "true"
      EndSection
      {% endif %}
      
      {% endfor %}
      

   6. xorg.conf
      

      {{ ansible_managed | comment }}
      
      Section "Device"
              Identifier "nvidia"
              Driver  "nvidia"
              Option  "DynamicTwinView"     "true"
              Option  "NoFlip"              "false"
      EndSection
      
      Section "Screen"
              Identifier      "screen"
              Device          "nvidia"
      EndSection
      

      {{ ansible_managed | comment }}
      
      Section "ServerLayout"
          Identifier     "Layout0"
          Screen         0  "Screen0" 0 0
      {% if xorg.secondary is defined %}
          Screen         1  "Screen1" RightOf "Screen0"
      {% endif %}
          #InputDevice    "Keyboard0" "CoreKeyboard"
          #InputDevice    "Mouse0" "CorePointer"
          Option         "Xinerama" "0"
      EndSection
      
      Section "InputClass"
          Identifier "exclude eventlircd devices"
          MatchTag   "eventlircd"
          Option     "Ignore"    "True"
      EndSection
      
      Section "Monitor"
          Identifier     "Monitor0"
          VendorName     "{{ xorg.primary.vendor }}"
          ModelName      "{{ xorg.primary.model }}"
          Option         "DPMS"
          Option         "ExactModeTimingsDVI" "True"
      EndSection
      
      Section "Device"
          Identifier     "Device0"
          Driver         "nvidia"
          VendorName     "NVIDIA Corporation"
          Option         "NoLogo"              "true"
      {% if xorg.primary.bus_id is defined %}
          BoardName      "{{ xorg.primary.gpu_name }}"
          BusID          "{{ xorg.primary.bus_id }}"
      {% else %}
          BoardName      "Unknown"
      {% endif %}
          Screen          0
          Option         "ConnectedMonitor" "{{ xorg.primary.connector }}{% if xorg.secondary is defined %}, {{ xorg.secondary.connector }}{% endif %}"
          Option         "CustomEDID" "{{ xorg.primary.connector }}:/etc/X11/edid.{{ xorg.primary.connector }}.bin{% if xorg.secondary is defined %};{{ xorg.secondary.connector }}:/etc/X11/edid.{{ xorg.secondary.connector }}.bin{% endif %}"
      EndSection
      
      Section "Screen"
          Identifier     "Screen0"
          Device         "Device0"
          Monitor        "Monitor0"
          DefaultDepth    24
          Option         "nvidiaXineramaInfoOrder" "{{ xorg.primary.connector }}"
          Option         "UseDisplayDevice" "{{ xorg.primary.connector }}"
          Option         "metamodes" "{{ xorg.primary.connector }}: {{ xorg.primary.mode }} +0+0 {ForceCompositionPipeline=Off, ForceFullCompositionPipeline=Off}"
          Option         "AllowIndirectGLXProtocol" "off"
          Option         "TripleBuffer" "on"
          Option         "SLI" "Off"
          Option         "MultiGPU" "Off"
          Option         "BaseMosaic" "off"
          SubSection     "Display"
              Depth       24
          EndSubSection
      EndSection
      
      {% if xorg.secondary is defined %}
      Section "Device"
          Identifier     "Device1"
          Driver         "nvidia"
          VendorName     "NVIDIA Corporation"
          Option  "NoLogo"              "true"
      {% if xorg.secondary.bus_id is defined %}
          BoardName      "{{ xorg.primary.gpu_name }}"
          BusID          "{{ xorg.primary.bus_id }}"
      {% else %}
          BoardName      "Unknown"
      {% endif %}
          Screen          1
      EndSection
      
      Section "Monitor"
          Identifier     "Monitor1"
          VendorName     "{{ xorg.secondary.vendor }}"
          ModelName      "{{ xorg.secondary.model }}"
      EndSection
      
      Section "Screen"
          Identifier     "Screen1"
          Device         "Device1"
          Monitor        "Monitor1"
          DefaultDepth    24
          Option         "nvidiaXineramaInfoOrder" "{{ xorg.secondary.connector }}"
          #Option         "ConnectedMonitor" "{{ xorg.secondary.connector }}"
          Option         "UseDisplayDevice" "{{ xorg.secondary.connector }}"
          #Option         "CustomEDID" "{{ xorg.secondary.connector }}:/etc/X11/edid.{{ xorg.secondary.connector }}.bin"
          Option         "metamodes" "{{ xorg.secondary.connector }}: {{ xorg.secondary.mode }} +0+0 {ForceCompositionPipeline=Off, ForceFullCompositionPipeline=Off}"
          Option         "AllowIndirectGLXProtocol" "off"
          Option         "TripleBuffer" "on"
          Option         "SLI" "Off"
          Option         "MultiGPU" "Off"
          Option         "BaseMosaic" "off"
          SubSection     "Display"
              Depth       24
          EndSubSection
      EndSection
      {% endif %}
      
      Section "Extensions"
          Option         "Composite" "Disable"
      EndSection
      

      {{ ansible_managed | comment }}
      
      Section "ServerLayout"
          Identifier     "Layout0"
          Screen      0  "Screen0"
          {% if xorg.best_tv_mode.secondary is defined %}
          Screen      1  "Screen1" RightOf "Screen0"
          {% endif %}
          InputDevice    "Keyboard0" "CoreKeyboard"
          InputDevice    "Mouse0" "CorePointer"
      EndSection
      
      Section "InputDevice"
          # generated from default
          Identifier     "Mouse0"
          Driver         "mouse"
          Option         "Protocol" "auto"
          Option         "Device" "/dev/psaux"
          Option         "Emulate3Buttons" "no"
          Option         "ZAxisMapping" "4 5"
      EndSection
      
      # ignore devices with eventlircd tag 
      # ENV{ID_INPUT.tags}+="eventlircd"
      # must be set by an udev rule
      Section "InputClass"
          Identifier "ignore eventlircd devices"
          MatchTag "eventlircd"
          Option "Ignore" "True"
      EndSection
      
      
      
      Section "InputDevice"
          # generated from default
          Identifier     "Keyboard0"
          Driver         "kbd"
      EndSection
      
      
      Section "Monitor"
          Identifier     "Monitor0"
          VendorName     "Unknown"
          ModelName      "Unknown"
      {# TODO: VGA2SCART support (if needed)
      {% if system.x11.display.0.default == "VGA2Scart_4_3" or system.x11.display.0.default == "VGA2Scart_16_9" %}
          HorizSync       14-17
          VertRefresh     49-61
          {% if system.x11.display.0.default == "VGA2Scart_4_3" %}
          Modeline "VGA2Scart_4_3" 13.875 720 744 808 888 576 580 585 625 -HSync -Vsync interlace
          {% elif system.x11.display.0.default == "VGA2Scart_16_9" %}
          Modeline "VGA2Scart_16_9" 19 1024 1032 1120 1216 576 581 586 625 -Hsync -Vsync interlace
          {% endif %}
      {% endif %}
      #}
          Option         "DPMS"
          Option         "ExactModeTimingsDVI" "True"
      EndSection
      
      
      {% if xrandr.best_tv_mode.secondary is defined %}
      Section "Monitor"
          Identifier     "Monitor1"
          VendorName     "Unknown"
          ModelName      "Unknown"
      {#
      {% if system.x11.display.1.default in ("VGA2Scart_4_3",  "VGA2Scart_16_9") %}
          HorizSync       14-17
          VertRefresh     49-61
          {% if system.x11.display.1.default == "VGA2Scart_4_3" %}
          Modeline "VGA2Scart_4_3" 13.875 720 744 808 888 576 580 585 625 -HSync -Vsync interlace
          {% elif system.x11.display.1.default == "VGA2Scart_16_9" %}
          Modeline "VGA2Scart_16_9" 19 1024 1032 1120 1216 576 581 586 625 -Hsync -Vsync interlace
          {% endif %}
          Option         "DPMS"
          Option         "ExactModeTimingsDVI" "True"
      {% endif %}
      #}
      EndSection
      {% endif %}
      
      Section "Device"
          Identifier     "Device0"
      {% if system.hardware.nvidia.detected %}
          Driver         "nvidia"
          VendorName     "NVIDIA Corporation"
      {% endif %}
          Screen          0
          Option         "DPI" "100x100"
      {% if system.hardware.nvidia.busid is defined and system.hardware.busid %}
          BusID          "PCI: {{ system.hardware.nvidia.busid }}"
      {% endif %}
          Option         "NoLogo" "True"
          Option         "UseEvents" "True"
          Option         "TripleBuffer" "False"
          Option         "AddARGBGLXVisuals" "True"
          Option         "TwinView" "0"
          Option         "DynamicTwinView" "0"
          Option         "OnDemandVBlankinterrupts" "on"
          Option         "FlatPanelProperties" "Scaling = Native"
      EndSection
      
      {% if xrandr.best_tv_mode.secondary is defined %}
      Section "Device"
          Identifier     "Device1"
          {% if system.hardware.nvidia.detected %}
          Driver         "nvidia"
          VendorName     "NVIDIA Corporation"
          {% endif %}
          Screen          1
          {% if system.hardware.nvidia.busid is defined and system.hardware.nvidia.busid %}
          BusID          "PCI: {{ system.hardware.nvidia.busid }}"
          {% endif %}
          Option         "NoLogo" "True"
          Option         "UseEvents" "True"
          Option         "TripleBuffer" "False"
          Option         "AddARGBGLXVisuals" "True"
          Option         "TwinView" "0"
          Option         "DynamicTwinView" "0"
      EndSection
      {% endif %}
      
      
      Section "Screen"
          Identifier     "Screen0"
          Device         "Device0"
          Monitor        "Monitor0"
          DefaultDepth    24
          SubSection     "Display"
              Depth       24
      {% if xrandr.best_tv_mode.primary is defined %}
              Modes      "{{ xrandr.best_tv_mode.primary.mode }}"{#{% for mode in xrandr %}{% if mode != system.x11.display.0.default %} "{{ mode }}"{% endif %}{% endfor %}#} nvidia-auto-select
      
      {% elif system.hardware.nvidia.detected == 1 %}
              Modes      "nvidia-auto-select"
      {% endif %}
          EndSubSection
      {% if system.x11.display.0.default or system.x11.default %}
          {% if system.x11.display.0.device is definded and system.x11.display.0.device %}
          Option         "ConnectedMonitor" {{ system.x11.display.0.device }}
          {% else %}
          Option         "ConnectedMonitor" {{ system.x11.default }}
          {% endif %}
          #     Option         "ConnectedMonitor" "<?cs if:(?system.x11.display.0.device) ?><?cs call:fix_display_name(system.x11.display.0.device) ?><?cs else ?><?cs var:system.x11.default ?><?cs /if ?><?cs if:(?system.x11.dualhead.enabled && system.x11.dualhead.enabled == 1) ?>, <?cs call:fix_display_name(system.x11.display.1.device) ?><?cs /if ?>"
          #Option         "ConnectedMonitor"
          "<?cs if:(?system.x11.display.0.device) ?>
                <?cs call:fix_display_name(system.x11.display.0.device) ?>
           <?cs else ?>
                <?cs var:system.x11.default ?>
           <?cs /if ?>
           <?cs if:(?system.x11.dualhead.enabled && system.x11.dualhead.enabled == 1) ?>, <?cs call:fix_display_name(system.x11.display.1.device) ?><?cs /if ?>"
      #     Option         "UseDisplayDevice" "<?cs if:(?system.x11.display.0.device) ?><?cs call:fix_display_name(system.x11.display.0.device) ?><?cs else ?><?cs var:system.x11.default ?><?cs /if ?>"
      # <?cs /if ?>
      # <?cs if:(?system.hardware.nvidia.0.edid && system.hardware.nvidia.0.edid == "1") ?>
      #     Option         "CustomEDID" "<?cs call:fix_display_name(system.x11.display.0.device) ?>:/etc/X11/edid.0.yavdr"
      # <?cs /if ?>
      # <?cs if:(system.hardware.nvidia.detected == 1 && ?system.x11.display.0.device) ?>
      #     Option          "MetaModes" "<?cs call:fix_display_name(system.x11.display.0.device) ?>: <?cs var:system.x11.display.0.default ?> { ViewPortIn=<?cs var:system.x11.display.0.viewport.in.x ?>x<?cs var:system.x11.display.0.viewport.in.y ?>, ViewPortOut=<?cs var:system.x11.display.0.viewport.out.x ?>x<?cs var:system.x11.display.0.viewport.out.y ?>+<?cs var:system.x11.display.0.viewport.out.plusx ?>+<?cs var:system.x11.display.0.viewport.out.plusy ?> }"
      # <?cs each:mode = system.x11.display.0.mode ?><?cs if:(mode != system.x11.display.0.default) ?>
      #     Option          "MetaModes" "<?cs call:fix_display_name(system.x11.display.0.device) ?>: <?cs var:mode ?> { ViewPortIn=<?cs var:system.x11.display.0.viewport.in.x ?>x<?cs var:system.x11.display.0.viewport.in.y ?>, ViewPortOut=<?cs var:system.x11.display.0.viewport.out.x ?>x<?cs var:system.x11.display.0.viewport.out.y ?>+<?cs var:system.x11.display.0.viewport.out.plusx ?>+<?cs var:system.x11.display.0.viewport.out.plusy ?> }"<?cs /if ?><?cs /each ?> 
      {% endif %}
      EndSection
      
      {% if system.x11.dualhead.enabled == "1" %}
      Section "Screen"
      
           Identifier     "Screen1"
           Device         "Device1"
           Monitor        "Monitor1"
           DefaultDepth    24
           SubSection     "Display"
               Depth       24
      {% if system.x11.display.0.default is defined and system.x11.display.0.default %}
               Modes      "{{ system.x11.display.1.default }}"{% for mode in system.x11.display.1.mode %}{% if mode != system.x11.display.1.default %} "{{ mode }}"{% endif %}{% endfor %}
      
      {% elif system.hardware.nvidia.detected == "1" %}
               Modes      "nvidia-auto-select"
      {% endif %}
            EndSubSection
      
      # <?cs if:(?system.x11.display.1.default && system.x11.display.1.default != "" && system.x11.display.1.default != "disabled") ?>
      #     Option         "UseDisplayDevice" "<?cs call:fix_display_name(system.x11.display.1.device) ?>"
      # <?cs /if ?>
      # <?cs if:(?system.hardware.nvidia.1.edid && system.hardware.nvidia.1.edid == "1") ?>
      #     Option         "CustomEDID" "<?cs call:fix_display_name(system.x11.display.1.device) ?>:/etc/X11/edid.1.yavdr"
      # <?cs /if ?>
      # <?cs if:(system.hardware.nvidia.detected == 1 && ?system.x11.display.1.device) ?>
      #     Option          "MetaModes" "<?cs call:fix_display_name(system.x11.display.1.device) ?>: <?cs var:system.x11.display.1.default ?> { ViewPortIn=<?cs var:system.x11.display.1.viewport.in.x ?>x<?cs var:system.x11.display.1.viewport.in.y ?>, ViewPortOut=<?cs var:system.x11.display.1.viewport.out.x ?>x<?cs var:system.x11.display.1.viewport.out.y ?>+<?cs var:system.x11.display.1.viewport.out.plusx ?>+<?cs var:system.x11.display.1.viewport.out.plusy ?> }"
      # <?cs each:mode = system.x11.display.1.mode ?><?cs if:(mode != system.x11.display.1.default) ?>
      #     Option          "MetaModes" "<?cs call:fix_display_name(system.x11.display.1.device) ?>: <?cs var:mode ?> { ViewPortIn=<?cs var:system.x11.display.1.viewport.in.x ?>x<?cs var:system.x11.display.1.viewport.in.y ?>, ViewPortOut=<?cs var:system.x11.display.1.viewport.out.x ?>x<?cs var:system.x11.display.1.viewport.out.y ?>+<?cs var:system.x11.display.1.viewport.out.plusx ?>+<?cs var:system.x11.display.1.viewport.out.plusy ?> }"<?cs /if ?><?cs /each ?>
      # <?cs /if ?>
      EndSection
      {% endif %}
      

   7. snippet to disable screen blanking
      

      {{ ansible_managed | comment }}
      Section "ServerFlags"
          Option         "NoPM" "true"
          Option         "blank time" "0"
          Option         "standby time" "0"
          Option         "suspend time" "0"
          Option         "off time" "0"
      EndSection
      

3. vdr
   

   Set environment variables for system locale and user session on startup

   [Service]
   EnvironmentFile=-/etc/default/locale
   Environment=XDG_RUNTIME_DIR=/run/user/{{ vdr.uid }}/
   EnvironmentFile=-/var/lib/vdr/.session-env
   

7.11.5 files

1. initramfs EDID hook
   

   #!/bin/bash
   {{ ansible_managed | comment }}
   # This hook copies EDID files with the naming scheme "edid.${OUTPUT}.bin" to the initramfs.
   
   [ "$1" = "prereqs" ] && { echo "udev"; exit 0; }
   
   # load hook helper functions
   . /usr/share/initramfs-tools/hook-functions
   
   rm /lib/firmware/edid/edid.*.bin
   find "/etc/X11/" -name "edid.*.bin" -type f -exec cp -t "/lib/firmware/edid/" {} +
   mkdir -p "${DESTDIR}/lib/firmware/edid"
   find "/etc/X11/" -name "edid.*.bin" -type f -exec cp -t "${DESTDIR}/lib/firmware/edid/" {} +
   manual_add_modules i915 radeon
   exit 0
   

7.12.1 Tasks

1. main.yml
   

   ---
   # file: roles/yavdr-desktop/tasks/main.yml
   
   - name: create folders for user configuration files
     file:
       state: directory
       dest: '{{ item }}'
       mode: '0775'
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
     with_items:
       - '{{ vdr.home }}/.config/systemd/user'
       - '{{ vdr.home }}/.config/openbox'
       - '{{ vdr.home }}/.config/pulse'
       - '{{ vdr.home }}/bin'
   
   - name: expand template for .xinitrc for vdr user
     template:
         src: 'templates/.xinitrc.j2'
         dest: '{{ vdr.home }}/.xinitrc'
         mode: 0755
         owner: '{{ vdr.user }}'
         group: '{{ vdr.group }}'
   
   - name: "expand template for vdr's .Xresources"
     template:
         src: 'templates/.Xresources.j2'
         dest: '{{ vdr.home }}/.Xresources'
         mode: 0644
         owner: '{{ vdr.user }}'
         group: '{{ vdr.group }}'
   
   - name: expand template for openbox autostart
     template:
         src: 'templates/openbox/autostart.j2'
         dest: '{{ vdr.home }}/.config/openbox/autostart'
         mode: 0755
         owner: '{{ vdr.user }}'
         group: '{{ vdr.group }}'
   
   - name: expand rc.xml for openbox
     template:
         src: 'templates/openbox/rc.xml.j2'
         dest: '{{ vdr.home }}/.config/openbox/rc.xml'
         mode: 0644
         owner: '{{ vdr.user }}'
         group: '{{ vdr.group }}'
   
   - name: expand rc2.xml for openbox on second display
     template:
         src: 'templates/openbox/rc2.xml.j2'
         dest: '{{ vdr.home }}/.config/openbox/rc2.xml'
         mode: 0644
         owner: '{{ vdr.user }}'
         group: '{{ vdr.group }}'
   
   - name: create yavdr-desktop.target for the user session
     template:
         src: 'templates/systemd/user/yavdr-desktop.target.j2'
         dest: '{{ vdr.home }}/.config/systemd/user/yavdr-desktop.target'
         mode: 0644
         owner: '{{ vdr.user }}'
         group: '{{ vdr.group }}'
   
   - name: disable pulseaudio autospawning
     lineinfile:
       path: '{{ vdr.home }}/.config/pulse/client.conf'
       line: 'autospawn = yes'
       create: yes
       state: present
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
   
   - name: create tmux.service for the session
     template:
       src: 'templates/systemd/user/tmux.service.j2'
       dest: '{{ vdr.home }}/.config/systemd/user/tmux.service'
       mode: 0644
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
   
   - name: create wm-exit.service for the session
     template:
       src: templates/systemd/user/wm-exit.service.j2
       dest: '{{ vdr.home }}/.config/systemd/user/wm-exit.service'
       mode: 0644
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
   
   - name: create detect-second-display.service for the session
     template:
       src: templates/systemd/user/detect-second-display.service.j2
       dest: '{{ vdr.home }}/.config/systemd/user/detect-second-display.service'
       mode: 0644
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
   
   - name: create detect-second-diplay script
     template:
       src: templates/bin/detect-second-display.j2
       dest: '{{ vdr.home }}/bin/detect-second-display'
       mode: 0755
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
   
   - name: create switch-displays script
     template:
       src: templates/bin/switch-displays.j2
       dest: '{{ vdr.home }}/bin/switch-displays'
       mode: 0755
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
   
   - name: create openbox-second.service for the session
     template:
       src: templates/systemd/user/openbox-second.service.j2
       dest: '{{ vdr.home }}/.config/systemd/user/openbox-second.service'
       mode: 0644
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
   
   - name: create osd2web.service for the session
     template:
       src: templates/systemd/user/osd2web.service.j2
       dest: '{{ vdr.home }}/.config/systemd/user/osd2web.service'
       owner: '{{ vdr.user }}'
       group: '{{ vdr.group }}'
       mode: 0644
   
   
   - name: create irexec configuration for the session
     block:
       - template:
           src: templates/systemd/user/irexec.service.j2
           dest: '{{ vdr.home }}/.config/systemd/user/irexec.service'
           mode: 0644
           owner: '{{ vdr.user }}'
           group: '{{ vdr.group }}'
       - template:
           src: templates/.lircrc.j2
           dest: '{{ vdr.home }}/.lircrc'
           mode: 0644
           owner: '{{ vdr.user }}'
           group: '{{ vdr.group }}'
           force: no
   
   - name: link /usr/bin/start-desktop to /var/lib/vdr/plugins/desktop/starter
     file:
       src: /usr/bin/start-desktop
       dest: /var/lib/vdr/plugins/desktop/starter
       state: link
     
   - name: enable and start yavdr-xorg for the vdr user
     systemd:
       daemon_reload: yes
       name: 'yavdr-xorg'
       enabled: yes
       state: started
   

7.12.2 Templates

1. xorg configuration
   
   1. .Xresources
      

      xterm*background: Black
      xterm*foreground: grey
      XTerm*locale: true
      XTerm*metaSendsEscape: true
      XTerm*eightBitInput: false
      XTerm*backarrowKey: false
      XTerm*ttyModes: erase ^?
      Xterm*saveLines: 4096
      XTerm.vt100.metaSendsEscape: true
      XTerm.vt100.geometry: 80x32
      XTerm.vt100.renderFont: true
      xterm*faceName: xft:DejaVu Sans Mono
      xterm*faceSize: 14
      xterm*renderFont: true
      XTerm.vt100.faceName: xft:DejaVu Sans Mono:size=12:antialias=false
      XTerm.vt100.font: 7x13
      

   2. .xinitrc
      

      #!/bin/bash
      {{ ansible_managed | comment }}
      exec openbox-session
      

2. openbox
   
   1. autostart
      

      # forward environment variables to an environment file and the systemd user session
      env | grep "DISPLAY\|DBUS_SESSION_BUS_ADDRESS\|XDG_RUNTIME_DIR" > ~/.session-env
      systemctl --user import-environment DISPLAY XAUTHORITY XDG_RUNTIME_DIR DBUS_SESSION_BUS_ADDRESS
      
      feh --bg-center "/usr/share/yavdr/images/yavdr_logo.png"
      
      enabled_services=(
          "tmux.service" "detect-second-display.service"
          "openbox-second.service" "osd2web.service"
          "yavdr-frontend.service" "pulseaudio.socket"
          "pulseaudio.service" "wm-exit.service" "irexec.service")
      disabled_services=()
      
      # enable configured services for the user session
      for service in "${enabled_services[@]}"; do
        systemctl --user enable "$service"
      done
      
      # disable unwanted services for the user session
      for service in "${disabled_services[@]}"; do
        systemctl --user disable "$service"
      done
      
      if which dbus-update-activation-environment >/dev/null 2>&1; then
              dbus-update-activation-environment DISPLAY XAUTHORITY XDG_RUNTIME_DIR
      fi
      
      # start systemd units for the yavdr user session
      systemctl --user isolate yavdr-desktop.target
      

   2. rc.xml
      

      <?xml version="1.0" encoding="UTF-8"?>
      <openbox_config xmlns="http://openbox.org/3.4/rc" xmlns:xi="http://www.w3.org/2001/XInclude">
      <!-- Do not edit this file, it will be overwritten on install.
              Copy the file to $HOME/.config/openbox/ instead. -->
        <resistance>
          <strength>10</strength>
          <screen_edge_strength>20</screen_edge_strength>
        </resistance>
        <focus>
          <focusNew>yes</focusNew>
          <!-- always try to focus new windows when they appear. other rules do
             apply -->
          <followMouse>no</followMouse>
          <!-- move focus to a window when you move the mouse into it -->
          <focusLast>yes</focusLast>
          <!-- focus the last used window when changing desktops, instead of the one
             under the mouse pointer. when followMouse is enabled -->
          <underMouse>no</underMouse>
          <!-- move focus under the mouse, even when the mouse is not moving -->
          <focusDelay>200</focusDelay>
          <!-- when followMouse is enabled, the mouse must be inside the window for
             this many milliseconds (1000 = 1 sec) before moving focus to it -->
          <raiseOnFocus>no</raiseOnFocus>
          <!-- when followMouse is enabled, and a window is given focus by moving the
             mouse into it, also raise the window -->
        </focus>
        <placement>
          <policy>Smart</policy>
          <!-- 'Smart' or 'UnderMouse' -->
          <center>yes</center>
          <!-- whether to place windows in the center of the free area found or
             the top left corner -->
          <monitor>Active</monitor>
          <!-- with Smart placement on a multi-monitor system, try to place new windows
             on: 'Any' - any monitor, 'Mouse' - where the mouse is, 'Active' - where
             the active window is, 'Primary' - only on the primary monitor -->
          <primaryMonitor>Active</primaryMonitor>
          <!-- The monitor where Openbox should place popup dialogs such as the
             focus cycling popup, or the desktop switch popup.  It can be an index
             from 1, specifying a particular monitor.  Or it can be one of the
             following: 'Mouse' - where the mouse is, or
                        'Active' - where the active window is -->
        </placement>
        <theme>
          <name>Onyx</name>
          <titleLayout>NLIMC</titleLayout>
          <!--
            available characters are NDSLIMC, each can occur at most once.
            N: window icon
            L: window label (AKA title).
            I: iconify
            M: maximize
            C: close
            S: shade (roll up/down)
            D: omnipresent (on all desktops).
        -->
          <keepBorder>no</keepBorder>
          <animateIconify>yes</animateIconify>
          <font place="ActiveWindow">
            <name>sans</name>
            <size>8</size>
            <!-- font size in points -->
            <weight>bold</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
          <font place="InactiveWindow">
            <name>sans</name>
            <size>8</size>
            <!-- font size in points -->
            <weight>bold</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
          <font place="MenuHeader">
            <name>sans</name>
            <size>9</size>
            <!-- font size in points -->
            <weight>normal</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
          <font place="MenuItem">
            <name>sans</name>
            <size>9</size>
            <!-- font size in points -->
            <weight>normal</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
          <font place="ActiveOnScreenDisplay">
            <name>sans</name>
            <size>9</size>
            <!-- font size in points -->
            <weight>bold</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
          <font place="InactiveOnScreenDisplay">
            <name>sans</name>
            <size>9</size>
            <!-- font size in points -->
            <weight>bold</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
        </theme>
        <desktops>
          <!-- this stuff is only used at startup, pagers allow you to change them
             during a session
      
             these are default values to use when other ones are not already set
             by other applications, or saved in your session
      
             use obconf if you want to change these without having to log out
             and back in -->
          <number>2</number>
          <firstdesk>1</firstdesk>
          <names>
            <!-- set names up here if you want to, like this:
          <name>desktop 1</name>
          <name>desktop 2</name>
          -->
          </names>
          <popupTime>875</popupTime>
          <!-- The number of milliseconds to show the popup for when switching
             desktops.  Set this to 0 to disable the popup. -->
        </desktops>
        <resize>
          <drawContents>yes</drawContents>
          <popupShow>Nonpixel</popupShow>
          <!-- 'Always', 'Never', or 'Nonpixel' (xterms and such) -->
          <popupPosition>Center</popupPosition>
          <!-- 'Center', 'Top', or 'Fixed' -->
          <popupFixedPosition>
            <!-- these are used if popupPosition is set to 'Fixed' -->
            <x>10</x>
            <!-- positive number for distance from left edge, negative number for
               distance from right edge, or 'Center' -->
            <y>10</y>
            <!-- positive number for distance from top edge, negative number for
               distance from bottom edge, or 'Center' -->
          </popupFixedPosition>
        </resize>
        <!-- You can reserve a portion of your screen where windows will not cover when
           they are maximized, or when they are initially placed.
           Many programs reserve space automatically, but you can use this in other
           cases. -->
        <margins>
          <top>0</top>
          <bottom>0</bottom>
          <left>0</left>
          <right>0</right>
        </margins>
        <dock>
          <position>TopLeft</position>
          <!-- (Top|Bottom)(Left|Right|)|Top|Bottom|Left|Right|Floating -->
          <floatingX>0</floatingX>
          <floatingY>0</floatingY>
          <noStrut>no</noStrut>
          <stacking>Above</stacking>
          <!-- 'Above', 'Normal', or 'Below' -->
          <direction>Vertical</direction>
          <!-- 'Vertical' or 'Horizontal' -->
          <autoHide>no</autoHide>
          <hideDelay>300</hideDelay>
          <!-- in milliseconds (1000 = 1 second) -->
          <showDelay>300</showDelay>
          <!-- in milliseconds (1000 = 1 second) -->
          <moveButton>Middle</moveButton>
          <!-- 'Left', 'Middle', 'Right' -->
        </dock>
        <keyboard>
          <chainQuitKey>C-g</chainQuitKey>
          <!-- Keybindings for yavdr-frontend -->
          <keybind key="W-a">
            <action name="Execute">
            <command>frontend-dbus-send start</command>
            </action>
          </keybind>
          <keybind key="W-s">
            <action name="Execute">
            <command>frontend-dbus-send stop</command>
            </action>
          </keybind>
          <keybind key="W-x">
            <action name="Execute">
            <command>frontend-dbus-send switchbetween kodi vdr</command>
            </action>
          </keybind>
          <keybind key="XF86HomePage">
            <action name="Execute">
            <command>frontend-dbus-send toggle</command>
            </action>
          </keybind>
          <!-- Keybindings for desktop switching -->
          <keybind key="C-A-Left">
            <action name="GoToDesktop">
              <to>left</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="C-A-Right">
            <action name="GoToDesktop">
              <to>right</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="C-A-Up">
            <action name="GoToDesktop">
              <to>up</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="C-A-Down">
            <action name="GoToDesktop">
              <to>down</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="S-A-Left">
            <action name="SendToDesktop">
              <to>left</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="S-A-Right">
            <action name="SendToDesktop">
              <to>right</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="S-A-Up">
            <action name="SendToDesktop">
              <to>up</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="S-A-Down">
            <action name="SendToDesktop">
              <to>down</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="W-F1">
            <action name="GoToDesktop">
              <to>1</to>
            </action>
          </keybind>
          <keybind key="W-F2">
            <action name="GoToDesktop">
              <to>2</to>
            </action>
          </keybind>
          <keybind key="W-F3">
            <action name="GoToDesktop">
              <to>3</to>
            </action>
          </keybind>
          <keybind key="W-F4">
            <action name="GoToDesktop">
              <to>4</to>
            </action>
          </keybind>
          <keybind key="W-d">
            <action name="ToggleShowDesktop"/>
          </keybind>
          <!-- Keybindings for windows -->
          <keybind key="A-F4">
            <action name="Close"/>
          </keybind>
          <keybind key="A-Escape">
            <action name="Lower"/>
            <action name="FocusToBottom"/>
            <action name="Unfocus"/>
          </keybind>
          <keybind key="A-space">
            <action name="ShowMenu">
              <menu>client-menu</menu>
            </action>
          </keybind>
          <!-- Take a screenshot of the current window with scrot when Alt+Print are pressed -->
          <keybind key="A-Print">
            <action name="Execute">
              <command>scrot -s</command>
            </action>
          </keybind>
          <!-- Keybindings for window switching -->
          <keybind key="A-Tab">
            <action name="NextWindow">
              <finalactions>
                <action name="Focus"/>
                <action name="Raise"/>
                <action name="Unshade"/>
              </finalactions>
            </action>
          </keybind>
          <keybind key="A-S-Tab">
            <action name="PreviousWindow">
              <finalactions>
                <action name="Focus"/>
                <action name="Raise"/>
                <action name="Unshade"/>
              </finalactions>
            </action>
          </keybind>
          <keybind key="C-A-Tab">
            <action name="NextWindow">
              <panels>yes</panels>
              <desktop>yes</desktop>
              <finalactions>
                <action name="Focus"/>
                <action name="Raise"/>
                <action name="Unshade"/>
              </finalactions>
            </action>
          </keybind>
          <!-- Keybindings for window switching with the arrow keys -->
          <keybind key="W-S-Right">
            <action name="DirectionalCycleWindows">
              <direction>right</direction>
            </action>
          </keybind>
          <keybind key="W-S-Left">
            <action name="DirectionalCycleWindows">
              <direction>left</direction>
            </action>
          </keybind>
          <keybind key="W-S-Up">
            <action name="DirectionalCycleWindows">
              <direction>up</direction>
            </action>
          </keybind>
          <keybind key="W-S-Down">
            <action name="DirectionalCycleWindows">
              <direction>down</direction>
            </action>
          </keybind>
        </keyboard>
        <mouse>
          <dragThreshold>1</dragThreshold>
          <!-- number of pixels the mouse must move before a drag begins -->
          <doubleClickTime>500</doubleClickTime>
          <!-- in milliseconds (1000 = 1 second) -->
          <screenEdgeWarpTime>400</screenEdgeWarpTime>
          <!-- Time before changing desktops when the pointer touches the edge of the
             screen while moving a window, in milliseconds (1000 = 1 second).
             Set this to 0 to disable warping -->
          <screenEdgeWarpMouse>false</screenEdgeWarpMouse>
          <!-- Set this to TRUE to move the mouse pointer across the desktop when
             switching due to hitting the edge of the screen -->
          <context name="Frame">
            <mousebind button="A-Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="A-Left" action="Click">
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="A-Left" action="Drag">
              <action name="Move"/>
            </mousebind>
            <mousebind button="A-Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="A-Right" action="Drag">
              <action name="Resize"/>
            </mousebind>
            <mousebind button="A-Middle" action="Press">
              <action name="Lower"/>
              <action name="FocusToBottom"/>
              <action name="Unfocus"/>
            </mousebind>
            <mousebind button="A-Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="A-Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="C-A-Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="C-A-Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="A-S-Up" action="Click">
              <action name="SendToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="A-S-Down" action="Click">
              <action name="SendToDesktop">
                <to>next</to>
              </action>
            </mousebind>
          </context>
          <context name="Titlebar">
            <mousebind button="Left" action="Drag">
              <action name="Move"/>
            </mousebind>
            <mousebind button="Left" action="DoubleClick">
              <action name="ToggleMaximize"/>
            </mousebind>
            <mousebind button="Up" action="Click">
              <action name="if">
                <shaded>no</shaded>
                <then>
                  <action name="Shade"/>
                  <action name="FocusToBottom"/>
                  <action name="Unfocus"/>
                  <action name="Lower"/>
                </then>
              </action>
            </mousebind>
            <mousebind button="Down" action="Click">
              <action name="if">
                <shaded>yes</shaded>
                <then>
                  <action name="Unshade"/>
                  <action name="Raise"/>
                </then>
              </action>
            </mousebind>
          </context>
          <context name="Titlebar Top Right Bottom Left TLCorner TRCorner BRCorner BLCorner">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Middle" action="Press">
              <action name="Lower"/>
              <action name="FocusToBottom"/>
              <action name="Unfocus"/>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="ShowMenu">
                <menu>client-menu</menu>
              </action>
            </mousebind>
          </context>
          <context name="Top">
            <mousebind button="Left" action="Drag">
              <action name="Resize">
                <edge>top</edge>
              </action>
            </mousebind>
          </context>
          <context name="Left">
            <mousebind button="Left" action="Drag">
              <action name="Resize">
                <edge>left</edge>
              </action>
            </mousebind>
          </context>
          <context name="Right">
            <mousebind button="Left" action="Drag">
              <action name="Resize">
                <edge>right</edge>
              </action>
            </mousebind>
          </context>
          <context name="Bottom">
            <mousebind button="Left" action="Drag">
              <action name="Resize">
                <edge>bottom</edge>
              </action>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="ShowMenu">
                <menu>client-menu</menu>
              </action>
            </mousebind>
          </context>
          <context name="TRCorner BRCorner TLCorner BLCorner">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Left" action="Drag">
              <action name="Resize"/>
            </mousebind>
          </context>
          <context name="Client">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="Middle" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
          </context>
          <context name="Icon">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
              <action name="ShowMenu">
                <menu>client-menu</menu>
              </action>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="ShowMenu">
                <menu>client-menu</menu>
              </action>
            </mousebind>
          </context>
          <context name="AllDesktops">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Left" action="Click">
              <action name="ToggleOmnipresent"/>
            </mousebind>
          </context>
          <context name="Shade">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="Left" action="Click">
              <action name="ToggleShade"/>
            </mousebind>
          </context>
          <context name="Iconify">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="Left" action="Click">
              <action name="Iconify"/>
            </mousebind>
          </context>
          <context name="Maximize">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Middle" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Left" action="Click">
              <action name="ToggleMaximize"/>
            </mousebind>
            <mousebind button="Middle" action="Click">
              <action name="ToggleMaximize">
                <direction>vertical</direction>
              </action>
            </mousebind>
            <mousebind button="Right" action="Click">
              <action name="ToggleMaximize">
                <direction>horizontal</direction>
              </action>
            </mousebind>
          </context>
          <context name="Close">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Left" action="Click">
              <action name="Close"/>
            </mousebind>
          </context>
          <context name="Desktop">
            <mousebind button="Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="A-Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="A-Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="C-A-Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="C-A-Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
          </context>
          <context name="Root">
            <!-- Menus -->
            <mousebind button="Middle" action="Press">
              <action name="ShowMenu">
                <menu>client-list-combined-menu</menu>
              </action>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="ShowMenu">
                <menu>root-menu</menu>
              </action>
            </mousebind>
          </context>
          <context name="MoveResize">
            <mousebind button="Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="A-Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="A-Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
          </context>
        </mouse>
        <menu>
          <!-- You can specify more than one menu file in here and they are all loaded,
             just don't make menu ids clash or, well, it'll be kind of pointless -->
          <!-- default menu file (or custom one in $HOME/.config/openbox/) -->
          <!-- system menu files on Debian systems -->
          <file>/var/lib/openbox/debian-menu.xml</file>
          <file>menu.xml</file>
          <hideDelay>200</hideDelay>
          <!-- if a press-release lasts longer than this setting (in milliseconds), the
             menu is hidden again -->
          <middle>no</middle>
          <!-- center submenus vertically about the parent entry -->
          <submenuShowDelay>100</submenuShowDelay>
          <!-- time to delay before showing a submenu after hovering over the parent
             entry.
             if this is a negative value, then the delay is infinite and the
             submenu will not be shown until it is clicked on -->
          <submenuHideDelay>400</submenuHideDelay>
          <!-- time to delay before hiding a submenu when selecting another
             entry in parent menu
             if this is a negative value, then the delay is infinite and the
             submenu will not be hidden until a different submenu is opened -->
          <showIcons>yes</showIcons>
          <!-- controls if icons appear in the client-list-(combined-)menu -->
          <manageDesktops>yes</manageDesktops>
          <!-- show the manage desktops section in the client-list-(combined-)menu -->
        </menu>
          <!--
        # this is an example with comments through out. use these to make your
        # own rules, but without the comments of course.
        # you may use one or more of the name/class/role/title/type rules to specify
        # windows to match
      
        <application name="the window's _OB_APP_NAME property (see obxprop)"
                    class="the window's _OB_APP_CLASS property (see obxprop)"
                groupname="the window's _OB_APP_GROUP_NAME property (see obxprop)"
               groupclass="the window's _OB_APP_GROUP_CLASS property (see obxprop)"
                     role="the window's _OB_APP_ROLE property (see obxprop)"
                    title="the window's _OB_APP_TITLE property (see obxprop)"
                     type="the window's _OB_APP_TYPE property (see obxprob)..
                            (if unspecified, then it is 'dialog' for child windows)">
        # you may set only one of name/class/role/title/type, or you may use more
        # than one together to restrict your matches.
      
        # the name, class, role, and title use simple wildcard matching such as those
        # used by a shell. you can use * to match any characters and ? to match
        # any single character.
      
        # the type is one of: normal, dialog, splash, utility, menu, toolbar, dock,
        #    or desktop
      
        # when multiple rules match a window, they will all be applied, in the
        # order that they appear in this list
      
      
          # each rule element can be left out or set to 'default' to specify to not 
          # change that attribute of the window
      
          <decor>yes</decor>
          # enable or disable window decorations
      
          <shade>no</shade>
          # make the window shaded when it appears, or not
      
          <position force="no">
            # the position is only used if both an x and y coordinate are provided
            # (and not set to 'default')
            # when force is "yes", then the window will be placed here even if it
            # says you want it placed elsewhere.  this is to override buggy
            # applications who refuse to behave
            <x>center</x>
            # a number like 50, or 'center' to center on screen. use a negative number
            # to start from the right (or bottom for <y>), ie -50 is 50 pixels from
            # the right edge (or bottom). use 'default' to specify using value
            # provided by the application, or chosen by openbox, instead.
            <y>200</y>
            <monitor>1</monitor>
            # specifies the monitor in a xinerama setup.
            # 1 is the first head, or 'mouse' for wherever the mouse is
          </position>
      
          <size>
            # the size to make the window.
            <width>20</width>
            # a number like 20, or 'default' to use the size given by the application.
            # you can use fractions such as 1/2 or percentages such as 75% in which
            # case the value is relative to the size of the monitor that the window
            # appears on.
            <height>30%</height>
          </size>
      
          <focus>yes</focus>
          # if the window should try be given focus when it appears. if this is set
          # to yes it doesn't guarantee the window will be given focus. some
          # restrictions may apply, but Openbox will try to
      
          <desktop>1</desktop>
          # 1 is the first desktop, 'all' for all desktops
      
          <layer>normal</layer>
          # 'above', 'normal', or 'below'
      
          <iconic>no</iconic>
          # make the window iconified when it appears, or not
      
          <skip_pager>no</skip_pager>
          # asks to not be shown in pagers
      
          <skip_taskbar>no</skip_taskbar>
          # asks to not be shown in taskbars. window cycling actions will also
          # skip past such windows
      
          <fullscreen>yes</fullscreen>
          # make the window in fullscreen mode when it appears
      
          <maximized>true</maximized>
          # 'Horizontal', 'Vertical' or boolean (yes/no)
        </application>
      
        # end of the example
      -->
        <applications>
          <application title="softhddevice">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
          <application title="softhdcuvid">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
          <application title="vaapidevice">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
          <application class="VDR">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
          <application title="browser">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
          <application title="osd2Web">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
        </applications>
      </openbox_config>
      
      

   3. rc2.xml
      

      <?xml version="1.0" encoding="UTF-8"?>
      <openbox_config xmlns="http://openbox.org/3.4/rc" xmlns:xi="http://www.w3.org/2001/XInclude">
      <!-- Do not edit this file, it will be overwritten on install.
              Copy the file to $HOME/.config/openbox/ instead. -->
        <resistance>
          <strength>10</strength>
          <screen_edge_strength>20</screen_edge_strength>
        </resistance>
        <focus>
          <focusNew>no</focusNew>
          <!-- always try to focus new windows when they appear. other rules do
             apply -->
          <followMouse>no</followMouse>
          <!-- move focus to a window when you move the mouse into it -->
          <focusLast>yes</focusLast>
          <!-- focus the last used window when changing desktops, instead of the one
             under the mouse pointer. when followMouse is enabled -->
          <underMouse>no</underMouse>
          <!-- move focus under the mouse, even when the mouse is not moving -->
          <focusDelay>200</focusDelay>
          <!-- when followMouse is enabled, the mouse must be inside the window for
             this many milliseconds (1000 = 1 sec) before moving focus to it -->
          <raiseOnFocus>no</raiseOnFocus>
          <!-- when followMouse is enabled, and a window is given focus by moving the
             mouse into it, also raise the window -->
        </focus>
        <placement>
          <policy>Smart</policy>
          <!-- 'Smart' or 'UnderMouse' -->
          <center>yes</center>
          <!-- whether to place windows in the center of the free area found or
             the top left corner -->
          <monitor>Active</monitor>
          <!-- with Smart placement on a multi-monitor system, try to place new windows
             on: 'Any' - any monitor, 'Mouse' - where the mouse is, 'Active' - where
             the active window is, 'Primary' - only on the primary monitor -->
          <primaryMonitor>Active</primaryMonitor>
          <!-- The monitor where Openbox should place popup dialogs such as the
             focus cycling popup, or the desktop switch popup.  It can be an index
             from 1, specifying a particular monitor.  Or it can be one of the
             following: 'Mouse' - where the mouse is, or
                        'Active' - where the active window is -->
        </placement>
        <theme>
          <name>Onyx</name>
          <titleLayout>NLIMC</titleLayout>
          <!--
            available characters are NDSLIMC, each can occur at most once.
            N: window icon
            L: window label (AKA title).
            I: iconify
            M: maximize
            C: close
            S: shade (roll up/down)
            D: omnipresent (on all desktops).
        -->
          <keepBorder>no</keepBorder>
          <animateIconify>yes</animateIconify>
          <font place="ActiveWindow">
            <name>sans</name>
            <size>8</size>
            <!-- font size in points -->
            <weight>bold</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
          <font place="InactiveWindow">
            <name>sans</name>
            <size>8</size>
            <!-- font size in points -->
            <weight>bold</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
          <font place="MenuHeader">
            <name>sans</name>
            <size>9</size>
            <!-- font size in points -->
            <weight>normal</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
          <font place="MenuItem">
            <name>sans</name>
            <size>9</size>
            <!-- font size in points -->
            <weight>normal</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
          <font place="ActiveOnScreenDisplay">
            <name>sans</name>
            <size>9</size>
            <!-- font size in points -->
            <weight>bold</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
          <font place="InactiveOnScreenDisplay">
            <name>sans</name>
            <size>9</size>
            <!-- font size in points -->
            <weight>bold</weight>
            <!-- 'bold' or 'normal' -->
            <slant>normal</slant>
            <!-- 'italic' or 'normal' -->
          </font>
        </theme>
        <desktops>
          <!-- this stuff is only used at startup, pagers allow you to change them
             during a session
      
             these are default values to use when other ones are not already set
             by other applications, or saved in your session
      
             use obconf if you want to change these without having to log out
             and back in -->
          <number>2</number>
          <firstdesk>1</firstdesk>
          <names>
            <!-- set names up here if you want to, like this:
          <name>desktop 1</name>
          <name>desktop 2</name>
          -->
          </names>
          <popupTime>875</popupTime>
          <!-- The number of milliseconds to show the popup for when switching
             desktops.  Set this to 0 to disable the popup. -->
        </desktops>
        <resize>
          <drawContents>yes</drawContents>
          <popupShow>Nonpixel</popupShow>
          <!-- 'Always', 'Never', or 'Nonpixel' (xterms and such) -->
          <popupPosition>Center</popupPosition>
          <!-- 'Center', 'Top', or 'Fixed' -->
          <popupFixedPosition>
            <!-- these are used if popupPosition is set to 'Fixed' -->
            <x>10</x>
            <!-- positive number for distance from left edge, negative number for
               distance from right edge, or 'Center' -->
            <y>10</y>
            <!-- positive number for distance from top edge, negative number for
               distance from bottom edge, or 'Center' -->
          </popupFixedPosition>
        </resize>
        <!-- You can reserve a portion of your screen where windows will not cover when
           they are maximized, or when they are initially placed.
           Many programs reserve space automatically, but you can use this in other
           cases. -->
        <margins>
          <top>0</top>
          <bottom>0</bottom>
          <left>0</left>
          <right>0</right>
        </margins>
        <dock>
          <position>TopLeft</position>
          <!-- (Top|Bottom)(Left|Right|)|Top|Bottom|Left|Right|Floating -->
          <floatingX>0</floatingX>
          <floatingY>0</floatingY>
          <noStrut>no</noStrut>
          <stacking>Above</stacking>
          <!-- 'Above', 'Normal', or 'Below' -->
          <direction>Vertical</direction>
          <!-- 'Vertical' or 'Horizontal' -->
          <autoHide>no</autoHide>
          <hideDelay>300</hideDelay>
          <!-- in milliseconds (1000 = 1 second) -->
          <showDelay>300</showDelay>
          <!-- in milliseconds (1000 = 1 second) -->
          <moveButton>Middle</moveButton>
          <!-- 'Left', 'Middle', 'Right' -->
        </dock>
        <keyboard>
          <chainQuitKey>C-g</chainQuitKey>
          <!-- Keybindings for desktop switching -->
          <keybind key="C-A-Left">
            <action name="GoToDesktop">
              <to>left</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="C-A-Right">
            <action name="GoToDesktop">
              <to>right</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="C-A-Up">
            <action name="GoToDesktop">
              <to>up</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="C-A-Down">
            <action name="GoToDesktop">
              <to>down</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="S-A-Left">
            <action name="SendToDesktop">
              <to>left</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="S-A-Right">
            <action name="SendToDesktop">
              <to>right</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="S-A-Up">
            <action name="SendToDesktop">
              <to>up</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="S-A-Down">
            <action name="SendToDesktop">
              <to>down</to>
              <wrap>no</wrap>
            </action>
          </keybind>
          <keybind key="W-F1">
            <action name="GoToDesktop">
              <to>1</to>
            </action>
          </keybind>
          <keybind key="W-F2">
            <action name="GoToDesktop">
              <to>2</to>
            </action>
          </keybind>
          <keybind key="W-F3">
            <action name="GoToDesktop">
              <to>3</to>
            </action>
          </keybind>
          <keybind key="W-F4">
            <action name="GoToDesktop">
              <to>4</to>
            </action>
          </keybind>
          <keybind key="W-d">
            <action name="ToggleShowDesktop"/>
          </keybind>
          <!-- Keybindings for windows -->
          <keybind key="A-F4">
            <action name="Close"/>
          </keybind>
          <keybind key="A-Escape">
            <action name="Lower"/>
            <action name="FocusToBottom"/>
            <action name="Unfocus"/>
          </keybind>
          <keybind key="A-space">
            <action name="ShowMenu">
              <menu>client-menu</menu>
            </action>
          </keybind>
          <!-- Take a screenshot of the current window with scrot when Alt+Print are pressed -->
          <keybind key="A-Print">
            <action name="Execute">
              <command>scrot -s</command>
            </action>
          </keybind>
          <!-- Keybindings for window switching -->
          <keybind key="A-Tab">
            <action name="NextWindow">
              <finalactions>
                <action name="Focus"/>
                <action name="Raise"/>
                <action name="Unshade"/>
              </finalactions>
            </action>
          </keybind>
          <keybind key="A-S-Tab">
            <action name="PreviousWindow">
              <finalactions>
                <action name="Focus"/>
                <action name="Raise"/>
                <action name="Unshade"/>
              </finalactions>
            </action>
          </keybind>
          <keybind key="C-A-Tab">
            <action name="NextWindow">
              <panels>yes</panels>
              <desktop>yes</desktop>
              <finalactions>
                <action name="Focus"/>
                <action name="Raise"/>
                <action name="Unshade"/>
              </finalactions>
            </action>
          </keybind>
          <!-- Keybindings for window switching with the arrow keys -->
          <keybind key="W-S-Right">
            <action name="DirectionalCycleWindows">
              <direction>right</direction>
            </action>
          </keybind>
          <keybind key="W-S-Left">
            <action name="DirectionalCycleWindows">
              <direction>left</direction>
            </action>
          </keybind>
          <keybind key="W-S-Up">
            <action name="DirectionalCycleWindows">
              <direction>up</direction>
            </action>
          </keybind>
          <keybind key="W-S-Down">
            <action name="DirectionalCycleWindows">
              <direction>down</direction>
            </action>
          </keybind>
        </keyboard>
        <mouse>
          <dragThreshold>1</dragThreshold>
          <!-- number of pixels the mouse must move before a drag begins -->
          <doubleClickTime>500</doubleClickTime>
          <!-- in milliseconds (1000 = 1 second) -->
          <screenEdgeWarpTime>400</screenEdgeWarpTime>
          <!-- Time before changing desktops when the pointer touches the edge of the
             screen while moving a window, in milliseconds (1000 = 1 second).
             Set this to 0 to disable warping -->
          <screenEdgeWarpMouse>false</screenEdgeWarpMouse>
          <!-- Set this to TRUE to move the mouse pointer across the desktop when
             switching due to hitting the edge of the screen -->
          <context name="Frame">
            <mousebind button="A-Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="A-Left" action="Click">
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="A-Left" action="Drag">
              <action name="Move"/>
            </mousebind>
            <mousebind button="A-Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="A-Right" action="Drag">
              <action name="Resize"/>
            </mousebind>
            <mousebind button="A-Middle" action="Press">
              <action name="Lower"/>
              <action name="FocusToBottom"/>
              <action name="Unfocus"/>
            </mousebind>
            <mousebind button="A-Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="A-Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="C-A-Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="C-A-Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="A-S-Up" action="Click">
              <action name="SendToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="A-S-Down" action="Click">
              <action name="SendToDesktop">
                <to>next</to>
              </action>
            </mousebind>
          </context>
          <context name="Titlebar">
            <mousebind button="Left" action="Drag">
              <action name="Move"/>
            </mousebind>
            <mousebind button="Left" action="DoubleClick">
              <action name="ToggleMaximize"/>
            </mousebind>
            <mousebind button="Up" action="Click">
              <action name="if">
                <shaded>no</shaded>
                <then>
                  <action name="Shade"/>
                  <action name="FocusToBottom"/>
                  <action name="Unfocus"/>
                  <action name="Lower"/>
                </then>
              </action>
            </mousebind>
            <mousebind button="Down" action="Click">
              <action name="if">
                <shaded>yes</shaded>
                <then>
                  <action name="Unshade"/>
                  <action name="Raise"/>
                </then>
              </action>
            </mousebind>
          </context>
          <context name="Titlebar Top Right Bottom Left TLCorner TRCorner BRCorner BLCorner">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Middle" action="Press">
              <action name="Lower"/>
              <action name="FocusToBottom"/>
              <action name="Unfocus"/>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="ShowMenu">
                <menu>client-menu</menu>
              </action>
            </mousebind>
          </context>
          <context name="Top">
            <mousebind button="Left" action="Drag">
              <action name="Resize">
                <edge>top</edge>
              </action>
            </mousebind>
          </context>
          <context name="Left">
            <mousebind button="Left" action="Drag">
              <action name="Resize">
                <edge>left</edge>
              </action>
            </mousebind>
          </context>
          <context name="Right">
            <mousebind button="Left" action="Drag">
              <action name="Resize">
                <edge>right</edge>
              </action>
            </mousebind>
          </context>
          <context name="Bottom">
            <mousebind button="Left" action="Drag">
              <action name="Resize">
                <edge>bottom</edge>
              </action>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="ShowMenu">
                <menu>client-menu</menu>
              </action>
            </mousebind>
          </context>
          <context name="TRCorner BRCorner TLCorner BLCorner">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Left" action="Drag">
              <action name="Resize"/>
            </mousebind>
          </context>
          <context name="Client">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="Middle" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
          </context>
          <context name="Icon">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
              <action name="ShowMenu">
                <menu>client-menu</menu>
              </action>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="ShowMenu">
                <menu>client-menu</menu>
              </action>
            </mousebind>
          </context>
          <context name="AllDesktops">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Left" action="Click">
              <action name="ToggleOmnipresent"/>
            </mousebind>
          </context>
          <context name="Shade">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="Left" action="Click">
              <action name="ToggleShade"/>
            </mousebind>
          </context>
          <context name="Iconify">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="Left" action="Click">
              <action name="Iconify"/>
            </mousebind>
          </context>
          <context name="Maximize">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Middle" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Left" action="Click">
              <action name="ToggleMaximize"/>
            </mousebind>
            <mousebind button="Middle" action="Click">
              <action name="ToggleMaximize">
                <direction>vertical</direction>
              </action>
            </mousebind>
            <mousebind button="Right" action="Click">
              <action name="ToggleMaximize">
                <direction>horizontal</direction>
              </action>
            </mousebind>
          </context>
          <context name="Close">
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
              <action name="Unshade"/>
            </mousebind>
            <mousebind button="Left" action="Click">
              <action name="Close"/>
            </mousebind>
          </context>
          <context name="Desktop">
            <mousebind button="Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="A-Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="A-Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="C-A-Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="C-A-Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="Left" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="Focus"/>
              <action name="Raise"/>
            </mousebind>
          </context>
          <context name="Root">
            <!-- Menus -->
            <mousebind button="Middle" action="Press">
              <action name="ShowMenu">
                <menu>client-list-combined-menu</menu>
              </action>
            </mousebind>
            <mousebind button="Right" action="Press">
              <action name="ShowMenu">
                <menu>root-menu</menu>
              </action>
            </mousebind>
          </context>
          <context name="MoveResize">
            <mousebind button="Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
            <mousebind button="A-Up" action="Click">
              <action name="GoToDesktop">
                <to>previous</to>
              </action>
            </mousebind>
            <mousebind button="A-Down" action="Click">
              <action name="GoToDesktop">
                <to>next</to>
              </action>
            </mousebind>
          </context>
        </mouse>
        <menu>
          <!-- You can specify more than one menu file in here and they are all loaded,
             just don't make menu ids clash or, well, it'll be kind of pointless -->
          <!-- default menu file (or custom one in $HOME/.config/openbox/) -->
          <!-- system menu files on Debian systems -->
          <file>/var/lib/openbox/debian-menu.xml</file>
          <file>menu.xml</file>
          <hideDelay>200</hideDelay>
          <!-- if a press-release lasts longer than this setting (in milliseconds), the
             menu is hidden again -->
          <middle>no</middle>
          <!-- center submenus vertically about the parent entry -->
          <submenuShowDelay>100</submenuShowDelay>
          <!-- time to delay before showing a submenu after hovering over the parent
             entry.
             if this is a negative value, then the delay is infinite and the
             submenu will not be shown until it is clicked on -->
          <submenuHideDelay>400</submenuHideDelay>
          <!-- time to delay before hiding a submenu when selecting another
             entry in parent menu
             if this is a negative value, then the delay is infinite and the
             submenu will not be hidden until a different submenu is opened -->
          <showIcons>yes</showIcons>
          <!-- controls if icons appear in the client-list-(combined-)menu -->
          <manageDesktops>yes</manageDesktops>
          <!-- show the manage desktops section in the client-list-(combined-)menu -->
        </menu>
          <!--
        # this is an example with comments through out. use these to make your
        # own rules, but without the comments of course.
        # you may use one or more of the name/class/role/title/type rules to specify
        # windows to match
      
        <application name="the window's _OB_APP_NAME property (see obxprop)"
                    class="the window's _OB_APP_CLASS property (see obxprop)"
                groupname="the window's _OB_APP_GROUP_NAME property (see obxprop)"
               groupclass="the window's _OB_APP_GROUP_CLASS property (see obxprop)"
                     role="the window's _OB_APP_ROLE property (see obxprop)"
                    title="the window's _OB_APP_TITLE property (see obxprop)"
                     type="the window's _OB_APP_TYPE property (see obxprob)..
                            (if unspecified, then it is 'dialog' for child windows)">
        # you may set only one of name/class/role/title/type, or you may use more
        # than one together to restrict your matches.
      
        # the name, class, role, and title use simple wildcard matching such as those
        # used by a shell. you can use * to match any characters and ? to match
        # any single character.
      
        # the type is one of: normal, dialog, splash, utility, menu, toolbar, dock,
        #    or desktop
      
        # when multiple rules match a window, they will all be applied, in the
        # order that they appear in this list
      
      
          # each rule element can be left out or set to 'default' to specify to not 
          # change that attribute of the window
      
          <decor>yes</decor>
          # enable or disable window decorations
      
          <shade>no</shade>
          # make the window shaded when it appears, or not
      
          <position force="no">
            # the position is only used if both an x and y coordinate are provided
            # (and not set to 'default')
            # when force is "yes", then the window will be placed here even if it
            # says you want it placed elsewhere.  this is to override buggy
            # applications who refuse to behave
            <x>center</x>
            # a number like 50, or 'center' to center on screen. use a negative number
            # to start from the right (or bottom for <y>), ie -50 is 50 pixels from
            # the right edge (or bottom). use 'default' to specify using value
            # provided by the application, or chosen by openbox, instead.
            <y>200</y>
            <monitor>1</monitor>
            # specifies the monitor in a xinerama setup.
            # 1 is the first head, or 'mouse' for wherever the mouse is
          </position>
      
          <size>
            # the size to make the window.
            <width>20</width>
            # a number like 20, or 'default' to use the size given by the application.
            # you can use fractions such as 1/2 or percentages such as 75% in which
            # case the value is relative to the size of the monitor that the window
            # appears on.
            <height>30%</height>
          </size>
      
          <focus>yes</focus>
          # if the window should try be given focus when it appears. if this is set
          # to yes it doesn't guarantee the window will be given focus. some
          # restrictions may apply, but Openbox will try to
      
          <desktop>1</desktop>
          # 1 is the first desktop, 'all' for all desktops
      
          <layer>normal</layer>
          # 'above', 'normal', or 'below'
      
          <iconic>no</iconic>
          # make the window iconified when it appears, or not
      
          <skip_pager>no</skip_pager>
          # asks to not be shown in pagers
      
          <skip_taskbar>no</skip_taskbar>
          # asks to not be shown in taskbars. window cycling actions will also
          # skip past such windows
      
          <fullscreen>yes</fullscreen>
          # make the window in fullscreen mode when it appears
      
          <maximized>true</maximized>
          # 'Horizontal', 'Vertical' or boolean (yes/no)
        </application>
      
        # end of the example
      -->
        <applications>
          <application title="softhddevice">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
          <application title="softhdcuvid">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
          <application title="vaapidevice">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
          <application class="VDR">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
          <application title="browser">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
          <application title="osd2Web">
            <decor>no</decor>
            <maximized>yes</maximized>
            <!--<skip_pager>yes</skip_pager>-->
            <skip_taskbar>no</skip_taskbar>
          </application>
        </applications>
      </openbox_config>
      
      

3. Systemd User Session
   
   1. yavdr-desktop.target
      

      [Unit]
      Description=yaVDR Desktop
      Requires=default.target
      After=default.target pulseaudio.service
      Wants=dbus.service pulseaudio.service
      AllowIsolate=yes
      

   2. detect-second-display
      

      #!/bin/bash
      source <(systemctl --user show-environment)
      SECOND_DISPLAY="${DISPLAY%\.[0-9]*}.1"
      if xrandr -d "$SECOND_DISPLAY" -q | grep -q "connected"; then
          [ "$DISPLAY" != "$SECOND_DISPLAY" ] && d="DISPLAY=$SECOND_DISPLAY" || d="DISPLAY=$DISPLAY"
          echo "$d" > ~/.second_display;
      else
          rm -f ~/.second_display
      fi
      

      [Unit]
      Description=Detect second DISPLAY using xrandr
      
      [Service]
      Type=oneshot
      RemainAfterExit=yes
      ExecStart=%h/bin/detect-second-display
      
      [Install]
      WantedBy=yavdr-desktop.target
      

   3. switch-displays
      

      This script exchanges the primary and secondary screen. It needs access to the systemd user session.

      #!/bin/bash
      source <(systemctl --user show-environment)
      [[ "$DISPLAY" =~ \.1$ ]] && DISPLAY="${DISPLAY%.1}.0" || DISPLAY="${DISPLAY%.0}.1"
      
      frontend-dbus-send stop
      systemctl --user stop osd2web
      frontend-dbus-send setDisplay "$DISPLAY"
      systemctl --user start osd2web
      frontend-dbus-send start
      

   4. openbox-second.service
      

      [Unit]
      Description=Start openbox on the second DISPLAY if it exists
      After=detect-second-display.service
      Wants=detect-second-display.service
      Before=yavdr-frontend.service
      ConditionFileNotEmpty=%h/.second_display
      
      [Service]
      EnvironmentFile=%h/.second_display
      ExecStart=/usr/bin/openbox --config-file %h/.config/openbox/rc2.xml
      ExecStartPost=/usr/bin/xset -dpms s off -display $DISPLAY
      ExecStartPost=/bin/bash %h/.fehbg
      
      [Install]
      WantedBy=yavdr-desktop.target
      

   5. osd2web.service
      

      [Unit]
      Description=Start a kiosk browser on the second DISPLAY if it exists
      After=detect-second-display.service openbox-second.service
      Wants=detect-second-display.service openbox-second.service
      ConditionFileNotEmpty=%h/.second_display
      
      [Service]
      EnvironmentFile=%h/.second_display
      Environment=url="http://localhost:4444/skins/horchiTft/index.html?theme=anthraize&onlyView=1"
      Environment=browser="kiosk-browser"
      EnvironmentFile=-%h/.config/osd2web/config
      ExecStart=/usr/bin/on_vdr -o -c '${browser} "${url}"'
      KillSignal=SIGINT
      
      [Install]
      WantedBy=yavdr-desktop.target
      

   6. tmux.service
      

      [Unit]
      Description=Start tmux in detached session
      
      [Service]
      EnvironmentFile=-%h/.session-env
      Type=forking
      ExecStart=/usr/bin/tmux new-session -s use-session -d
      ExecStop=/usr/bin/tmux kill-session -t %u
      Restart=always
      
      [Install]
      WantedBy=default.target
      

   7. wm-exit.service
      

      [Unit]
      Description=exit window manager gracefully
      
      [Service]
      ExecStart=/bin/true
      ExecStop=/usr/bin/openbox --exit
      RemainAfterExit=True
      
      [Install]
      WantedBy=default.target
      

4. irexec
   

   irexec.service starts irexec for the user session

   [Unit]
   Description=LIRC command handler
   
   [Service]
   Type=simple
   ExecStart=/usr/bin/irexec %h/.lircrc
   
   [Install]
   WantedBy=yavdr-desktop.target
   

   ~/.lircrc contains the irexec configuration

   begin
       prog = irexec
       button = KEY_HOME
       config = frontend-dbus-send switchbetween kodi vdr
   end