HstWB Installer for Amibian - henrikstengaard/hstwb-installer GitHub Wiki

HstWB Installer for Amibian is obsolete and no longer maintained as Amibian is no longer maintained.

See HstWB Installer for Raspberry Pi OS for installing HstWB Installer for Raspberry Pi OS.

HstWB Installer supports Amibian v1.5 and v1.4.1001 and comes with a launcher menu to simplify Amibian usage and installation of HstWB Installer images.

Prerequisites

HstWB Installer for Amibian has following prerequisites:

  • Amibian 1.5 or 1.4.1001 installed on MicroSD card and running with Raspberry Pi.
  • Internet connection: Wired or WiFi.

Optional preparation

Amibian doesn't come with any prepared emulator configurations or Amiga hard drives. HstWB Installer for Amibian can install HstWB Installer image to simplify such installation and this requires preparing a FAT32 formatted USB stick with Amiga OS and Kickstart files.

This is optional and is only required for installation of new emulator configurations or Amiga hard drives using prebuild HstWB Installer images.

Download and prepare USB self install to install HstWB Installer image

  1. Download USB self install.
  2. Unzip to root of a FAT32 formatted USB stick (or any FAT32 formatted USB device: Harddisk, SSD).
  3. Copy Amiga OS and Kickstart files to USB stick:
    1. Automatically using Cloanto Amiga Forever:
      1. Insert Cloanto Amiga Forever cd/dvd-rom or mount iso.
      2. Windows: Double-click "hstwb_image_setup.cmd" in Windows Explorer.
      3. macOS: Double-click "hstwb_image_setup.command" in macOS Finder.
      4. Ubuntu: Double-click "HstWB Image Setup" in Ubuntu Files.
      5. Linux: Type "./hstwb_image_setup.sh" and press enter in terminal.
    2. Manually:
      1. Copy Amiga OS 3.9 iso, Amiga OS 3.1.4 or 3.1 adf files to "amigaos" directory on USB stick.
      2. Copy Kickstart roms to "kickstart" directory on USB stick. Kickstart 3.1.4 or 3.1 is required for Amiga emulators as HstWB Installer uses A1200 configurations to run HstWB Installer. Kickstart 1.3 and others required for WHDLoad should also be copied for automated inatallation.
  4. Insert USB stick in Raspberry Pi before starting installation of HstWB Installer for Amibian.

Amibian 1.5

Booting Amibian 1.5, HstWB Installer for Amibian can be installed with following steps:

  1. Boot Raspberri Pi with Amibian 1.5 MicroSD card inserted.
  2. Quit Amiberry by clicking 'Quit' button.
  3. Connect Raspberry Pi to internet:
    1. Wired: Skip to install section to install HstWB Installer for Amibian.
    2. WiFi:
      1. Type 6 and press enter to start Amibian Configuration Tool.
      2. Select 'Network Options' and 'Wi-fi'.
      3. Press ESC or select 'Finish' to exit Amibian Configuration Tool.
  4. Update Amibian:
    1. Type 6 and press enter to start Amibian Configuration Tool.
    2. Select 'Update' and 'Update Amibian' to download and install latest version of Amibian.
    3. When update is complete, press enter to close 'Amibian updated to latest version' message and continue.
    4. Press ESC or select 'Finish' to exit Amibian Configuration Tool.
    5. Type permission and press enter to fix permission issues after updating Amibian.
  5. Change keyboard layout and update Amiberry to latest version:
    1. Type 6 and press enter to start Amibian Configuration Tool.
    2. Select 'Localisation Options' and 'Change Keyboard Layout' to change keyboard layout matching keyboard that is connected to the Raspberry Pi. This is optional, but it's hard to type certain characters with changing it!
    3. Select 'Update' and 'Update Amiberry master Branch' to download, compile and install latest version of Amiberry. This is required to run HstWB Installer image with JIT enabled as Amiberry v3.1.2 fixes JIT issues!
    4. Press ESC or select 'Finish' to exit Amibian Configuration Tool.

Amibian 1.4.1001

Booting Amibian 1.4.1001, HstWB Installer for Amibian can be installed with following steps:

  1. Press F12 and quit Amiga emulator by clicking 'Quit' button.
  2. Connect Raspberry Pi to internet:
    1. Wired: Skip to install section to install HstWB Installer for Amibian.
    2. WiFi:
      1. Type wifi and enter SSID and password for WiFi network.
      2. Save and quit by typing CTRL+X and type 'y' and enter to save.
      3. Press 'y' and enter to restart Amibian.

Install

From Amibian shell HstWB Installer can be installed with following steps:

  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/amibian/install.sh

Follow installation messages to complete installation.

Installation can always be started again, if needed.

Change Amibian boot

Amibian boot can be changed to start one of following during boot:

  • Run Amiga emulator.
  • HstWB Installer for Amibian.
  • Amibian menu.

Changing Amibian boot is enabled during installation when it asks if HstWB Installer should change Amibian boot.

If enabled, Amibian boot can always be changed later with following steps:

  1. Start HstWB Installer for Amibian.
  2. Select 'Setup', 'Amibian' and 'Change boot' to change what Amibian starts on boot.

First Time Use

After installation is complete, HstWB Installer will ask to go through first time use steps. These steps helps configuring HstWB Installer first time it's used and will assist with following tasks:

  • Expand filesystem: Expand filesystem to size of MicroSD card size.
  • Find HstWB Self Install: Update HstWB self install mountpoint used by HstWB Installer image to install Amiga OS, Kickstart roms and packages.
  • Change WiFi configuration: Simple setup of WiFi network using input dialogs asking for SSID and password.
  • Install HstWB Installer image: Download and install latest HstWB Installer image.

If change Amibian boot is enabled, Amiga emulator should autostart HstWB Installer image

Going through first time use steps is optional and can always be run later with following steps:

  1. Start HstWB Installer for Amibian.
  2. Select 'Setup', 'HstWB Installer' and 'First Time Use' to go through first time use steps.

Start HstWB Installer for Amibian

Start HstWB Installer for Amibian by type hstwb and press enter in Amibian shell.

This will show a dialog menu with options to run emulator, setup Amibian and HstWB Installer.

Updating

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

  1. Start HstWB Installer for Amibian.
  2. Select 'Update' to update HstWB Installer to latest version.

HstWB Installer will restart itself after updating is complete.

Uninstall

From Amibian 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/amibian/uninstall.sh

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

FAQ

I selected 'No' to go through first time use steps. How can I go through those steps again?

See first time use section about how to go through first time use steps.

How to I install HstWB Installer image?

Installing HstWB Installer for Amibian doesn't HstWB Installer image is not installed by default unless it's installed through first time use. HstWB Installer image can be installed with following steps:

  1. Start HstWB Installer for Amibian.
  2. Select 'Setup', 'HstWB Installer' and 'Install HstWB Installer image'.

This will download and unzip latest HstWB Installer image and install configuration files prepared for Amiberry and UAE4ARM to start HstWB Installer image. WARNING: Any existing HstWB Installer image will be overwritten!

How do I start HstWB Installer image in the Amiga emulator?

HstWB Installer image can be started with following steps:

  1. Start HstWB Installer for Amibian.
  2. Select 'Setup', 'HstWB Installer' and 'Find HstWB Self Install' to update HstWB self install mountpoint used by HstWB Installer image. This should show a successful message about mountpoint has been updated.
  3. Select 'Run Amiga emulator' to start Amiga emulator.
  4. Press F12 and double-click on 'hstwb-installer-020-jit' configuration to start HstWB Installer image.

When running Amiga emulator HstWB Installer image doesn't detect any Amiga OS iso or adf files?

Amiga OS iso and adf files are installed from attached FAT32 USB stick with HstWB self install files and HstWB self install mountpoint needs to be updated prior to manually starting HstWB Installer image in Amiga emulator.

Verify USB stick is properly FAT32 formatted and HstWB self install files are installed including Amiga OS and Kickstarts files as a minimum. Then retry starting HstWB Installer image.

Kickstart 3.1.4 A1200 is installed instead of Kickstart 3.1 A1200 for Amiga emulators. Can HstWB Installer for Amibian install only Kickstart 3.1 A1200?

If both Kickstart 3.1.4 A1200 and Kickstart 3.1 A1200 are present in HstWB self install USB stick 'Kickstart' directory, then HstWB Installer for Amibian will install latest Kickstart A1200 available. To install only Kickstart 3.1 A1200, delete Kickstart 3.1.4 A1200 rom file from HstWB self install USB stick 'Kickstart' directory.

During installing HstWB Installer image I selected 'yes' to update Amiga emulator to autostart HstWB Installer, but it's not started automatically when running Amiga emulator?

Configuring autostart for Amibian 1.5 is only possible by when change Amibian boot is enabled. See first time use section about how to change Amibian boot.

I finished running HstWB Installer image in Amiga emulator and installed Amiga OS or packages that didn't work as I expected. How to I redo running HstWB Installer image again?

See FAQ question 'How to I install HstWB Installer image?'. This can be used to make a new installation of HstWB Installer image and run HstWB Installer image again.

HstWB Installer didn't install or is not starting correctly. What can I do to fix it?

Try uninstall and install HstWB Installer for Amibian again.