Install

sudo apt update sudo apt install --no-install-recommends
xserver-xorg xinit x11-xserver-utils openbox chromium-browser
xserver-xorg-legacy alsa-utils unclutter-xfixes x11-xserver-utils
xscreensaver xscreensaver-data-extra xscreensaver-gl-extra -y

• xserver-xorg → graphics server
• xinit → provides startx
• openbox → lightweight window manager
• chromium-browser → kiosk browser
• xserver-xorg-legacy → allows non-root Xorg
• alsa-utils → ALSA tools for sound

Allow Xorg for non-root users

sudo nano /etc/X11/Xwrapper.config

allowed_users=anybody

Set HDMI as ALSA default

aplay -l

Example: card 0, device 3 (HDMI to AVR)

nano ~/.asoundrc

pcm.!default {
    type hw
    card 0
    device 3
}

ctl.!default {
    type hw
    card 0
}

Replace card and device with your HDMI numbers. Save and exit.

Create kiosk startup script

nano ~/.xinitrc

Content is in .xinitrc file

chmod +x ~/.xinitrc

Enable autologin on tty1

sudo mkdir -p /etc/systemd/system/getty@tty1.service.d
sudo nano /etc/systemd/system/getty@tty1.service.d/override.conf

[Service]
ExecStart=
ExecStart=-/sbin/agetty --autologin yourusername --noclear %I $TERM

Auto-start X on login

nano ~/.bash_profile

Content is in .bash_profile file

Reboot and test

sudo reboot

Optional: Auto-refresh Chromium

Create ~/kiosk-refresh.sh

chmod +x ~/kiosk-refresh.sh

crontab -e

add:

0 3 * * * /home/yourusername/kiosk-refresh.sh

Screen

chmod +x ~/check-audio-idle.sh