https://github.com/paulfantom/ansible-kiosk

Create secure kiosk from raspberry using Xorg, openbox, and chromium browser.
https://github.com/paulfantom/ansible-kiosk

Last synced: over 1 year ago
JSON representation

Create secure kiosk from raspberry using Xorg, openbox, and chromium browser.

• Host: GitHub
• URL: https://github.com/paulfantom/ansible-kiosk
• Owner: paulfantom
• License: mit
• Created: 2019-12-18T18:00:33.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-05-17T14:07:24.000Z (about 3 years ago)
• Last Synced: 2025-02-28T10:04:17.570Z (over 1 year ago)
• Language: Shell
• Size: 13.7 KB
• Stars: 6
• Watchers: 3
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Ansible Role: kiosk

[![Build Status](https://travis-ci.com/paulfantom/ansible-kiosk.svg?branch=master)](https://travis-ci.com/paulfantom/ansible-kiosk)

[![License](https://img.shields.io/badge/license-MIT%20License-brightgreen.svg)](https://opensource.org/licenses/MIT)

[![Ansible Role](https://img.shields.io/badge/ansible%20role-paulfantom.kiosk-blue.svg)](https://galaxy.ansible.com/paulfantom/kiosk/)

[![GitHub tag](https://img.shields.io/github/tag/paulfantom/ansible-kiosk.svg)](https://github.com/paulfantom/ansible-kiosk/tags)

## Description

Create secure kiosk from raspberry using Xorg, openbox, and chromium browser.

Role based on blog post available at https://die-antwort.eu/techblog/2017-12-setup-raspberry-pi-for-kiosk-mode/

## Requirements

- Ansible >= 2.7 (It might work on previous versions, but we cannot guarantee it)

## Role Variables

All variables which can be overridden are stored in [defaults/main.yml](defaults/main.yml) file as well as in table below.

| Name           | Default Value | Description                        |

| -------------- | ------------- | -----------------------------------|

| `kiosk_url` | "https://duckduckgo.com" | default URL to open in kiosk browser |

| `kiosk_delay` | 1 | delay (in seconds) before starting a browser |

| `kiosk_startx_params` | ["-nocursor"] | parameters to run `startx` with |

| `kiosk_browser_params` | ["--disable-infobars", "--kiosk"] | parameters to start browser with |

## Example

### Playbook

Use it in a playbook as follows:

```yaml

- hosts: all

  roles:

    - paulfantom.kiosk

```

## Contributing

See [contributor guideline](CONTRIBUTING.md).

## License

This project is licensed under MIT License. See [LICENSE](/LICENSE) for more details.