diff --git a/Manual.html b/Manual.html index 3ce8839..9a3201f 100644 --- a/Manual.html +++ b/Manual.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Ansible Playbooks for yaVDR 0.7 @@ -240,260 +240,261 @@ for the JavaScript code in this tag.

Inhaltsverzeichnis

-
-

1 User Stories

+
+

1 User Stories

-
-

1.1 yavdr-full

+
+

1.1 yavdr-full

A User wants to install yaVDR without customization and relies on full automation. @@ -526,22 +527,22 @@ Several roles are used to tie everything together:

-
-

1.1.1 Using vdr, pulseaudio and xorg together

+
+

1.1.1 Using vdr, pulseaudio and xorg together

-
-

2 Introduction

+
+

2 Introduction

One of the major problems we faced with customized Ubuntu ISO files as installation media for prior yaVDR versions has been the limited hardware support and the time consuming process to create and update them. An interesting alternative to this approach is to enable the user to choose the installation medium by himself, so point releases, kernel versions and additional drivers can be chosen deliberately. After the basic setup is complete (and a working internet connection is available), a fully customizable install script completes the yaVDR installation.

-
-

3 Installing and configuring yaVDR with Ansible

+
+

3 Installing and configuring yaVDR with Ansible

This is an experimental feature which allows to set up a yaVDR installation based on a normal Ubuntu Server 16.04.x installation using Ansible. @@ -576,8 +577,8 @@ We use a callback to generate tags for all roles autmatically:

-
-

3.1 Install script for local usage

+
+

3.1 Install script for local usage

if (( $EUID != 0 )); then
@@ -598,12 +599,12 @@ ansible-playbook yavdr07.yml -b -i 'localhost_inventory
 
-
-

4 Playbooks

+
+

4 Playbooks

-
-

4.1 yavdr07.yml

+
+

4.1 yavdr07.yml

The yavdr07.yml playbook sets up a fully-featured yaVDR installation: @@ -654,8 +655,8 @@ The yavdr07.yml playbook sets up a fully-featured yaVDR installatio

-
-

4.2 yavdr07-headless.yml

+
+

4.2 yavdr07-headless.yml

For a headless server installation yavdr07-headless.yml is a good choice @@ -688,8 +689,8 @@ For a headless server installation yavdr07-headless.yml is a good c

-
-

5 Hosts

+
+

5 Hosts

This playbook can either be used to run the installation on the localhost or any other PC in the network that can be accessed via ssh. Simply add the host names or IP addresses to the hosts file in the respective section: @@ -703,12 +704,12 @@ This playbook can either be used to run the installation on the localhost or any

-
-

6 Group Variables

+
+

6 Group Variables

-
-

6.1 PPAs

+
+

6.1 PPAs

---
@@ -726,8 +727,8 @@ This playbook can either be used to run the installation on the localhost or any
 
-
-

6.2 VDR user, directories, special configuration and plugins

+
+

6.2 VDR user, directories, special configuration and plugins

# properties of the user vdr and vdr-related options
@@ -748,14 +749,13 @@ This playbook can either be used to run the installation on the localhost or any
 vdr_plugins:
   - vdr-plugin-devstatus
   - vdr-plugin-markad
-  - vdr-plugin-restfulapi
   - vdr-plugin-softhddevice-vpp
 
-
-

6.3 Media directories

+
+

6.3 Media directories

# dictionary of directories for (shared) files. Automatically exported via NFS and Samba if those roles are enabled
@@ -770,8 +770,8 @@ This playbook can either be used to run the installation on the localhost or any
 
-
-

6.4 NFS

+
+

6.4 NFS

nfs:
@@ -780,8 +780,8 @@ This playbook can either be used to run the installation on the localhost or any
 
-
-

6.5 Samba

+
+

6.5 Samba

samba:
@@ -791,8 +791,8 @@ This playbook can either be used to run the installation on the localhost or any
 
-
-

6.6 Additional packages

+
+

6.6 Additional packages

# additional packages you want to install
@@ -808,8 +808,8 @@ This playbook can either be used to run the installation on the localhost or any
 
-
-

6.7 System pre-configuration

+
+

6.7 System pre-configuration

frontend: vdr
@@ -824,20 +824,20 @@ This playbook can either be used to run the installation on the localhost or any
 
-
-

7 Roles

+
+

7 Roles

-
-

7.1 install-dependencies

+
+

7.1 install-dependencies

-
-

7.1.1 tasks

+
+

7.1.1 tasks

    -
  1. main.yml
    +
  2. main.yml
    ---
    @@ -858,19 +858,19 @@ This playbook can either be used to run the installation on the localhost or any
     
    -
    -

    7.2 nvidia experimental drivers

    +
    +

    7.2 nvidia experimental drivers

    install nvidia-396 from ppa:graphics-drivers/ppa

    -
    -

    7.2.1 tasks

    +
    +

    7.2.1 tasks

      -
    1. main.yml
      +
    2. main.yml
      ---
      @@ -900,15 +900,15 @@ install nvidia-396 from ppa:graphics-drivers/ppa
       
    -
    -

    7.3 yavdr-common

    +
    +

    7.3 yavdr-common

    This role is used to set up a basic yaVDR installation. It creates the directories, installs the vdr and other useful packages.

    -
    -

    7.3.1 default variables

    +
    +

    7.3.1 default variables

    This section is for reference only, please use the files in global_vars for customizations. @@ -921,7 +921,7 @@ This section is for reference only, please use the files in global_vars

      -
    1. Repositories
      +
    2. 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. @@ -938,7 +938,7 @@ You can set a list of package repositories which provide the necessary packages.

  3. -
  4. Drivers
    +
  5. 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. @@ -951,7 +951,7 @@ Automatically installed drivers can be very useful, but if you know you need a c

-
  • Additional Packages
    +
  • Additional Packages

    Add additional packages you would like to have on your installation to this list @@ -965,7 +965,7 @@ Add additional packages you would like to have on your installation to this list

  • -
  • VDR
    +
  • VDR

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

  • -
    -

    7.3.2 tasks

    +
    +

    7.3.2 tasks

    yavdr-common executes the following tasks:

      -
    1. main.yml
      +
    2. main.yml
      ---
      @@ -1023,7 +1023,7 @@ yavdr-common executes the following tasks:
       
        -
      1. Disable default installation of recommended packages
        +
      2. Disable default installation of recommended packages

        This task prevents apt to automatically install all recommended dependencies for packages: @@ -1040,14 +1040,14 @@ This task prevents apt to automatically install all recommended dependencies for

    -
  • Set up package repositories
    +
  • Set up package repositories
    - name: add PPAs
       apt_repository:
           repo: '{{ item }}'
           state: present
    -      update_cache: yes
    +      update_cache: no
       with_items: '{{ repositories }}'
       tags:
         - ppa
    @@ -1060,22 +1060,34 @@ This task prevents apt to automatically install all recommended dependencies for
     
  • -
  • Use bash instead of dash
    +
  • Use bash instead of dash
    -
    - name: use bash instead of dash
    -  shell: |
    -    echo "set dash/sh false" | debconf-communicate
    -    dpkg-reconfigure -f noninteractive dash
    +
    - name: apt | ensure debconf and debconf-utils are installed
    +  apt:
    +    name: "{{ packages }}"
    +  vars:
    +    packages:
    +    - debconf
    +    - debconf-utils
    +
    +- name: use bash instead of dash by default
    +  debconf:
    +    name: dash
    +    question: dash/sh
    +    value: 'false'
    +    vtype: select
    +  notify: ['Reconfigure unattended upgrades with dpkg']
    +
     
  • -
  • create user vdr
  • -
  • Disable release-upgrade notifications
    +
  • create user vdr
  • +
  • Disable release-upgrade notifications
      -
    1. SOMEDAY move from lineinfile to template
      +
    2. SOMEDAY move from lineinfile to template
      - name: disable release-upgrade notifications
      @@ -1097,7 +1109,7 @@ This task prevents apt to automatically install all recommended dependencies for
       
  • -
  • Install essential packages
    +
  • Install essential packages
    - name: apt | install basic packages
    @@ -1129,7 +1141,7 @@ This task prevents apt to automatically install all recommended dependencies for
     
  • -
  • Install additional packages (user defined)
    +
  • Install additional packages (user defined)
    - name: apt | install extra packages
    @@ -1143,14 +1155,14 @@ This task prevents apt to automatically install all recommended dependencies for
     
  • -
  • create directories
  • -
  • create sudoers drop-in for vdr
  • +
  • create directories
  • +
  • create sudoers drop-in for vdr
  • -
    -

    7.3.3 templates

    +
    +

    7.3.3 templates

    {{ ansible_managed | comment('c') }}
    @@ -1161,7 +1173,7 @@ APT::Install-Suggests "0";
     
      -
    1. yavdr sudoers drop-in
      +
    2. yavdr sudoers drop-in

      Allow the vdr user to restart vdr.service and reboot the system @@ -1176,12 +1188,12 @@ Allow the vdr user to restart vdr.service and reboot the system

    -
    -

    7.4 collect facts about the system with custom modules

    +
    +

    7.4 collect facts about the system with custom modules

    -
    -

    7.4.1 variables

    +
    +

    7.4.1 variables

    first_run: False
    @@ -1189,12 +1201,12 @@ Allow the vdr user to restart vdr.service and reboot the system
     
    -
    -

    7.4.2 tasks

    +
    +

    7.4.2 tasks

      -
    1. main.yml
      +
    2. main.yml
      - name: get information about usb and pci hardware and loaded kernel modules
      @@ -1234,16 +1246,16 @@ Allow the vdr user to restart vdr.service and reboot the system
       
    -
    -

    7.5 vdr

    +
    +

    7.5 vdr

    -
    -

    7.5.1 tasks

    +
    +

    7.5.1 tasks

      -
    1. install the basic vdr packages
      +
    2. install the basic vdr packages
      ---
      @@ -1262,7 +1274,7 @@ Allow the vdr user to restart vdr.service and reboot the system
       
    3. -
    4. Add svdrp/svdrp-disc to /etc/services
      +
    5. Add svdrp/svdrp-disc to /etc/services
      - name: add svdrp and svdrp-disc to /etc/services
      @@ -1277,7 +1289,7 @@ Allow the vdr user to restart vdr.service and reboot the system
       
    6. -
    7. Set up the recording directory for the vdr user
      +
    8. Set up the recording directory for the vdr user
      - name: create vdr recdir
      @@ -1312,7 +1324,7 @@ Allow the vdr user to restart vdr.service and reboot the system
       
    9. -
    10. Install additional vdr plugins
      +
    11. Install additional vdr plugins

      The additional plugins to install can be set in the variable {{vdr_plugins}} in the group variables @@ -1330,7 +1342,7 @@ The additional plugins to install can be set in the variable {{vdr_plugins

    -
  • copy vdr configuration files (if they don’t exist yet)
    +
  • copy vdr configuration files (if they don’t exist yet)
    - name: ensure vdr is stopped
    @@ -1361,7 +1373,7 @@ The additional plugins to install can be set in the variable {{vdr_plugins
     
  • -
  • start vdr after network-online.target
    +
  • start vdr after network-online.target
    - name: create directory for vdr.service systemd drop-in files
    @@ -1382,8 +1394,8 @@ The additional plugins to install can be set in the variable {{vdr_plugins
     
     
    -
    -

    7.5.2 templates

    +
    +

    7.5.2 templates

    Start after network-online.target @@ -1395,12 +1407,12 @@ Start after network-online.target

    -
    -

    7.5.3 files

    +
    +

    7.5.3 files

      -
    1. remote.conf
      +
    2. remote.conf
      LIRC.Up KEY_UP
      @@ -1535,7 +1547,7 @@ XKeySym.Next       XF86AudioNext
       
    3. -
    4. keymacros.conf
      +
    5. keymacros.conf
      # Remote control key macros for VDR
      @@ -1561,12 +1573,12 @@ User0     @osdteletext
       
    -
    -

    7.6 STARTED yavdr-network

    +
    +

    7.6 STARTED yavdr-network

    -
    -

    7.6.1 default variables

    +
    +

    7.6.1 default variables

    install_avahi: true
    @@ -1574,8 +1586,8 @@ User0     @osdteletext
     
    -
    -

    7.6.2 tasks

    +
    +

    7.6.2 tasks

    ---
    @@ -1645,15 +1657,15 @@ User0     @osdteletext
     
    -
    -

    7.7 nfs-server

    +
    +

    7.7 nfs-server

    -
    -

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

    +
    +

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

    -
    -

    7.7.2 tasks

    +
    +

    7.7.2 tasks

    ---
    @@ -1682,12 +1694,12 @@ User0     @osdteletext
     
    -
    -

    7.7.3 templates

    +
    +

    7.7.3 templates

      -
    1. /etc/exports
      +
    2. /etc/exports
      /srv *(rw,fsid=0,sync,no_subtree_check,all_squash,anongid={{ vdr.gid }},anonuid={{ vdr.uid }})
      @@ -1698,7 +1710,7 @@ User0     @osdteletext
       
    3. -
    4. avahi services
      +
    5. avahi services
      <?xml version="1.0" standalone='no'?>
      @@ -1719,12 +1731,13 @@ User0     @osdteletext
       
    -
    -

    7.8 STARTED yavdr-remote

    + +
    +

    7.8 STARTED yavdr-remote

    -
    -

    7.8.1 default variables

    +
    +

    7.8.1 default variables

    lircd0_socket: /var/run/lirc/lircd0
    @@ -1732,8 +1745,8 @@ User0     @osdteletext
     
    -
    -

    7.8.2 tasks

    +
    +

    7.8.2 tasks

    ---
    @@ -1806,12 +1819,12 @@ User0     @osdteletext
     
    -
    -

    7.8.3 templates

    +
    +

    7.8.3 templates

      -
    1. Systemd Drop-in to start vdr with lirc support
      +
    2. Systemd Drop-in to start vdr with lirc support
      {% if frontend != 'kodi' %}
      @@ -1822,7 +1835,7 @@ User0     @osdteletext
       
    3. -
    4. Systemd Drop-in to start lircd2uinput with lircd
      +
    5. Systemd Drop-in to start lircd2uinput with lircd
      [Service]
      @@ -1832,10 +1845,11 @@ User0     @osdteletext
       
    6. -
    7. create /etc/rc_maps.cfg
      +
    8. create /etc/rc_maps.cfg
      -
      #
      +
      {{ ansible_managed | comment }}
      +#
       # Keymaps table
       #
       # This table creates an association between a keycode file and a kernel
      @@ -2023,17 +2037,17 @@ ati_remote    rc-medion-x10-digitainer   /lib/udev/rc_keymaps/rc-medion-x10-digi
       
    -
    -

    7.8.4 files

    +
    +

    7.8.4 files

    -
    -

    7.9 pulseaudio

    +
    +

    7.9 pulseaudio

    -
    -

    7.9.1 tasks

    +
    +

    7.9.1 tasks

    ---
    @@ -2056,8 +2070,8 @@ ati_remote    rc-medion-x10-digitainer   /lib/udev/rc_keymaps/rc-medion-x10-digi
     
    -
    -

    7.9.2 templates

    +
    +

    7.9.2 templates

    # Use PulseAudio by default
    @@ -2079,12 +2093,13 @@ ati_remote    rc-medion-x10-digitainer   /lib/udev/rc_keymaps/rc-medion-x10-digi
     
    -
    -

    7.10 yavdr-xorg

    + +
    +

    7.10 yavdr-xorg

    -
    -

    7.10.1 About the GUI session

    +
    +

    7.10.1 About the GUI session

    The X-Server is started by using the two systemd units xlogin@.service and x@.service provided by the package xlogin. The former is enabled (and started) for the vdr user - which results (using the default settings for the user vdr with the uid 666) in the activation of xlogin@vdr.service when reaching the graphical.target. To simplify starting and stopping the X-server and the desktop session a yavdr-xorg.service is provided by the package yavdr-xorg, which depends on the two units mentioned before. @@ -2113,8 +2128,8 @@ In order to achive a clean shutdown of the session, x@t7.service is

    -
    -

    7.10.2 default variables

    +
    +

    7.10.2 default variables

    first_run: False
    @@ -2137,12 +2152,12 @@ In order to achive a clean shutdown of the session, x@t7.service is
     
    -
    -

    7.10.3 tasks

    +
    +

    7.10.3 tasks

      -
    1. main.yml
      +
    2. main.yml
      ---
      @@ -2155,7 +2170,7 @@ In order to achive a clean shutdown of the session, x@t7.service is
       
    3. -
    4. setup-xorg.yml
      +
    5. setup-xorg.yml
      ---
      @@ -2276,7 +2291,7 @@ In order to achive a clean shutdown of the session, x@t7.service is
       
    6. -
    7. detect-xorg.yml
      +
    8. detect-xorg.yml
      ---
      @@ -2432,21 +2447,76 @@ In order to achive a clean shutdown of the session, x@t7.service is
         when:
           - nvidia_detected
       
      +
      +
      +
      +
    9. +
    10. intel.yml
      +
      +

      +KMS drivers (like for intel (i915) and amd (radeon)) require additional configuration beneath 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
      • +
      • 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. +

      +
      +
      - 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.10.4 templates

    +
    +

    7.10.4 templates

      -
    1. xorg
      +
    2. grub
      +
      +
      +
      {% 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={{ xorg.primary.drm_connector }}:{{ xorg.primary.mode|replace('_', '@') }}{{ output_flag }} drm.edid_firmware={{ xorg.primary.drm_connector }}:edid/edid.bin"
      +# TODO: configure additional monitors (second monitor on, all others off)
      +
      +
      +
      +
    3. +
    4. xorg
        -
      1. x-verbose@.service
        -
        +
      2. x-verbose@.service
        +
        # file: roles/yavdr-xorg/templates/systemd/system/x-verbose@.service.j2
         [Unit]
        @@ -2461,8 +2531,8 @@ In order to achive a clean shutdown of the session, x@t7.service is
         
      3. -
      4. Drop-in snippet for x@.service
        -
        +
      5. Drop-in snippet for x@.service
        +
        [Unit]
         After=plymouth.service
        @@ -2487,8 +2557,8 @@ In order to achive a clean shutdown of the session, x@t7.service is
         
      6. -
      7. Drop-in snippet for vdr.service
        -
        +
      8. Drop-in snippet for vdr.service
        +
        {{ ansible_managed | comment }}
         [Unit]
        @@ -2499,8 +2569,8 @@ In order to achive a clean shutdown of the session, x@t7.service is
         
      9. -
      10. xorg.conf snippets
        -
        +
      11. xorg.conf snippets
        +
        {{ ansible_managed | comment }}
         
        @@ -2513,8 +2583,8 @@ EndSection
         
      12. -
      13. xorg.conf
        -
        +
      14. xorg.conf
        +
        Section "Device"
                 Identifier "nvidia"
        @@ -2839,8 +2909,8 @@ EndSection
         
    5. -
    6. vdr
      -
      +
    7. vdr
      +

      Set environment variables for system locale and user session on startup

      @@ -2855,18 +2925,47 @@ Set environment variables for system locale and user session on startup
    +
    +

    7.10.5 files

    +
    +
    +
      +
    1. initramfs EDID hook
      +
      +
      +
      #!/bin/bash
      +# Created by yavdr-ansible.
      +# 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
      +
      +
      +
      +
    2. +
    +
    -
    -

    7.11 yavdr-desktop

    +
    +

    7.11 yavdr-desktop

    -
    -

    7.11.1 Tasks

    +
    +

    7.11.1 Tasks

      -
    1. main.yml
      +
    2. main.yml
      ---
      @@ -2916,6 +3015,14 @@ Set environment variables for system locale and user session on startup
             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'
      @@ -3007,14 +3114,14 @@ Set environment variables for system locale and user session on startup
       
    -
    -

    7.11.2 Templates

    +
    +

    7.11.2 Templates

      -
    1. xorg configuration
      +
    2. xorg configuration
        -
      1. .Xresources
        +
      2. .Xresources
        xterm*background: Black
        @@ -3037,7 +3144,7 @@ XTerm.vt100.font: 7x13
         
      3. -
      4. .xinitrc
        +
      5. .xinitrc
        #!/bin/bash
        @@ -3049,9 +3156,9 @@ XTerm.vt100.font: 7x13
         
    3. -
    4. openbox
      +
    5. openbox
        -
      1. autostart
        +
      2. autostart
        # forward environment variables to an environment file and the systemd user session
        @@ -3087,7 +3194,7 @@ systemctl --user isolate yavdr-desktop.target
         
      3. -
      4. rc.xml
        +
      5. rc.xml
        <?xml version="1.0" encoding="UTF-8"?>
        @@ -3903,6 +4010,826 @@ systemctl --user isolate yavdr-desktop.target
           </applications>
         </openbox_config>
         
        +
        +
        +
        +
      6. +
      7. 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="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>
        +
         
        @@ -3910,9 +4837,9 @@ systemctl --user isolate yavdr-desktop.target
    6. -
    7. Systemd User Session
      +
    8. Systemd User Session
        -
      1. yavdr-desktop.target
        +
      2. yavdr-desktop.target
        [Unit]
        @@ -3925,7 +4852,7 @@ systemctl --user isolate yavdr-desktop.target
         
      3. -
      4. detect-second-display
        +
      5. detect-second-display
        [Unit]
        @@ -3941,7 +4868,7 @@ systemctl --user isolate yavdr-desktop.target
         
      6. -
      7. openbox-second.service
        +
      8. openbox-second.service
        [Unit]
        @@ -3953,7 +4880,7 @@ systemctl --user isolate yavdr-desktop.target
         
         [Service]
         EnvironmentFile=%h/.second_display
        -ExecStart=/usr/bin/openbox --config-file %h/.config/openbox/rc.xml
        +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
         
        @@ -3963,7 +4890,7 @@ systemctl --user isolate yavdr-desktop.target
         
      9. -
      10. osd2web.service
        +
      11. osd2web.service
        [Unit]
        @@ -3986,7 +4913,7 @@ systemctl --user isolate yavdr-desktop.target
         
      12. -
      13. tmux.service
        +
      14. tmux.service
        [Unit]
        @@ -4005,7 +4932,7 @@ systemctl --user isolate yavdr-desktop.target
         
      15. -
      16. wm-exit.service
        +
      17. wm-exit.service
        [Unit]
        @@ -4024,7 +4951,7 @@ systemctl --user isolate yavdr-desktop.target
         
    9. -
    10. irexec
      +
    11. irexec

      irexec.service starts irexec for the user session @@ -4058,12 +4985,12 @@ end

    -
    -

    7.12 samba-install

    +
    +

    7.12 samba-install

    -
    -

    7.12.1 tasks

    +
    +

    7.12.1 tasks

    ---
    @@ -4085,12 +5012,12 @@ end
     
    -
    -

    7.13 samba-config

    +
    +

    7.13 samba-config

    -
    -

    7.13.1 tasks

    +
    +

    7.13.1 tasks

    ---
    @@ -4115,14 +5042,14 @@ end
     
    -
    -

    7.13.2 templates

    +
    +

    7.13.2 templates

      -
    1. smb.conf
      +
    2. smb.conf
        -
      1. global settings
        +
      2. global settings
        {{ ansible_managed | comment }}
        @@ -4208,7 +5135,7 @@ end
         
      3. -
      4. media directories
        +
      5. media directories
        {% for name, path in media_dirs.iteritems() %}
        @@ -4230,7 +5157,7 @@ end
         
      6. -
      7. include custom samba exports
        +
      8. include custom samba exports
        include = /etc/samba/smb.conf.custom
        @@ -4243,15 +5170,15 @@ end
         
    -
    -

    7.14 STARTED autoinstall-drivers

    +
    +

    7.14 STARTED autoinstall-drivers

    It would be nice to be able to detect if it is suitable to install those drivers:

    -
    -

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

    +
    +

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

    Vendor-IDs: @@ -4261,9 +5188,20 @@ Vendor-IDs:

  • 2659:* (neuere Sticks)
  • +
      +
    1. planned packages
      +
      +
        +
      • yavdr-hardware-sundtek
      • +
      • python3-sundtek
      • +
      • yavdr-backend-sundtek
      • +
      -
      -

      7.14.2 TODO drivers for TT S2-6400 FF

      +
    2. +
    +
    +
    +

    7.14.2 TODO drivers for TT S2-6400 FF

    https://github.com/s-moch/linux-saa716x - kann man den relevanten Teil als dkms-Paket bauen? @@ -4271,15 +5209,15 @@ Vendor-IDs:

    -
    -

    7.15 autoinstall-ubuntu-drivers

    +
    +

    7.15 autoinstall-ubuntu-drivers

    The tool ubuntu-drivers is used to install the matching driver version for nvidia graphics cards, virtualbox guest additions and Intel and AMD microcode updates.

    -
    -

    7.15.1 tasks

    +
    +

    7.15.1 tasks

    ---
    @@ -4302,8 +5240,8 @@ The tool ubuntu-drivers is used to install the matching driver version for nvidi
     
    -
    -

    7.16 autoinstall-virtualbox-guest

    +
    +

    7.16 autoinstall-virtualbox-guest

    This role installs the guest additions for virtualbox guests on Ubuntu 16.04 @@ -4354,12 +5292,12 @@ This role installs the guest additions for virtualbox guests on Ubuntu 16.04

    -
    -

    7.17 autoinstall-atric-usb

    +
    +

    7.17 autoinstall-atric-usb

    -
    -

    7.17.1 dependencies

    +
    +

    7.17.1 dependencies

    ---
    @@ -4371,8 +5309,8 @@ This role installs the guest additions for virtualbox guests on Ubuntu 16.04
     
    -
    -

    7.17.2 tasks

    +
    +

    7.17.2 tasks

    ---
    @@ -4414,8 +5352,8 @@ This role installs the guest additions for virtualbox guests on Ubuntu 16.04
     
    -
    -

    7.17.3 templates

    +
    +

    7.17.3 templates

    {{ ansible_managed | comment }}
    @@ -4444,12 +5382,12 @@ This role installs the guest additions for virtualbox guests on Ubuntu 16.04
     
    -
    -

    7.18 autoinstall-yausbir

    +
    +

    7.18 autoinstall-yausbir

    -
    -

    7.18.1 dependencies

    +
    +

    7.18.1 dependencies

    ---
    @@ -4460,8 +5398,8 @@ This role installs the guest additions for virtualbox guests on Ubuntu 16.04
     
    -
    -

    7.18.2 tasks

    +
    +

    7.18.2 tasks

    ---
    @@ -4503,8 +5441,8 @@ This role installs the guest additions for virtualbox guests on Ubuntu 16.04
     
    -
    -

    7.18.3 templates

    +
    +

    7.18.3 templates

    {{ ansible_managed | comment }}
    @@ -4532,15 +5470,15 @@ This role installs the guest additions for virtualbox guests on Ubuntu 16.04
     
    -
    -

    7.19 autoinstall-satip

    +
    +

    7.19 autoinstall-satip

    If a Sat>IP Server responds to a discovery request, the package vdr-plugin-satip is installed.

    -
    -

    7.19.1 tasks

    +
    +

    7.19.1 tasks

    ---
    @@ -4565,12 +5503,12 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.20 autoinstall-targavfd

    +
    +

    7.20 autoinstall-targavfd

    -
    -

    7.20.1 tasks

    +
    +

    7.20.1 tasks

    ---
    @@ -4586,12 +5524,12 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.21 autoinstall-imonlcd

    +
    +

    7.21 autoinstall-imonlcd

    -
    -

    7.21.1 tasks

    +
    +

    7.21.1 tasks

    ---
    @@ -4607,12 +5545,12 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.22 autoinstall-libcecdaemon

    +
    +

    7.22 autoinstall-libcecdaemon

    -
    -

    7.22.1 tasks

    +
    +

    7.22.1 tasks

    ---
    @@ -4628,12 +5566,12 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.23 autoinstall-pvr350

    +
    +

    7.23 autoinstall-pvr350

    -
    -

    7.23.1 tasks

    +
    +

    7.23.1 tasks

    ---
    @@ -4649,8 +5587,8 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.24 autoinstall-hauppauge-pvr

    +
    +

    7.24 autoinstall-hauppauge-pvr

    ---
    @@ -4665,12 +5603,12 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.25 autoinstall-firmware

    +
    +

    7.25 autoinstall-firmware

    -
    -

    7.25.1 dependencies

    +
    +

    7.25.1 dependencies

    ---
    @@ -4681,8 +5619,8 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.25.2 tasks

    +
    +

    7.25.2 tasks

    ---
    @@ -4707,12 +5645,12 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.26 autoinstall-dvbsky-firmware

    +
    +

    7.26 autoinstall-dvbsky-firmware

    -
    -

    7.26.1 dependencies

    +
    +

    7.26.1 dependencies

    ---
    @@ -4723,8 +5661,8 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.26.2 defaults

    +
    +

    7.26.2 defaults

    ---
    @@ -4734,8 +5672,8 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.26.3 tasks

    +
    +

    7.26.3 tasks

    ---
    @@ -4785,15 +5723,15 @@ If a Sat>IP Server responds to a discovery request, the package vdr-plugin-sa
     
    -
    -

    7.27 TODO autoinstall-dvbhddevice

    +
    +

    7.27 TODO autoinstall-dvbhddevice

    Problem: woher kommt der Treiber (AFAIK noch nicht im Kernel)? Die Firmware sollte in yavdr-firmware stecken

    -
    -

    7.27.1 dependencies

    +
    +

    7.27.1 dependencies

    ---
    @@ -4804,8 +5742,8 @@ Problem: woher kommt der Treiber (AFAIK noch nicht im Kernel)? Die Firmware soll
     
    -
    -

    7.27.2 tasks

    +
    +

    7.27.2 tasks

    ---
    @@ -4822,12 +5760,12 @@ Problem: woher kommt der Treiber (AFAIK noch nicht im Kernel)? Die Firmware soll
     
    -
    -

    7.28 autoinstall-dvbsddevice

    +
    +

    7.28 autoinstall-dvbsddevice

    -
    -

    7.28.1 dependencies

    +
    +

    7.28.1 dependencies

    ---
    @@ -4838,8 +5776,8 @@ Problem: woher kommt der Treiber (AFAIK noch nicht im Kernel)? Die Firmware soll
     
    -
    -

    7.28.2 tasks

    +
    +

    7.28.2 tasks

    ---
    @@ -4857,12 +5795,12 @@ Problem: woher kommt der Treiber (AFAIK noch nicht im Kernel)? Die Firmware soll
     
    -
    -

    7.29 autoinstall-hardware-irmp

    +
    +

    7.29 autoinstall-hardware-irmp

    -
    -

    7.29.1 dependencies

    +
    +

    7.29.1 dependencies

    ---
    @@ -4873,8 +5811,8 @@ Problem: woher kommt der Treiber (AFAIK noch nicht im Kernel)? Die Firmware soll
     
    -
    -

    7.29.2 tasks

    +
    +

    7.29.2 tasks

    ---
    @@ -4890,19 +5828,19 @@ Problem: woher kommt der Treiber (AFAIK noch nicht im Kernel)? Die Firmware soll
     
    -
    -

    7.30 kodi

    +
    +

    7.30 kodi

    -
    -

    7.30.1 tasks

    +
    +

    7.30.1 tasks

      -
    1. Install KODI
      +
    2. Install KODI
        -
      • main.yml
        -
        +
      • main.yml
        +
        - import_tasks: install-kodi.yml tags=install,update,kodi:install
         - import_tasks: configure-kodi.yml tags=install,update,kodi:configure
        @@ -4910,7 +5848,7 @@ Problem: woher kommt der Treiber (AFAIK noch nicht im Kernel)? Die Firmware soll
         
      • -
      • install-kodi.yml
        +
      • install-kodi.yml
        ---
        @@ -4928,7 +5866,7 @@ Problem: woher kommt der Treiber (AFAIK noch nicht im Kernel)? Die Firmware soll
         
      • -
      • configure-kodi.yml
        +
      • configure-kodi.yml
        - name: create kodi.service for the user session
        @@ -4977,12 +5915,12 @@ Problem: woher kommt der Treiber (AFAIK noch nicht im Kernel)? Die Firmware soll
         
    -
    -

    7.30.2 templates

    +
    +

    7.30.2 templates

      -
    1. kodi.service
      +
    2. kodi.service

      This systemd unit for the user session starts (and stops) kodi. @@ -5007,15 +5945,15 @@ This systemd unit for the user session starts (and stops) kodi.

    -
    -

    7.30.3 files

    +
    +

    7.30.3 files

    Those configuration files provide a preconfiguration for kodi which overrides the system wide configuration

      -
    1. Lircmap.xml
      +
    2. Lircmap.xml

      This file allows to map keys sent by remotes via eventlircd (which uses the name devinput) to kodi key names. @@ -5086,14 +6024,14 @@ This file allows to map keys sent by remotes via eventlircd (which uses the name

    -
  • keymaps
    +
  • keymaps

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

      -
    1. remote.xml
      +
    2. remote.xml
      <?xml version="1.0" encoding="UTF-8"?>
      @@ -5645,17 +6583,17 @@ This file maps the keys defined in Lircmap.xml to actions within kodi.
       
  • -
    -

    7.31 dvd

    +
    +

    7.31 dvd

    -
    -

    7.31.1 tasks

    +
    +

    7.31.1 tasks

      -
    • install libdvd-pkg, allow programs to eject optical media
      -
      +
    • install libdvd-pkg, allow programs to eject optical media
      +
      ---
       # file: roles/dvd/tasks/main.yml
      @@ -5695,15 +6633,15 @@ This file maps the keys defined in Lircmap.xml to actions within kodi.
       
    -
    -

    7.32 install-sundtek

    +
    +

    7.32 install-sundtek

    -
    -

    7.32.1 variables

    +
    +

    7.32.1 variables

    -
    -

    7.32.2 tasks

    +
    +

    7.32.2 tasks

    ---
    @@ -5752,8 +6690,8 @@ This file maps the keys defined in Lircmap.xml to actions within kodi.
     
    -
    -

    7.32.3 templates

    +
    +

    7.32.3 templates

    # ----- GLOBAL SECTION -----
    @@ -5859,8 +6797,8 @@ This file maps the keys defined in Lircmap.xml to actions within kodi.
     
    -
    -

    7.33 template-test

    +
    +

    7.33 template-test

    ---
    @@ -6101,12 +7039,12 @@ EndSection
     
    -
    -

    7.34 wakeup

    +
    +

    7.34 wakeup

    -
    -

    7.34.1 defaults

    +
    +

    7.34.1 defaults

    ---
    @@ -6116,8 +7054,8 @@ EndSection
     
    -
    -

    7.34.2 tasks

    +
    +

    7.34.2 tasks

    ---
    @@ -6138,8 +7076,8 @@ EndSection
     
    -
    -

    7.34.3 templates

    +
    +

    7.34.3 templates

    {{ ansible_managed | comment }}
    @@ -6165,12 +7103,12 @@ ACPI_START_AHEAD=5
     
    -
    -

    7.35 grub-config

    +
    +

    7.35 grub-config

    -
    -

    7.35.1 default variables

    +
    +

    7.35.1 default variables

    system:
    @@ -6182,8 +7120,8 @@ ACPI_START_AHEAD=5
     
    -
    -

    7.35.2 tasks

    +
    +

    7.35.2 tasks

    ---
    @@ -6208,8 +7146,8 @@ ACPI_START_AHEAD=5
     
    -
    -

    7.35.3 templates

    +
    +

    7.35.3 templates

    #!/bin/sh
    @@ -6232,12 +7170,17 @@ menuentry "PowerOff" {
     
    -
    -

    7.35.4 handlers

    +
    +

    7.35.4 handlers

    ---
     
    +- name: Update Initramfs
    +  command: "update-initramfs -u"
    +  failed_when: ('error' in initramfs_register_update.stderr)
    +  register: initramfs_register_update
    +
     - name: Update GRUB
       command: update-grub
       failed_when: ('error' in grub_register_update.stderr)
    @@ -6251,15 +7194,15 @@ menuentry "PowerOff" {
     
    -
    -

    8 Modules

    +
    +

    8 Modules

    This section contains custom modules for the yaVDR Playbooks. They are used to collect facts about the system and configure applications and daemons.

    -
    -

    8.1 hardware_facts.py

    +
    +

    8.1 hardware_facts.py

    # This Module collects the vendor- and device ids for USB- and PCI(e)-devices and currently loaded kernel modules.
    @@ -6437,8 +7380,8 @@ This section contains custom modules for the yaVDR Playbooks. They are used to c
     
    -
    -

    8.2 satip_facts.py

    +
    +

    8.2 satip_facts.py

    DOCUMENTATION = '''
    @@ -6562,8 +7505,8 @@ This section contains custom modules for the yaVDR Playbooks. They are used to c
     
    -
    -

    8.3 xrandr_facts.py

    +
    +

    8.3 xrandr_facts.py

    • [ ] support multiple screens (-d :0.0 .. :0.n)
    • @@ -6850,8 +7793,8 @@ This section contains custom modules for the yaVDR Playbooks. They are used to c
    -
    -

    9 Handlers

    +
    +

    9 Handlers

    - name: Reconfigure unattended upgrades with dpkg
    @@ -6940,7 +7883,7 @@ This section contains custom modules for the yaVDR Playbooks. They are used to c
     

    Autor: Alexander Grothe <seahawk1986@gmx.de>

    -

    Created: 2018-06-02 Sa 20:04

    +

    Created: 2018-08-05 So 14:04

    Validate

    diff --git a/Manual.org b/Manual.org index f0bc063..86d5659 100644 --- a/Manual.org +++ b/Manual.org @@ -3473,6 +3473,12 @@ systemctl --user isolate yavdr-desktop.target no + + no + yes + + no + no yes @@ -4289,6 +4295,12 @@ systemctl --user isolate yavdr-desktop.target no + + no + yes + + no + no yes diff --git a/roles/yavdr-desktop/templates/openbox/rc.xml.j2 b/roles/yavdr-desktop/templates/openbox/rc.xml.j2 index 469bbfa..80ac92a 100644 --- a/roles/yavdr-desktop/templates/openbox/rc.xml.j2 +++ b/roles/yavdr-desktop/templates/openbox/rc.xml.j2 @@ -784,6 +784,12 @@ no + + no + yes + + no + no yes diff --git a/roles/yavdr-desktop/templates/openbox/rc2.xml.j2 b/roles/yavdr-desktop/templates/openbox/rc2.xml.j2 index 37aa463..85ae92e 100644 --- a/roles/yavdr-desktop/templates/openbox/rc2.xml.j2 +++ b/roles/yavdr-desktop/templates/openbox/rc2.xml.j2 @@ -784,6 +784,12 @@ no + + no + yes + + no + no yes