# [`ansible-role-xsession`][] An [Ansible][] [role][] for deploying custom [X][] session [`.desktop`][] file. Adds a `/etc/X11/sessions/Xsession.desktop` file that is picked up by [X display manager][]s and, if chosen, runs `/etc/X11/Xsession` (which probably runs your `$HOME/.xsession`). [`ansible-role-xsession`]: https://git.rcrnstn.net/rcrnstn/ansible-role-xsession [Ansible]: https://docs.ansible.com/ansible [role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html [X]: https://en.wikipedia.org/wiki/X_Window_System [`.desktop`]: https://specifications.freedesktop.org/desktop-entry-spec/latest/index.html#introduction [X display manager]: https://en.wikipedia.org/wiki/X_display_manager ## Usage Example [`requirements.yml`][]: ```yaml --- roles: - name: 'xsession' src: 'https://git.rcrnstn.net/rcrnstn/ansible-role-xsession' scm: 'git' ``` Example [playbook][]: ```yaml --- - hosts: 'all' roles: - role: 'xsession' ``` [`requirements.yml`]: https://docs.ansible.com/ansible/latest/galaxy/user_guide.html#installing-multiple-roles-from-a-file [playbook]: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html ## License Licensed under the [ISC License][] unless otherwise noted, see the [`LICENSE`][] file. [ISC License]: https://choosealicense.com/licenses/isc/ [`LICENSE`]: LICENSE