<commit_before>kioskOS
=======

kioskOS is a script to modify a Arch Linux installation running on a Raspberry Pi that

 - automatically boots into a minimalistic, frameless browser when started
 - works entirely read-only

The result is a display driver that can be switched on and off at any time of the day and that will still reliably show the same image after being switched on again. This means once the system is set up no instructions or special knowledge are necessary to start and stop the display: Simply cutting the power will power the device down.

Please note that this project does not include any webserver or storage to save data to be shown. The data to be shown must be accessible over the network, provided by a different device.

Preparations
------------

This script assumes that you have a good knowledge of how Arch Linux does things and that you have done the following:

Installed the latest image of [archlinux ARM](http://archlinuxarm.org/platforms/armv6/raspberry-pi) and booted the system.

Edited locale and keyboard layout as well as timezone

    echo KEYMAP=\"de-latin1-nodeadkeys\" > /etc/vconsole.conf
    echo LANG=\"de_DE.UTF-8\" > /etc/locale.conf
    echo LANGUAGE=\"de_DE.UTF-8\" >> /etc/locale.conf
    locale-gen
    ln -s /usr/share/zoneinfo/Europe/Berlin /etc/localtime -f

Properly initialized pacman and upgraded system

    pacman-key --init
    pacman -Syu

Installed Git

    pacman -S git

And lastly grown the partition to be at least 4 GB in size (use `resize.sh` provided here if unsure what to do)

Installation
------------

Clone the sources

    git clone https://github.com/nils-werner/kioskOS.git

After customizing your kiosk, run the installer

    cd kioskOS
    bash install.sh

Customization
-------------

There are two places you might want to customize:

    data/etc/netctl/wlan0

is a generic template for a wireless LAN connection, protected by WPA. Input your WLAN SSID and password if you want to use wireless LAN

secondly 

    data/home/display/.config/midori/config

contains a field named `homepage`. This field will be loaded by the browser upon booting. Insert your URL here.


Feedback, Contributions
-----------------------

This is a very rough first attempt to create a simple and robust kiosk display driver. Feedback and improvements are very welcome!<commit_msg>Recommend to change password<commit_after>kioskOS
=======

kioskOS is a script to modify a Arch Linux installation running on a Raspberry Pi that

 - automatically boots into a minimalistic, frameless browser when started
 - works entirely read-only

The result is a display driver that can be switched on and off at any time of the day and that will still reliably show the same image after being switched on again. This means once the system is set up no instructions or special knowledge are necessary to start and stop the display: Simply cutting the power will power the device down.

Please note that this project does not include any webserver or storage to save data to be shown. The data to be shown must be accessible over the network, provided by a different device.

Preparations
------------

This script assumes that you have a good knowledge of how Arch Linux does things and that you have done the following:

Installed the latest image of [archlinux ARM](http://archlinuxarm.org/platforms/armv6/raspberry-pi) and booted the system.

Changed the `root` user password

    passwd

Edited locale and keyboard layout as well as timezone

    echo KEYMAP=\"de-latin1-nodeadkeys\" > /etc/vconsole.conf
    echo LANG=\"de_DE.UTF-8\" > /etc/locale.conf
    echo LANGUAGE=\"de_DE.UTF-8\" >> /etc/locale.conf
    locale-gen
    ln -s /usr/share/zoneinfo/Europe/Berlin /etc/localtime -f

Properly initialized pacman and upgraded system

    pacman-key --init
    pacman -Syu

Installed Git

    pacman -S git

And lastly grown the partition to be at least 4 GB in size (use `resize.sh` provided here if unsure what to do)

Installation
------------

Clone the sources

    git clone https://github.com/nils-werner/kioskOS.git

After customizing your kiosk, run the installer

    cd kioskOS
    bash install.sh

Customization
-------------

There are two places you might want to customize:

    data/etc/netctl/wlan0

is a generic template for a wireless LAN connection, protected by WPA. Input your WLAN SSID and password if you want to use wireless LAN

secondly 

    data/home/display/.config/midori/config

contains a field named `homepage`. This field will be loaded by the browser upon booting. Insert your URL here.


Feedback, Contributions
-----------------------

This is a very rough first attempt to create a simple and robust kiosk display driver. Feedback and improvements are very welcome!
{'fraction_non_alphanumeric': 0.0751627125761075, 'fraction_numerical': 0.0025194205332773464, 'mean_word_length': 3.291891891891892, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 11, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '585378', 'n_tokens_mistral': 1306, 'n_tokens_neox': 1255, 'n_words': 648}