Install HstWB Installer for Raspberry Pi OS Lite - henrikstengaard/hstwb-installer Wiki

Installation of HstWB Installer has been tested with following Raspberry OS Lite releases and Raspberry Pi models:

Prerequisites

HstWB Installer for Raspberry Pi OS Lite has following prerequisites:

See Install Raspberry Pi OS for steps to install Raspberry Pi OS.

Install HstWB Installer

Start installation of HstWB Installer with following steps:

  1. Install git with command:
sudo apt-get --assume-yes install git
  1. Change directory to home directory with command:
cd ~
  1. Download HstWB Installer with git clone command:
git clone https://www.github.com/henrikstengaard/hstwb-installer.git
  1. Install HstWB Installer with command:
./hstwb-installer/launcher/raspberry-pi/install.sh

This will install HstWB Installer and go through following steps:

  1. Select Yes to install HstWB Installer.

  1. Select Yes to change Raspberry Pi OS boot to use HstWB Installer.
    • This will enable auto-start of Amiga emulator on boot.

  1. Select Yes to patch boot services.
    • This will improve boot speed.

  1. Select Yes to enable autologin.
    • This will useful remove the need to login, when Raspberry Pi OS is booted.
    • This also helps to auto-start Amiga emulator.

  1. Select Yes to delay network at boot.
    • This will improve boot speed.

  1. Select Yes to install and patch usbmount.
    • This will enable automount of USB FAT32 formatted devices, when attached to Raspberry Pi and are accessible from e.g. /media/usb0, /media/usb1, and so on for each device and partition.

  1. Select Yes to install Samba.
    • This will configure network shares for files transfer to and from Raspberry Pi users home directories using network connection.

  1. Select Yes to force 1080p HDMI resolution, if Raspberry Pi model is 4 / 400 and 4K displays are used.
    • This will improve performance of Amiga emulators as 4K HDMI resolutions causes slow downs in Amiga emulators for Raspberry Pi model is 4 / 400 and 4K displays. It's also useful to force 1080p HDMI resolution for Raspberry Pi 3 B as Raspberry Pi OS Lite is configured with a VGA like resolution by default.

  1. Select Yes to install SDL2 from source code.
    • This will required for compiling Amiberry and will download, compile and install SDL2.

  1. Select SDL2 configuration matching your Raspberry Pi: Optimized for Raspberry Pi 4 / 400, 3 (B+) or Optimized for Raspberry Pi 2, 1 / Zero.

  1. Select Yes to install Amiberry from source code.

  1. Select Raspberry Pi model matching your Raspberry Pi: Raspberry Pi 4 / 400, Raspberry Pi 3 (B+), Raspberry Pi 2 or Raspberry Pi 1 / Zero.

  1. Select 32-bit operating system.

  1. Select SDL2 SDL2 target.

  1. Select Stable (master) Amiberry branch.

  1. Select Latest version of Amiberry.

  1. Select Yes to use Amiberry as default Amiga emulator.

  1. Select Yes to install UAE4ARM from source code.

  1. Select Raspberry Pi model matching your Raspberry Pi: Raspberry Pi 4 / 400, Raspberry Pi 3 (B+), Raspberry Pi 2 or Raspberry Pi 1 / Zero.

  1. Select Yes to use UAE4ARM as default Amiga emulator.

  1. Select Yes to enable fake KMS video driver.

  1. Select Yes to reboot and go through first time use steps.

HstWB Installer is now installed, ready to use and will reboot to first time use steps.

If something went wrong during install, installation can always be started again.

Continue with First time use for Raspberry Pi OS for steps to configure Kickstart roms for Amiga emulators and install HstWB Installer image.

Change asound card

Configured asound card defines where audio is played: HDMI or headphones.

Change asound card with following steps:

  1. Type hstwb and press enter to start HstWB Installer.

  2. Select Raspberry Pi OS and press enter.

  3. Select Change asound card and press enter.

  4. Select Yes to change asound card.

  5. Select sound card from list to use for playing audio.

    • List of asound cards with KMS video driver:
0 [vc4hdmi0       ]: vc4-hdmi - vc4-hdmi-0
1 [vc4hdmi1       ]: vc4-hdmi - vc4-hdmi-1

0 [b1             ]: bcm2835_hdmi - bcm2835 HDMI 1
1 [Headphones     ]: bcm2835_headpho - bcm2835 headphones

Network file transfer

With Samba installed, files can be transferred to and from Raspberry Pi users home directories using network connection.

By default Samba network shares are configured following login credentials:

Connections, if Raspberry Pi has ip-address 192.168.0.150:

On Windows, open File Manager and enter connection path in location.

On macOS, open Finder and from menu, click Go, Connect to Server and enter connection path.

Samba password can be changed by running smbpasswd command from shell.

Updating

HstWB Installer can be updated to latest version with following steps:

  1. Type hstwb and press enter to start HstWB Installer.

  2. Select Update to update HstWB Installer to latest version.

HstWB Installer will restart itself after updating is complete.

Uninstall

From shell HstWB Installer can be uninstalled with following steps:

  1. Change directory to home directory with command:
cd ~
  1. Uninstall HstWB Installer with command:
./hstwb-installer/launcher/raspberry-pi/uninstall.sh

When uninstalled it should show a dialog with successfully uninstall of HstWB Installer.

Environment variables and paths

HstWB Installer for Raspberry Pi OS uses following environment variables and paths:

HSTWB_INSTALLER_ROOT = ~/hstwb-installer
HSTWB_INSTALLER_BOOT = hstwb
AMIGA_HDD_PATH = ~/amiga/hdfs
AMIGA_KICKSTARTS_PATH = ~/amiga/kickstarts
AMIBERRY_EMULATOR_PATH = ~/amiga/emulators/amiberry
AMIBERRY_CONF_PATH = ~/amiga/emulators/amiberry/conf
UAE4ARM_EMULATOR_PATH = ~/amiga/emulators/uae4arm
UAE4ARM_CONF_PATH = ~/amiga/emulators/uae4arm/conf
AMIGA_EMULATOR = amiberry

These are stored in HstWB Installer config file ~/.hstwb-installer/config.sh.

Known bugs and issues