AmiKit Support ForumAmiKit Discord Chat
 Start Register Search Statistics Quick Guide  
Online now: Guests - 1
Members - 0
Most users ever online: 41 [Yesterday 01:12]
Guests - 41 / Members - 0
Basic questions, I am new here AmiKit Support Forum / Basic questions, I am new here /  

AmiKit on Raspberry PI 5

Author wiisoldier
#1 Posted: 27 Dec 2023 00:42 
For anyone waiting for a version of AmiKit to appear on RPi 5, it is being worked on. For more info, please join the discord channel

However if you want to boot directly into AmiKit using your current RPi 5 set up this may not work. If you are using Debian Bookworm and manually transferring the files/folders you need to boot Amiberry in a different way.

According to MiDWaN there is an issue with SDL2 on the bookworm architecture and the current solution is to boot AmiKit with this command:
SDL_VIDEODRIVER=wayland ./amiberry -G (assuming your terminal is set to your Amiberry folder i.e. ... cd /home/Amiberry)

This will force your system to use the wayland protocol for Amiberry/AmiKit only and should not affect the rest of your operating system. If I have any info wrong here I am sure someone will offer extra/better advice. It does work for me, so please let me know how you get on with it.

Author wiisoldier
#2 Posted: 9 Feb 2024 23:14 
In regards to what I said above/below, I have written some instructions on how to create a working copy of AmiKit for the RPi5. Please read in full before you begin.


AmiKit on RPi5

This is a «Do It Yourself» guide for installing AmiKit on a Raspberry Pi 5 (without the need to install it on a RPi4 first). This is not an official build and only limited support can be offered and there are no guarantees. If you follow this guide you should have a copy that looks very close to the official version.

This guide assumes you have some / good knowledge of using Raspberry Pi OS / Linux.

You will need:
- A Raspberry Pi 5 (of course)
- The official download of AmiKit for Pi4 flashed on a MicroSD of at least 16GB
- Another MicroSD of at least 16GB (this is the SD that will have the Pi5 version and you may want to back this up later. If you use a larger SD card your backup will be larger, so I recommend using 16GB or 32GB only)

Because the way this version is built, it will work on a Raspberry Pi5 and uses the Pi5 version of Amiberry. The current version of AmiKit uses a slightly different version of Amiberry, written for Manjaro. Therefore, anytime before you run an AmiKit update, it is recommended to make a backup of your Amiberry folder in case a new version is installed that is incompatible with the system.

Everything is carried out on the Pi, however you can use a Windows/Linux or Mac PC to make copies of the AmiKit official SD card and the Raspberry Pi 5 OS card that we will use.

Using Raspberry Pi Imager, create the second SD card with the settings:
Device = RPi5
OS = Raspberry Pi OS (64bit) Debian Bookworm with Desktop

Put this second SD in the Pi, boot it and install the bookworm desktop as follows:
Set your location
user = amikit
pass = amikit
Add wireless network if needed
Choose Firefox Browser
Skip updates
Then restart

(It may help if you copy this guide to your desktop once you have your
RPi5 OS restarted as you can copy and paste the commands)

(In terminal you can paste with ctrl+shift+v or right click and choose paste)

(Please note that ctrl+alt+t opens a terminal if you cannot see it on the desktop)

Once you are in the desktop, open a terminal and type (single lines one at a time)
sudo apt update
sudo apt upgrade -y
sudo apt autoremove -y


Open a terminal again and type:
sudo tasksel
from the list go to the second line «xfce» press the spacebar to select, then press enter.
Once XFCE is installed type:
sudo apt install sddm -y

When a screen pops up offering lightsm or sddm, choose sddm to install and switch to it.

Once sddm has completed type:
sudo update-alternatives --config x-session-manager
From the list choose the last item (xfce session)

Again in terminal type:
sudo raspi-config
Choose the following options:
B3 boot to Desktop GUI, requiring user to login

finish and reboot

On the reboot screen go to the lower left corner and change the Desktop session to:
Xfce Session (password is amikit)

You should now be on XFCE and have two taskbars (bottom and top). We need to remove the lower taskbar.
Right click on the lower panel/taskbar choose: Panel/Panel Preferences
A new box will pop up. In the top right of the panel is a + and - symbol
Click on the - symbol and choose «Remove»

Close the panel

We now want the user «amikit» to autologin when starting the Pi
Open a terminal and type (one line at a time):
sudo mkdir /etc/sddm.conf.d/
sudo nano /etc/sddm.conf.d/autologin.conf
You now have a blank document, type the following into it:

Once done and to save, press «ctrl+o», then «enter», then «ctrl+x» to quit.
(i.e. the control button plus the letter «o» or «x»)

Reboot the system and check that you autologin

You may notice that in XFCE, the numlock for a numeric pad is not switched on at reboot. We will fix that now, to avoid future issues.
open a terminal and type:
sudo apt install numlockx -y

Now we have the program, we need to let the OS know to use it. In the same terminal type:
sudo nano home/amikit/.config/wayfire.ini

In the list that opens scroll to the bottom and add this line:
kb_numlock_default_state = true

Once done, we will save the changes again. press «ctrl+o», then «enter», then «ctrl+x» to exit. (i.e. the control button plus the letter «o» or «x»)

Reboot to check the numlock works (if needed)


We now need to install some programs to make both Amiberry and AmiKit work.

Open a terminal and type: (all one line)
sudo apt install neofetch gparted audacious mpv wmctrl chromium-bsu -y
When complete type: (all one line)
sudo apt install cmake libsdl2-2.0-0 libsdl2-ttf-2.0-0 libsdl2-image-2.0-0 flac mpg123 libmpeg2-4 libserialport0 libportmidi0 -y

Next to make the desktop similar to the official AmiKit we will change the style and icons.

Go to Start/Settings/Appearance
Change both the Style and Icons to Breeze-Dark

Next we need to change the task bar.

First right click on the upper task bar and choose Panel/Panel Preferences.
In the pop up window uncheck Lock Panel, then grab the panel at the top left and drag it to the bottom.

You can now re-check the Lock Panel
Go to the Items tab and click «Add» and search for «Whisker Menu» and add it and close the «Add New items» window.
On the main Panel Preferences window scroll to the bottom of the list and find the newly added «Whisker Menu»
Using the up button (to the right), move it to the top and then remove the «Applications Menu»

Although it doesn't quite look like it, we now have the basis of AmiKit for RPi5. We will add all the AmiKit files and settings.

Put your SD card with AmiKit for RPi4 on it into a SD card reader then into the Pi usb.
Open the listing on the desktop called «ROOT_MNJRO» by double clicking on it. Then navigate to home/amikit
We will copy three folders and one file to our own home folder:
RabbitHole (file)
On the desktop there is a link called «Home» open it and copy the three folders and one file to it (this will take a minute or so).

Next copy the contents of «Downloads» from the original PI4 to the new SD card

We also need to copy some files from the original Amikit «Desktop» folder to the new one. Copy these files:

We also need a shortcut on the desktop
Open home/amikit/RabbitHole and right click on the folder «RequiredFiles» and choose Send To > Desktop
(This is the «Start-Here» folder in the AmiKit guide, you can rename the desktop version if you want)

We have some extra items on the desktop which you can keep or remove (they are shortcuts).
Right click on the desktop and choose «Desktop Settings». Go to the Icons tab and uncheck:
File System
(If you want to keep them, that's fine)

The last thing we need to do is make the taskbar the same as the AmiKit official one.

In your file viewer go to home/amikit click on View and choose «Show Hidden Files»
Go to the folder: .config/xfce4/xfconf/xfce-perchannel-xml/

We need to copy the file «xfce4-panel.xml from the official AmiKit Pi4 card to this location.
Open the listing on the desktop called »ROOT_MNJRO« by double clicking on it. Then navigate to the file:
home/amikit/.config/xfce4/xfconf/xfce-perchannel-xml (you may need to show hidden files again)
and copy the file to the first folder we opened (say yes to overwriting).

Lets set the wallpaper. Navigate to this folder:

Right click on the file named »backdrop« and choose »Set as wallpaper«

Lets set the start button.

Right click on the start button and choose Properties
Go to the appearance tab and click on the Icon
From the dropdown menu choose »Image files« and go to this folder:
and choose the »« file, then OK
Close the Whisker menu pop up

There are 5 more items in the taskbar which are not yet assigned. They look like blue boxes with a cog. In the official AmiKit they are, from left to right the first four are:
Show AmiKit
And the one in the middle is:
Chromium B.S.U.

For the first item, right click, choose properties, add, and search for »File Manager«, choose add, close and close.
For the second item, right click, choose properties, add and search for »Firefox«, choose add, close and close.
For the third item, right click, choose properties, add and search for »LXTerminal«, choose add, close and close.
For the fourth item, right click, choose properties, choose »Add a new empty item«: Fill like this:
Name: ShowAmiga
Comment: Shows AmiKit Desktop (if it's running)
Command: wmctrl -R Amiberry
Icon:.. Click on the icon, from the dropdown menu choose »Image Files« go to home/amikit/RabbitHole and choose
Click Create, Save and close.
For the fifth item, right click, choose properties, add and search for »Chromium B.S.U.«, choose add, close and close.

We can also add a desktop shortcut for LX Terminal:
Click on the start button, search for LXTerminal, right click on it and choose »Add to Desktop«

Updating Amiberry for RPi5

Go to
and download this version of Amiberry:

Go to your Downloads folder and unpack it (right click > Extract Here) to your downloads folder.

From the folder /home/amikit/Amiberry/conf/ copy these two files to the new version of Amiberry-v5.6.5-debian-bookworm-aarch64-rpi5/conf/ in your downloads folder:

You can now delete the contents of the /home/amikit/Amiberry/ folder and replace with the contents from amiberry-v5(etc) in your downloa

Author wiisoldier
#3 Posted: 9 Feb 2024 23:26 

We need to adapt one of the config files.

Run the AmiKit file on the desktop, but do not click Start
Go to the Hard drives/CD tab

The fourth item in the list is wrong. Click on the three dots next to USB, then on the three dots on the pop up. Navigate to /media/amikit then change the volume name to USB and click ok.

Go to the Configuration tab and click Save, then quit.

I now recommended making a backup of the home/amikit/Amiberry folder. I recommend putting the backup in your home/amikit/Documents/ folder for ease of access. You may need this after running any or all the AmiKit updates, as AmiKit for RPi4 uses a different version of Amiberry. It is also a good time to make a backup of the home/amikit/AmiKit/ folder in the same location.

If you run an AmiKit update and it fails to start, copy the /home/amikit/Amiberry/conf/ folder to your documents, delete the contents of /home/amikit/Amiberry/ and replace with your backup then add any new config files from the new backup of the conf folder. We can see this more, later in the updates section.

RabbitHole items:
Some RabbitHole items will not work in this version and need to be adapted:

Open the folder home/amikit/RabbitHole
Right click on Terminal (Not and select «Open with Mousepad»
Remove everything and replace with:
host-run lxterminal

CPU Temp:
Right click on CPU temp and select «Open with Mousepad»
Remove everything and replace with:
host-run lxterminal -e cpu-temp-speed

We also need to add the program: If your original RPi4 version of AmiKit is still in the usb go to «ROOT_MNJRO»
Open the usr/bin/ folder, right click and choose «Open terminal here»
In the terminal type:
sudo cp cpu-temp-speed /usr/bin/

Some of the desktop items will need to be activated the first time they are used. If you see any options when using them choose «Mark as Executable».

The last thing needed is to create a folder for the «Boot Mode» to work.

From the desktop open the «Home» folder/icon
Make sure view is set to «Show Hidden Files» and go into the .config folder
Create a new folder called autostart

That should be it. You now have a working copy of AmiKit for RPi5. Remember, however, that this is not officially supported.

I just decided to make a version that works with my RPi5 and shared how I built it. If you see any bugs or errors, please let me know either here or in Discord. If it works for you, please let me know also.

At this point you can now follow AmiKit's instructions on adding roms and the Amiga OS.


Testing The Updates:


v11.9.0-v12.0.0 updates with only two issues:

1: We need to adapt one of the config files.
Run the AmiKit file on the desktop, but do not click Start
Go to the Hard drives/CD tab
The fourth item in the list is wrong. Click on the three dots next to USB, then on the three dots on the pop up.
navigate to /media/amikit then change the volume name to USB and click ok.
Go to the Configuration tab and click Save, then quit.)

2: Three new desktop items added and not required:
Remove 1: Terminal Emulator
2: File Manager
3: Web Browser
(they work but are not needed. Keep them if they are useful to you)

Once done I suggest making a new backup of the Amiberry folder in Documents (call it Amiberry002)

No issues although Amiberry is downgraded to v5.5.1 but works
No issues although Amiberry is still v5.5.1 and works
No issues although Amiberry is still v5.5.1 and works
Update libraries = Y
The terminal fails to launch (different script for Manjaro to RPi OS)
Relaunch AmiKit:
It fails (close it)
Open /home/amikit/Amiberry
Copy /home/amikit/Amiberry/conf/ folder to a new location (i.e. /home/amikit/Documents/Amiberry003)
Delete all files and folders in
Open /home/amikit/Documents/Amiberry (the original backup)
Copy all files and folders to:
Delete the folder /home/amikit/Amiberry/conf/
Replace with /home/amikit/Documents/Amiberry003/conf/
Start AmiKit (desktop)
AmiKit loads / change Display prefs / Save and Enter
AmiKit v12.4.0 is working
Make a new backup of Amiberry (i.e. /home/amikit/Documents/Amiberry004)

Final thoughts:

Jan has spent 10's of thousands of hours building AmiKit, it is exceptional and rises far above any other Amiga emulation I have seen. Spending even just a little time building this version for the RPi5 has been a challenge. There are issues with it because there are issues with the new OS for the RPi5. Raspberry PI has taken a huge leap forward with the RPi5 OS, however it is causing some problems for developers. After four months we are yet to see a stable archlinux OS for the Pi5 and other programmers are still facing challenges.

However, the new RPi5 may have created something good for the rest of the «emulation» community. The older Pi4 may come down in price and, if I am being honest, it's all that is needed to emulate a wonderful creation such as AmiKit (and others) on the RPi platform.

I created this version as a challenge to myself. To test my ability with Linux, Amiberry and AmiKit. I think I did an «OK» job. It looks good and performs well. Newer updates may create more of a challenge and I don't expect Jan to deviate from the current RPi4/Manjaro package in the foreseeable future (why should he?).

So, for the time being, if you want AmiKit on a Raspberry PI, buy the RPi4 as it works perfectly. If you have a RPi5 and want to do some testing, read the instructions above and have some fun. I know I did.

Please offer feedback and advice as I love to learn new things (even at my age). I know many others sing the praise of AmiKit in the forums and in Discord and I totally agree. For me AmiKit was a new awakening to the power of the Amiga, the ability to write script and to help «where I can».

February 2024

Author saghalie
#4 Posted: 12 Feb 2024 21:33 
Thanks for this.

Basic questions, I am new here AmiKit Support Forum / Basic questions, I am new here /
 AmiKit on Raspberry PI 5

Your Reply Click this icon to move up to the quoted message

Only registered users are allowed to post here. Please, enter your username/password details upon posting a message, or register first.


AmiKit Support Forum Powered by Forum Script miniBB ®