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: '{{ item }}'
       state: present
       install_recommends: no
     with_items:
       '{{ packages }}'
   

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-387 and other required packages
     apt:
       name: '{{ item }}'
       state: present
       install_recommends: no
     with_items:
       - nvidia-390
       - nvidia-settings
     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
     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: yes
        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: '{{ item }}'
          state: present
          install_recommends: no
        with_items:
          - anacron
          - acl
          - at
          - bash-completion
          #- biosdevname  # caution: may change device names after a minimal installation!
          - debconf-utils
          - linux-firmware
          - psmisc
          - python-kmodpy
          - python-requests
          - python-usb
          - python3-usb
          - software-properties-common
          - ssh
          - wget
          - wpasupplicant
          - usbutils
          - xfsprogs
      
      

   7. Install additional packages (user defined)
      

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

   8. create directories
      

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";

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: 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: '{{ item }}'
       state: present
       install_recommends: no
     with_items:
       - vdr
       - vdrctl
       - vdr-plugin-dbus2vdr
   

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: '{{ item }}'
       state: present
       install_recommends: no
     with_items:
       '{{ vdr_plugins | default({}) }}'
     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
   

7.5.2 templates

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: '{{ item }}'
      state: present
      install_recommends: no
  with_items:
      - avahi-daemon
      - avahi-utils
      #- biosdevname # caution: this may change device names after a minimal installation!
      - ethtool
      - nfs-common
      - vdr-addon-avahi-linker
      - wakeonlan

# 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 TODO avahi-services für NFS beim Stoppen des nfs-kernel-servers depublizieren, beim Start wieder announcen

7.7.2 tasks

---

- name: install nfs server packages
  apt:
    name: '{{ item }}'
    state: present
    install_recommends: no
  with_items:
    - nfs-kernel-server
    - nfs-common

- 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.7.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.iteritems() %}
   {{ 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.8.1 default variables

lircd0_socket: /var/run/lirc/lircd0

7.8.2 tasks

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

- name: apt | install packages for remote support
  apt:
    name: '{{ item }}'
    state: present
  with_items:
    - yavdr-remote
    - lirc
    - eventlircd
    - lircd2uinput
  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: 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.8.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
   

   #
   # 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
   *   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             hauppauge
   #*  rc-imon-mce              imon_mce
   #*  rc-imon-pad              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-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               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 rc-hauppauge            /lib/udev/rc_keymaps/rc-hauppaugetwin         # 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
   
   # Hauppauge PVR 350
   ir-kbd-i2c  rc-hauppauge    /lib/udev/rc_keymaps/rc-hauppauge
   
   # imon-pad
   imon        rc-imon-pad /lib/udev/rc_keymaps/rc-imon-pad
   imon        rc-imon-mce /lib/udev/rc_keymaps/rc-imon-mce
   
   # TT-1500/1501
   *           rc-tt-1500  /lib/udev/rc_keymaps/rc-tt-1500
   budget_ci   rc-tt-1500  /lib/udev/rc_keymaps/rc-tt-1501
   
   # rc-rc6-mce
   *           rc-rc6-mce  /lib/udev/rc_keymaps/rc-rc6-mce
   # CIR
   ite-cir     rc-rc6-mce  /lib/udev/rc_keymaps/rc-rc6-mce
   nuvoton-cir rc-rc6-mce  /lib/udev/rc_keymaps/rc-rc6-mce
   
   # mceusb
   mceusb      rc-rc6-mce  /lib/udev/rc_keymaps/HOPLOrc6
   
   # 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
   

7.8.4 files

7.9.1 tasks

---

- name: apt | install pulseaudio, pavucontrol and vdr-plugin-pulsecontrol
  apt:
    name: '{{ item }}'
    state: present
    install_recommends: no
  with_items:
    - pulseaudio
    - pavucontrol
    - vdr-plugin-pulsecontrol

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

7.9.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.10.1 About the GUI session

7.10.2 default variables

first_run: False

7.10.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 | start vdr.service after network-online.target
     template:
       src: templates/systemd/network-online.j2
       dest: /etc/systemd/system/vdr.service.d/network-online.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'
         # - '-a pulse' # do we need this with our existing asound.conf?
   
   - 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: '{{ item }}'
       state: present
     with_items:
       - xlogin
       - 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
   
   - name: download yavdr logo
     block:
       - file:
           dest: '/usr/share/yavdr/images'
           state: directory
    
       - get_url:
           url: 'https://github.com/yavdr/yavdr-base/raw/master/images/yavdr_logo.png'
           dest: '/usr/share/yavdr/images/yavdr_logo.png'
   
   - 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: '{{ item }}'
       state: present
     with_items:
       - xterm
       - firefox
       - kiosk-browser
   

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: Stop VDR
     systemd:
       name: vdr.service
       state: stopped
       enabled: yes
     notify: ['Start VDR']
   
   - 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"
     action: xrandr_facts
   
   - debug:
       var: xorg.primary
   
   - debug:
       var: xorg.secondary
     when: xorg.secondary 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
     when:
       - xrandr is defined
       - xorg is defined
   
   - name: update xorg and xrandr variable with values from local facts if needed
     set_fact:
       xorg: '{{ ansible_local.xorg }}'
       xrandr: '{{ ansible_local.xrandr }}'
     when:
       - xrandr is undefined
       - xorg 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
   
   

7.10.4 templates

1. 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. .xinitrc
      

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

   5. xorg.conf snippets
      

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

   6. xorg.conf
      

      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=On, ForceFullCompositionPipeline=On}"
          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=On, ForceFullCompositionPipeline=On}"
          Option         "AllowIndirectGLXProtocol" "off"
          Option         "TripleBuffer" "on"
          Option         "SLI" "Off"
          Option         "MultiGPU" "Off"
          Option         "BaseMosaic" "off"
          SubSection     "Display"
              Depth       24
          EndSubSection
      EndSection
      {% endif %}
      

      {{ 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 %}
      

2. vdr
   

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

   [Unit]
   After=network-online.target
   

7.11.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'
   
   - 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: 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 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 }}'
   
   - 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 xlogin for the vdr user
     systemd:
       daemon_reload: yes
       name: 'xlogin@{{ vdr.user }}'
       enabled: yes
       state: started
   

7.11.2 Templates

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
   

[Unit]
Description=LIRC command handler

[Service]
Type=simple
ExecStart=/usr/bin/irexec %h/.lircrc

[Install]
WantedBy=yavdr-desktop.target

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

7.12.1 tasks

---
# file: roles/samba-install/tasks/main.yml

- name: install samba server
  apt:
    name: '{{ item }}'
    state: present
    install_recommends: no
  with_items:
    - samba
    - samba-common
    - samba-common-bin
    - tdb-tools

7.13.1 tasks

---
# file: roles/samba-config/tasks/main.yml

# TODO:
# - name: divert original smbd.conf

- name: touch smb.conf.custom
  file:
    state: touch
    dest: '/etc/samba/smb.conf.custom'
  notify: [ 'Restart Samba' ]
    
- name: expand template for smb.conf
  template:
    src: 'templates/smb.conf.j2'
    dest: '/etc/samba/smb.conf'
    #validate: 'testparm -s %s'
  notify: [ 'Restart Samba' ]

7.13.2 templates

1. smb.conf
   
   1. global settings
      

      {{ ansible_managed | comment }}
      
      #======================= Global Settings =======================
      
      [global]
      
      ## Browsing/Identification ###
      
      # Change this to the workgroup/NT-domain name your Samba server will part of
         workgroup = {{ samba.workgroup }}
      
      # server string is the equivalent of the NT Description field
         server string = %h server (Samba, Ubuntu)
      
      # This will prevent nmbd to search for NetBIOS names through DNS.
         dns proxy = no
      
      #### Debugging/Accounting ####
      
      # This tells Samba to use a separate log file for each machine
      # that connects
         log file = /var/log/samba/log.%m
      
      # Cap the size of the individual log files (in KiB).
         max log size = 1000
      
      # We want Samba to log a minimum amount of information to syslog. Everything
      # should go to /var/log/samba/log.{smbd,nmbd} instead. If you want to log
      # through syslog you should set the following parameter to something higher.
         syslog = 0
      
      # Do something sensible when Samba crashes: mail the admin a backtrace
         panic action = /usr/share/samba/panic-action %d
      
      
      ####### Authentication #######
      
      # "security = user" is always a good idea. This will require a Unix account
      # in this server for every user accessing the server. See
      # /usr/share/doc/samba-doc/htmldocs/Samba3-HOWTO/ServerType.html
      # in the samba-doc package for details.
      #   security = user
      
      # You may wish to use password encryption.  See the section on
      # 'encrypt passwords' in the smb.conf(5) manpage before enabling.
         encrypt passwords = true
      
      # If you are using encrypted passwords, Samba will need to know what
      # password database type you are using.  
         passdb backend = tdbsam
      
         obey pam restrictions = yes
      
      # This boolean parameter controls whether Samba attempts to sync the Unix
      # password with the SMB password when the encrypted SMB password in the
      # passdb is changed.
         unix password sync = yes
      
      # For Unix password sync to work on a Debian GNU/Linux system, the following
      # parameters must be set (thanks to Ian Kahan <<kahan@informatik.tu-muenchen.de> for
      # sending the correct chat script for the passwd program in Debian Sarge).
         passwd program = /usr/bin/passwd %u
         passwd chat = *Enter\snew\s*\spassword:* %n\n *Retype\snew\s*\spassword:* %n\n *password\supdated\ssuccessfully* .
      
      # This boolean controls whether PAM will be used for password changes
      # when requested by an SMB client instead of the program listed in
      # 'passwd program'. The default is 'no'.
         pam password change = yes
      
      # This option controls how unsuccessful authentication attempts are mapped 
      # to anonymous connections
         map to guest = bad user
      
      {% if samba.windows_compatible %}
      # disable unix extensions and enable following symlinks
         unix extensions = no
         follow symlinks= yes
         wide links= yes
      {% endif %}
      

   2. media directories
      

      {% for name, path in media_dirs.iteritems() %}
      [{{ name }}]
         path = {{ path }}
         comment = {{ name }} on %h
         guest ok = yes
         writeable = yes
         browseable = yes
         create mode = 0664
         directory mode = 0775
         force user = {{ vdr.user }}
         force group = {{ vdr.group }}
         follow symlinks = yes
         wide links = yes
      
      {% endfor %}
      

   3. include custom samba exports
      

      include = /etc/samba/smb.conf.custom
      

7.14.1 TODO sundtek for Sundtek devices (local or network connection)

7.14.2 TODO dddvb-dkms if only newer DD cards are detected

7.14.3 TODO media-build-experimental (up to kernel 4.8) for „old“ cards like TT S2-6400 FF

7.14.4 TODO newly merged DD drivers

7.15.1 tasks

---
# file roles/autoinstall-ubuntu-drivers/tasks/main.yml

- name: autoinstall ubuntu-drivers-common
  block:
    - name: apt | install ubuntu-drivers-common
      apt:
        name: ubuntu-drivers-common
        state: present

    - name: use ubuntu-drivers to install additional drivers automatically
      command: ubuntu-drivers --package-list /etc/yavdr/autoinstalled autoinstall
  when: (ansible_virtualization_type != "virtualbox" and ansible_virtualization_role != "guest") or
        ansible_distribution_version != "16.04"
        # ubuntu-drivers-common tries to autoinstall
        # conflicting packages for virtualbox in Ubuntu 16.04 :(

7.17.1 dependencies

---
dependencies:
    - { role: collect-facts }
    - { role: yavdr-remote }

7.17.2 tasks

---
# file roles/autoinstall-atric-usb/tasks/main.yml

- name: install and configure Atric IR-WakeupUSB
  block:
    - name: apt | install lirc-drv-irman
      apt:
        name: lirc-drv-irman
        state: present
      tags:
        - packages

    - name: write lirc configuration
      template:
        src: templates/lirc_options.conf.j2
        dest: /etc/lirc/lirc_options.conf
      tags:
        - config
        - systemd

    - name: enable lircd, eventlircd, lircd2uinput
      systemd:
        name: '{{ item }}'
        enabled: yes
        state: started
        masked: no
        daemon_reload: yes
      with_items:
        - eventlircd.socket
        - eventlircd.service
        - lircd2uinput.service
        - lircd.service
      tags:
        - systemd

  when: '"04d8:f844" in usb'

7.17.3 templates

{{ ansible_managed | comment }}

[lircd]
nodaemon        = False
driver          = irman
device          = /dev/irman
output          = /var/run/lirc/lircd0
pidfile         = /var/run/lirc/lircd0.pid
plugindir       = /usr/lib/x86_64-linux-gnu/lirc/plugins
permission      = 666
allow-simulate  = No
repeat-max      = 600
#loglevel       = 6
#release        = true
#release_suffix = _EVUP
#logfile        = ...
#driver-options = ...

[lircmd]
uinput          = False
nodaemon        = False

7.18.1 dependencies

---
dependencies:
    - { role: yavdr-remote }

7.18.2 tasks

---
# file roles/autoinstall-atric-usb/tasks/main.yml

- name: install and configure Atric IR-WakeupUSB
  block:
    - name: apt | install lirc-drv-yausbir
      apt:
        name: lirc-drv-yausbir
        state: present
      tags:
        - packages

    - name: write lirc configuration
      template:
        src: templates/lirc_options.conf.j2
        dest: /etc/lirc/lirc_options.conf
      tags:
        - config
        - systemd

    - name: enable lircd, eventlircd, lircd2uinput
      systemd:
        name: '{{ item }}'
        enabled: yes
        state: started
        masked: no
        daemon_reload: yes
      with_items:
        - eventlircd.socket
        - eventlircd.service
        - lircd2uinput.service
        - lircd.service
      tags:
        - systemd

  when: '"10c4:876c" in usb'

7.18.3 templates

{{ ansible_managed | comment }}

[lircd]
nodaemon        = False
driver          = ya_usbir
output          = /var/run/lirc/lircd0
pidfile         = /var/run/lirc/lircd0.pid
plugindir       = /usr/lib/x86_64-linux-gnu/lirc/plugins
permission      = 666
allow-simulate  = No
repeat-max      = 600
#loglevel       = 6
#release        = true
#release_suffix = _EVUP
#logfile        = ...
#driver-options = ...

[lircmd]
uinput          = False
nodaemon        = False

7.19.1 tasks

---
# file roles/autoinstall-satip/tasks/main.yml

- name: "detect SAT>IP Server(s) on the network"
  action: satip_facts

- debug:
    var: satip_devices
    verbosity: 1

- name: apt | install vdr-plugin-satip if a Sat>IP server has been detected
  apt:
    name: vdr-plugin-satip
    state: present
  when: satip_devices
  notify: [ 'Restart VDR' ]

7.20.1 tasks

---
# file roles/autoinstall-targavfd/tasks/main.yml

- name: apt | install vdr-plugin-targavfd if connected
  apt:
    name: vdr-plugin-targavfd
  when: '"19c2:6a11" in usb'
  notify: [ 'Restart VDR' ]

7.21.1 tasks

---
# file roles/autoinstall-imonlcd/tasks/main.yml

- name: apt | install vdr-plugin-imonlcd if connected
  apt:
    name: vdr-plugin-imonlcd
  when: '"15c2:0038" in usb or "15c2:ffdc" in usb'
  notify: [ 'Restart VDR' ]

7.22.1 tasks

---
# file roles/autoinstall-libcec-daemon/tasks/main.yml

- name: apt | install libcec-daemon if connected
  apt:
    name: libcec-daemon
  when: 
    - "2548:1002" in usb

7.23.1 tasks

---
# file roles/autoinstall-pvr350/tasks/main.yml

- name: apt | install vdr-plugin-pvr350 if connected
  apt:
    name: vdr-plugin-pvr350
  when: '"0070:4000" in pci'
  notify: [ 'Restart VDR' ]

7.25.1 dependencies

---
dependencies:
  - { role: collect-facts }

7.25.2 tasks

---

# This role provides easyily downloadable firmware files

- name: Firmware for Hauppauge WinTV HD Solo/Duo, PCTV 292e
  get_url:
    url: https://github.com/OpenELEC/dvb-firmware/raw/master/firmware/dvb-demod-si2168-b40-01.fw
    checksum: sha256:8507536630d75a316d0719d6b95c04b90c36baa5b457ad457c9bacadafcef134
    dest: /lib/firmware/dvb-demod-si2168-b40-01.fw
  when: '"2040:0264" in usb or "2013:025f" in usb'

- name: Firmware for Hauppauge WinTV-HVR-930C
  get_url:
    url: https://github.com/OpenELEC/dvb-firmware/raw/master/firmware/dvb-fe-xc5000-1.6.114.fw
    checksum: sha256:7104bda8df301fe1bd4c09de1708aeb6d0d8e1f9d55505449fecfad82639235f
    dest: /lib/firmware/dvb-fe-xc5000-1.6.114.fw
  when: '"2040:1605" in usb'

7.26.1 dependencies

---
dependencies:
  - { role: collect-facts }

7.26.2 defaults

---
# file roles/autoinstall-dvbsky-firmware
dvbsky_firmware_files: []

7.26.3 tasks

---
# file roles/autoinstall-dvbsky-firmware/tasks/main.yml

- name: determine needed firmware files by device ids
  block:
    - name: add firmware files for DVBSky if a card has been detected
      set_fact:
        dvbsky_firmware_files: ['dvb-demod-m88ds3103.fw', 'dvb-demod-m88rs6000.fw', 'dvb-tuner-si2158-a20-01.fw', 'dvb-demod-si2168-a20-01.fw', 'dvb-demod-si2168-a30-01.fw', 'dvb-demod-si2168-b40-01.fw', 'dvb-fe-ds300x.fw', 'dvb-fe-ds3103.fw', 'dvb-fe-rs6000.fw']
      when:
        - '"1ade:3038" in pci'
  when:
    - not dvbsky_firmware_files

- name: Download firmware for DVBSky cards and copy required files to /lib/firmware
  block:
    # download and extract firmware
    - unarchive:
        src: http://www.dvbsky.net/download/linux/dvbsky-firmware.tar.gz
        dest: /tmp/
        remote_src: yes

    # copy firmware file
    - copy:
        src: "/tmp/dvbsky-firmware/{{ item }}"
        dest: /lib/firmware/
        owner: root
        group: root
        mode: 0644
      with_items: '{{ dvbsky_firmware_files }}'
      notify: ['Trigger Udev']

    # Remove temporary files
    - file:
        path: /tmp/dvbsky-firmware
        state: absent
  when:
    - dvbsky_firmware_files is defined
    - dvbsky_firmware_files
  tags:
    - install
    - autodetect
    - dvbsky

7.27.1 dependencies

---
dependencies:
    - { role: collect-facts }

7.27.2 tasks

---
# file roles/autoinstall-dvbhddevice/tasks/main.yml

- name: apt | install vdr-plugin-dvbhddevice if connected
  apt:
    name: vdr-plugin-dvbhddevice
  when: '"13c2:300a" in pci or "13c2:300b" in pci'
  notify: [ 'Restart VDR' ]

7.28.1 dependencies

---
dependencies:
  - { role: collect-facts }

7.28.2 tasks

---
# file roles/autoinstall-dvbsddevice/tasks/main.yml

# TODO: install firmware

- name: apt | install vdr-plugin-dvbsddevice if module is loaded
  apt:
    name: vdr-plugin-dvbsddevice
  when: '"dvb_ttpci" in modules'
  notify: [ 'Restart VDR' ]

7.29.1 dependencies

---
dependencies:
  - { role: collect-facts }

7.29.2 tasks

---
# file roles/autoinstall-hardware-irmp/tasks/main.yml

- name: apt | install yavdr-hardware-irmp if connected
  apt:
    name: yavdr-hardware-irmp
    state: present
  when: '"1209:4444" in usb or "16c0:27d9" in usb'

7.30.1 tasks

1. Install KODI
   
   • main.yml
     

     - import_tasks: install-kodi.yml tags=install,update,kodi:install
     - import_tasks: configure-kodi.yml tags=install,update,kodi:configure
     

   • install-kodi.yml
     

     ---
     
     - name: apt | install kodi packages
       apt:
         name: '{{ item }}'
         state: present
         install_recommends: no
       with_items:
         - kodi
         - kodi-pvr-vdr-vnsi
         - kodi-eventclients-kodi-send # for ubuntu packages, team-xbmc uses "kodi-eventclients-xbmc-send for some reason
     

   • configure-kodi.yml
     

     - name: create kodi.service for the user session
       template:
           src: 'templates/kodi.service.j2'
           dest: '{{ vdr.home }}/.config/systemd/user/kodi.service'
           mode: 0644
           owner: '{{ vdr.user }}'
           group: '{{ vdr.group }}'
     
     - name: create kodi user directory
       file:
           dest: '{{ vdr.home }}/{{ item }}'
           state: directory
           owner: '{{ vdr.user }}'
           group: '{{ vdr.group }}'
           mode: "0775"
       with_items:
           - .kodi
           - .kodi/userdata
           - .kodi/userdata/keymaps
     
     - name: copy Lircmap.xml if it does not exist yet
       copy:
           dest: '{{ vdr.home }}/.kodi/userdata/Lircmap.xml'
           src: 'files/userdata/Lircmap.xml'
           owner: '{{ vdr.user }}'
           group: '{{ vdr.group }}'    
           mode: "0664"
           force: no
     
     - name: copy remote.xml if it does not exist yet
       copy:
           dest: '{{ vdr.home }}/.kodi/userdata/keymaps/remote.xml'
           src: 'files/userdata/keymaps/remote.xml'
           owner: '{{ vdr.user }}'
           group: '{{ vdr.group }}'    
           mode: "0664"
           force: no
     # TODO: Add configuration files
     

7.30.2 templates

1. kodi.service
   

   This systemd unit for the user session starts (and stops) kodi.

   [Unit]
   Description=Start kodi in user session
   
   [Service]
   Type=simple
   PassEnvironment=DISPLAY XDG_RUNTIME_DIR DBUS_SESSION_BUS_ADDRESS
   ExecStartPre=-/usr/bin/set-kodi-display
   ExecStart=/usr/bin/kodi -l /run/lirc/lircd
   ExecStop=/bin/bash -c "/usr/bin/kodi-send --action=QUIT; while ps -p $MAINPID -o comm=; do sleep .25; done"
   TimeoutStopSec=10
   SuccessExitStatus=0 127
   Restart=on-failure
   

7.30.3 files

1. Lircmap.xml
   

   This file allows to map keys sent by remotes via eventlircd (which uses the name devinput) to kodi key names.

   <lircmap>
       <remote device="linux-input-layer">
       <altname>cx23885_remote</altname>
       <altname>devinput</altname>
           <up>KEY_UP</up>
           <down>KEY_DOWN</down>
                   <menu>KEY_MENU</menu>
           <select>KEY_OK</select>
           <back>KEY_ESC</back>
           <left>KEY_LEFT</left>
           <right>KEY_RIGHT</right>
           <red>KEY_RED</red>
           <green>KEY_GREEN</green>
           <yellow>KEY_YELLOW</yellow>
           <blue>KEY_BLUE</blue>
           <zero>KEY_0</zero>
           <one>KEY_1</one>
           <two>KEY_2</two>
           <three>KEY_3</three>
           <four>KEY_4</four>
           <five>KEY_5</five>
           <six>KEY_6</six>
           <seven>KEY_7</seven>
           <eight>KEY_8</eight>
           <nine>KEY_9</nine>
           <info>KEY_INFO</info>
           <play>KEY_PLAY</play>
           <play>KEY_PLAYPAUSE</play>
           <pause>KEY_PAUSE</pause>
           <stop>KEY_STOP</stop>
           <record>KEY_RECORD</record>
           <forward>KEY_FASTFORWARD</forward>
           <reverse>KEY_REWIND</reverse>
           <skipplus>KEY_NEXT</skipplus>
           <skipminus>KEY_BACK</skipminus>
           <power>KEY_POWER2</power>
           <channelplus>KEY_CHANNELUP</channelplus>
           <channelminus>KEY_CHANNELDOWN</channelminus>
           <title>KEY_PROG3</title>
           <volumeplus>KEY_VOLUMEUP</volumeplus>
           <volumeminus>KEY_VOLUMEDOWN</volumeminus>
                   <teletext>KEY_TEXT</teletext>
           <mute>KEY_MUTE</mute>
           <start>KEY_SELECT</start>
           <subtitle>KEY_SUBTITLE</subtitle>
                   <audio>KEY_MODE</audio>
           <mute>KEY_MUTE</mute>
           <myvideo>KEY_VIDEO</myvideo>
           <mymusic>KEY_AUDIO</mymusic>
           <mypictures>KEY_IMAGES</mypictures>
           <recordedtv>KEY_PVR</recordedtv>
                   <guide>KEY_EPG</guide>
                   <display>KEY_SCREEN</display>
                   <enter>KEY_PROG4</enter>
                   <playlist>KEY_ZOOM</playlist>
                   <livetv>KEY_CHANNEL</livetv>
                   <mytv>KEY_TV</mytv>
                   <liveradio>KEY_FN</liveradio>
       </remote>
   </lircmap>
   

2. keymaps
   

   This file maps the keys defined in Lircmap.xml to actions within kodi.

   1. remote.xml
      

      <!-- This file contains the mapping of keys (gamepad, remote, and keyboard) to actions within XBMC -->
      <!-- The <global> section is a fall through - they will only be used if the button is not          -->
      <!-- used in the current window's section.  Note that there is only handling                       -->
      <!-- for a single action per button at this stage.                                                 -->
      <!-- For joystick/gamepad configuration under linux/win32, see below as it differs from xbox       -->
      <!-- gamepads.                                                                                     -->
      
      <!-- The format is:                      -->
      <!--    <device>                         -->
      <!--      <button>action</button>        -->
      <!--    </device>                        -->
      
      <!-- To map keys from other remotes using the RCA protocol, you may add <universalremote> blocks -->
      <!-- In this case, the tags used are <obc#> where # is the original button code (OBC) of the key -->
      <!-- You set it up by adding a <universalremote> block to the window or <global> section:       -->
      <!--    <universalremote>             -->
      <!--       <obc45>Stop</obc45>         -->
      <!--    </universalremote>            -->
      <!-- To find out the OBC's of your remote, try enabling the <displayremotecodes> tag in AdvancedSettings.xml -->
      
      <!-- Note that the action can be a built-in function.                 -->
      <!--  eg <B>XBMC.ActivateWindow(MyMusic)</B>                         -->
      <!-- would automatically go to My Music on the press of the B button. -->
      
      <!-- Joysticks / Gamepads:                                                                    -->
      <!--   See the sample PS3 controller configuration below for the format.                      -->
      <!--                                                                                          -->
      <!--  Joystick Name:                                                                          -->
      <!--   Do 'cat /proc/bus/input/devices' or see your xbmc log file  to find the names of       -->
      <!--   detected joysticks. The name used in the configuration should match the detected name. -->
      <!--                                                                                          -->
      <!--  Button Ids:                                                                             -->
      <!--   'id' is the button ID used by SDL. Joystick button ids of connected joysticks appear   -->
      <!--   in xbmc.log when they are pressed. Use your log to map custom buttons to actions.      -->
      <!--                                                                                          -->
      <!--  Axis Ids / Analog Controls                                                              -->
      <!--   Coming soon.                                                                           -->
      <keymap>
        <global>
          <universalremote>
             <obc150>XBMC.ejecttray()</obc150>
             <obc151>Playlist</obc151>
          </universalremote>
          <remote>
            <play>PlayPause</play>
            <pause>Pause</pause>
            <stop>Stop</stop>
            <forward>FastForward</forward>
            <reverse>Rewind</reverse>
            <left>Left</left>
            <right>Right</right>
            <up>Up</up>
            <down>Down</down>
            <select>Select</select>
            <pageplus>PageUp</pageplus>
            <pageminus>PageDown</pageminus>
            <back>ParentDir</back>
            <menu>PreviousMenu</menu>
            <title>ContextMenu</title>
            <info>Info</info>
            <skipplus>SkipNext</skipplus>
            <skipminus>SkipPrevious</skipminus>
            <display>FullScreen</display>
            <start>PreviousMenu</start>
            <record>Screenshot</record>
            <volumeplus>VolumeUp</volumeplus>
            <volumeminus>VolumeDown</volumeminus>
            <mute>Mute</mute>
            <power>XBMC.Quit()</power>
            <myvideo>XBMC.ActivateWindow(MyVideos)</myvideo>
            <mymusic>XBMC.ActivateWindow(MyMusic)</mymusic>
            <mypictures>XBMC.ActivateWindow(MyPictures)</mypictures>
            <!--- <mytv>XBMC.ActivateWindow(Home)</mytv> -->
            <recordedtv>XBMC.ActivateWindowAndFocus(MyPVR, 34,0, 13,0)</recordedtv>
            <!-- PVR: EPG -->
            <guide>XBMC.ActivateWindowAndFocus(MyPVR, 31,0, 10,0)</guide>
            <!-- PVR: Channellist -->
            <livetv>XBMC.ActivateWindowAndFocus(MyPVR, 32,0, 11,0)</livetv>
            <!-- PVR: Radio -->
            <liveradio>XBMC.ActivateWindowAndFocus(MyPVR, 33,0, 12,0)</liveradio>
            <red>XBMC.ActivateWindow(Home)</red>
            <yellow>XBMC.ActivateWindow(MyVideos)</yellow>
            <green>XBMC.ActivateWindow(MyMusic)</green>
            <!-- <blue>XBMC.ActivateWindow(MyPictures)</blue> -->
            <zero>Number0</zero>
            <one>Number1</one>
            <two>JumpSMS2</two>
            <three>JumpSMS3</three>
            <four>JumpSMS4</four>
            <five>JumpSMS5</five>
            <six>JumpSMS6</six>
            <seven>JumpSMS7</seven>
            <eight>JumpSMS8</eight>
            <nine>JumpSMS9</nine>
            <audio>AudioNextLanguage</audio>
            <subtitle>ShowSubtitles</subtitle>
            <enter>FullScreen</enter>
            <blue>ContextMenu</blue>
            <playlist>XBMC.ActivateWindow(MyMusicPlaylist)</playlist>
          </remote>
        </global>
        <Home>
          <remote>
            <menu>XBMC.Skin.ToggleSetting(HomeViewToggle)</menu>
            <info>XBMC.ActivateWindow(SystemInfo)</info>
            <clear>XBMC.ActivateWindow(Weather)</clear>
            <blue>XBMC.ActivateWindow(Settings)</blue>
            <red>FullScreen</red>
            <back>FullScreen</back>
          </remote>
        </Home>
        <MyFiles>
          <remote>
            <clear>Delete</clear>
          </remote>
        </MyFiles>
        <MyMusicPlaylist>
          <remote>
            <back>Playlist</back>      <!-- Close playlist -->
            <clear>Delete</clear>
          </remote>
        </MyMusicPlaylist>
        <MyMusicPlaylistEditor>
          <remote>
            <zero>Queue</zero>
          </remote>
        </MyMusicPlaylistEditor>
        <MyMusicFiles>
          <remote>
            <zero>Queue</zero>
            <star>Queue</star>
            <start>ContextMenu</start>
          </remote>
        </MyMusicFiles>
        <MyMusicLibrary>
          <remote>
            <zero>Queue</zero>
            <star>Queue</star>
          </remote>
        </MyMusicLibrary>
        <FullscreenVideo>
          <remote>
            <back>FullScreen</back>
            <zero>Number0</zero>
            <one>Number1</one>
            <two>Number2</two>
            <three>Number3</three>
            <four>Number4</four>
            <five>Number5</five>
            <six>Number6</six>
            <seven>Number7</seven>
            <eight>Number8</eight>
            <nine>Number9</nine>
            <left>Rewind</left>
            <right>FastForward</right>
            <up>Play</up>
            <down>Pause</down>
            <yellow>StepForward</yellow>
            <green>StepBack</green>
            <blue>CodecInfo</blue>
            <menu>OSD</menu>
            <start>OSD</start>
            <info>XBMC.ActivateWindow(PVROSDChannels)</info>
            <title>XBMC.ActivateWindow(PVROSDChannels)</title>
            <display>AspectRatio</display>
            <select>Info</select>
            <teletext>XBMC.ActivateWindow(Teletext)</teletext>
            <channelplus>SkipNext</channelplus>
            <channelminus>SkipPrevious</channelminus>
            <record>XBMC.PlayerControl(Record)</record>
          </remote>
        </FullscreenVideo>
        <FullscreenInfo>
          <remote>
            <back>FullScreen</back>
            <left>Rewind</left>
            <right>FastForward</right>
            <up>Play</up>
            <down>Pause</down>
            <yellow>StepForward</yellow>
            <green>StepBack</green>
            <display>AspectRatio</display>
            <info>CodecInfo</info>
            <select>Close</select>
            <menu>OSD</menu>
          </remote>
        </FullscreenInfo>
        <PlayerControls>
          <remote>
            <back>Close</back>
            <menu>Close</menu>
          </remote>
        </PlayerControls>
        <Visualisation>
          <universalremote>
             <obc151>XBMC.ActivateWindow(MyMusicPlaylist)</obc151>
          </universalremote>
          <remote>
            <red>FullScreen</red>
            <yellow>AnalogSeekForward</yellow>
            <green>AnalogSeekBack</green>
            <blue>CodecInfo</blue>
            <left>Rewind</left>
            <right>FastForward</right>
            <pageplus>SkipNext</pageplus>
            <pageminus>SkipPrevious</pageminus>
            <up>Play</up>
            <down>Pause</down>
            <info>XBMC.ActivateWindow(PVROSDChannels)</info>
            <back>XBMC.ActivateWindow(MyMusicPlaylist)</back>
            <select>Info</select>
            <menu>XBMC.ActivateWindow(MusicOSD)</menu>
            <start>XBMC.ActivateWindow(MusicOSD)</start>
          </remote>
        </Visualisation>
        <MusicOSD>
          <remote>
            <back>Close</back>
            <menu>Close</menu>
            <start>Close</start>
            <info>CodecInfo</info>
          </remote>
        </MusicOSD>
        <VisualisationSettings>
          <remote>
            <back>Close</back>
            <menu>Close</menu>
          </remote>
        </VisualisationSettings>
        <VisualisationPresetList>
          <remote>
            <back>Close</back>
            <menu>Close</menu>
          </remote>
        </VisualisationPresetList>
        <SlideShow>
          <remote>
            <zero>ZoomNormal</zero>
            <one>ZoomLevel1</one>
            <two>ZoomLevel2</two>
            <three>ZoomLevel3</three>
            <four>ZoomLevel4</four>
            <five>ZoomLevel5</five>
            <six>ZoomLevel6</six>
            <seven>ZoomLevel7</seven>
            <eight>ZoomLevel8</eight>
            <nine>ZoomLevel9</nine>
            <info>CodecInfo</info>
            <pageplus>ZoomIn</pageplus>
            <pageminus>ZoomOut</pageminus>
            <select>Rotate</select>
            <up>Pause</up>
            <down>Play</down>
            <back>PreviousMenu</back>
          </remote>
        </SlideShow>
        <ScreenCalibration>
          <remote>
            <select>NextCalibration</select>
            <enter>NextCalibration</enter>
            <zero>ResetCalibration</zero>
            <display>NextResolution</display>
            <xbox>NextResolution</xbox>
          </remote>
        </ScreenCalibration>
        <GUICalibration>
          <remote>
            <select>NextCalibration</select>
            <enter>NextCalibration</enter>
            <zero>ResetCalibration</zero>
          </remote>
        </GUICalibration>
        <SelectDialog>
          <remote>
            <back>Close</back>
          </remote>
        </SelectDialog>
        <VideoOSD>
          <remote>
            <back>PreviousMenu</back>
            <menu>Close</menu>
            <start>Close</start>
          </remote>
        </VideoOSD>
        <VideoMenu>
          <remote>
            <menu>OSD</menu>
            <back>PreviousMenu</back>
            <info>Info</info>
            <title>CodecInfo</title>
            <zero>Number0</zero>
            <one>Number1</one>
            <two>Number2</two>
            <three>Number3</three>
            <four>Number4</four>
            <five>Number5</five>
            <six>Number6</six>
            <seven>Number7</seven>
            <eight>Number8</eight>
            <nine>Number9</nine>
          </remote>
        </VideoMenu>
        <OSDVideoSettings>
          <remote>
            <back>Close</back>
            <menu>Close</menu>
            <start>Close</start>
          </remote>
        </OSDVideoSettings>
        <OSDAudioSettings>
          <remote>
            <back>Close</back>
            <menu>Close</menu>
            <start>Close</start>
          </remote>
        </OSDAudioSettings>
        <VideoBookmarks>
          <remote>
            <back>Close</back>
            <menu>Close</menu>
            <start>Close</start>
            <zero>Delete</zero>
          </remote>
        </VideoBookmarks>
        <MyVideoLibrary>
          <remote>
            <zero>Queue</zero>
            <clear>Delete</clear>
            <green>ToggleWatched</green>
            <yellow>Queue</yellow>
          </remote>
        </MyVideoLibrary>
        <MyVideoFiles>
          <remote>
            <zero>Queue</zero>
            <star>Queue</star>
            <blue>ContextMenu</blue>
            <green>ToggleWatched</green>
            <yellow>Queue</yellow>
          </remote>
        </MyVideoFiles>
        <MyPictures>
          <remote>
            <zero>Queue</zero>
            <star>Queue</star>
            <start>ContextMenu</start>
          </remote>
        </MyPictures>
        <MyVideoPlaylist>
          <remote>
            <back>Playlist</back>      <!-- Close playlist -->
            <clear>Delete</clear>
            <zero>Delete</zero>
          </remote>
        </MyVideoPlaylist>
        <VirtualKeyboard>
          <remote>
            <back>BackSpace</back>
            <star>Shift</star>
            <hash>Symbols</hash>
            <zero>Number0</zero>
            <one>Number1</one>
            <two>Number2</two>
            <three>Number3</three>
            <four>Number4</four>
            <five>Number5</five>
            <six>Number6</six>
            <seven>Number7</seven>
            <eight>Number8</eight>
            <nine>Number9</nine>
            <pageminus>CursorLeft</pageminus>
            <pageplus>CursorRight</pageplus>
          </remote>
        </VirtualKeyboard>
        <ContextMenu>
          <remote>
            <blue>Close</blue>
            <back>Close</back>
          </remote>
        </ContextMenu>
        <FileStackingDialog>
          <remote>
            <back>Close</back>
          </remote>
        </FileStackingDialog>
        <Scripts>
          <remote>
            <info>XBMC.ActivateWindow(ScriptsDebugInfo)</info>
          </remote>
        </Scripts>
        <ScriptsDebugInfo>
          <remote>
            <info>Info</info>      <!-- clears debug python info -->
          </remote>
        </ScriptsDebugInfo>
        <NumericInput>
          <remote>
            <zero>Number0</zero>
            <one>Number1</one>
            <two>Number2</two>
            <three>Number3</three>
            <four>Number4</four>
            <five>Number5</five>
            <six>Number6</six>
            <seven>Number7</seven>
            <eight>Number8</eight>
            <nine>Number9</nine>
            <back>BackSpace</back>
          </remote>
        </NumericInput>
        <Weather>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </Weather>
        <Settings>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </Settings>
        <MyPicturesSettings>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </MyPicturesSettings>
        <MyProgramsSettings>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </MyProgramsSettings>
        <MyWeatherSettings>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </MyWeatherSettings>
        <MyMusicSettings>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </MyMusicSettings>
        <SystemSettings>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </SystemSettings>
        <MyVideosSettings>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </MyVideosSettings>
        <NetworkSettings>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </NetworkSettings>
        <AppearanceSettings>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </AppearanceSettings>
        <Profiles>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </Profiles>
        <systeminfo>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </systeminfo>
        <shutdownmenu>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </shutdownmenu>
        <submenu>
          <remote>
            <back>PreviousMenu</back>
          </remote>
        </submenu>
        <MusicInformation>
          <remote>
            <back>Close</back>
          </remote>
        </MusicInformation>
        <MovieInformation>
          <remote>
            <back>Close</back>
          </remote>
        </MovieInformation>
        <LockSettings>
          <remote>
            <menu>Close</menu>
            <back>PreviousMenu</back>
          </remote>
        </LockSettings>
        <ProfileSettings>
          <remote>
            <menu>Close</menu>
            <back>PreviousMenu</back>
          </remote>
        </ProfileSettings>
        <PictureInfo>
          <remote>
            <skipplus>NextPicture</skipplus>
            <skipminus>PreviousPicture</skipminus>
            <info>Close</info>
            <back>Close</back>
          </remote>
        </PictureInfo>
        <Teletext>
          <remote>
            <zero>number0</zero>
            <one>number1</one>
            <two>number2</two>
            <three>number3</three>
            <four>number4</four>
            <five>number5</five>
            <six>number6</six>
            <seven>number7</seven>
            <eight>number8</eight>
            <nine>number9</nine>
            <red>Red</red>
            <green>Green</green>
            <yellow>Yellow</yellow>
            <blue>Blue</blue>
            <info>Info</info>
            <back>Close</back>
            <menu>Close</menu>
            <start>Close</start>
            <teletext>Close</teletext>
          </remote>
        </Teletext>
        <Favourites>
          <remote>
            <back>Close</back>
          </remote>
        </Favourites>
      </keymap>