diff --git a/home/first-boot.html b/home/first-boot.html new file mode 100644 index 0000000..0a7a254 --- /dev/null +++ b/home/first-boot.html @@ -0,0 +1,919 @@ + + + + + + Welcome to chilipie-kiosk + + + + + +

Welcome to chilipie-kiosk

+

Looks like this might be your first boot!

+

This document lists some things you can do to customize your kiosk. You'll want to plug in a keyboard at this point.

+

Setting the URL

+

Press F11 to exit the full screen mode, and Ctrl + L to focus the location bar. Navigate away! Once done, press F11 again to re-enter full screen mode.

+

Chromium is configured to remember the URL where you left off (and all logins etc), so this might be all the configuration you need to do!

+

What to show

+

Whatever, the Internet is your oyster! If you need simple auto-refresh, or timed cycling through several URL's, sideshow is a great option.

+

Getting a terminal

+

You can get to a virtual terminal by pressing e.g. Ctrl + Alt + F5, and logging in with pi:raspberry. Use Ctrl + Alt + F8 to switch back to the window manager.

+

Enabling WiFi

+

Set the SSID and password of the network you're connecting to, with:

+
$ sudo vim ~/wlan.conf

Reboot to make sure your Pi joins the network automatically.

+
$ sudo reboot

Enabling SSH

+

The default credentials of pi:raspberry aren't terribly secure, so remote access is disabled by default. To enable SSH until next reboot:

+
$ sudo systemctl start ssh.service

Or, to enable it permanently:

+
$ sudo systemctl enable ssh.service

Use ifconfig to figure out your IP address, and ssh in.

+

Controlling the display

+

The scripts ~/display-on.sh and ~/display-off.sh control the HDMI output of the Raspberry Pi.

+

There's a sample configuration in the crontab for turning the display off outside of office hours - use crontab -e to uncomment it.

+

Adjusting the output resolution

+

If the display auto-detection fails and chooses a funky default resolution for you, there's a few things you can do to try and fix that.

+

Changing locale settings

+

To change the keyboard layout:

+
$ sudo dpkg-reconfigure console-data

To change the timezone:

+
$ sudo dpkg-reconfigure tzdata
+ + diff --git a/md-to-html.sh b/md-to-html.sh new file mode 100755 index 0000000..4f8657e --- /dev/null +++ b/md-to-html.sh @@ -0,0 +1,12 @@ +#!/bin/bash + +if [ ! -d "node_modules" ]; then + npm install markdown-styles@3.1.10 html-inline@1.2.0 +fi + +rm -rf md-input md-output +mkdir md-input md-output +cp first-boot.md md-input +./node_modules/.bin/generate-md --layout github --input md-input/ --output md-output/ +./node_modules/.bin/html-inline -i md-output/first-boot.html > home/first-boot.html +rm -rf md-input md-output