its dangerous to go alone read this!

**pimiga is free, it is not sold, not charged, no fee. You do not need to buy it, pay for it, or have someone make you a file or a license.

Pimiga is a registered Trademark.
 
This is not to be resold. There is no explicit permission or grants of permission given by me (dr Chris) to anyone,any site,or web seller
Pimiga is free as a downloadable operating system that YOU make work. 

**contains NO AMIGA kickstart ROMS and will not work until you bring your own**
**this product is packaged as non working untill the end user provides their own workbench roms*****

get them from cloanto for 12$ or the google play store for 1.99$ called amiga essentials from cloanto. 
https://play.google.com/store/apps/details?id=com.cloanto.amigaforever.essentials&hl=en_US&gl=US

if you own other manuf roms you can use them if you also copy the workbench.library over the exsisting 3.9 one
do not overwrite peterk's icon.library or png icons wont display proper u have been warned.



What is Pimiga?, Pimiga is a tribute to what the Commodore Amiga might have been. This tribute runs on modern Linux Debian 13 "Trixie" 
using Amiberry as its 68K emulator.

It is based on 3.9 with ClassicWB and uses Scalos workbench replacement and may other upgrades from Aminet and other public free utilities. 

requirements: Rpi4/400,5/500/500+ Intel/AMD or intel apple machines that support UEFI booting. 

SIZE REQ:
64G Microsd/Thumbdrive/ssd/nvme or greater. 


instructionsfor all: you know.. "how do i do this", or "why dont this work?" 
 

1: unpack image. Burn image with writer of your choice (rpi imager or Balena etcher) to device of your choice. MicroSD for rpi, USB3 thumbdrive, or even a Nvme SSD for internal replacement in a device, 
or a old school sata SSD to replace a intel pc's hard disk with and have a standalone Pimiga PC!

1a: When image writing is completed, eject card and re insert your device . the device should mount as a drive letter, 
**are you not seeing a kick partition in windows? run diskmgmt.msc and add a drive letter to the 128mb partition, then it will show.

2: copy an Amiga 1200 3.1 to the 128mb partitions boot/firmware/kick folder
The file MUST BE NAMED kick.rom  in lower case

Specific intel/AMD/ Mac instructions


RPI SERIES DEVICES (intel/intel mac/amd scroll down)

burn image, eject disk , reinsert disk, copy amiga 1200 3.1 kickstart rom to /boot/firmware/kick folder rename to kick.rom
if you have old rom copy your rom.key also. New rom purchasers must run their purchased emu (amigaforever) once to decrypt its roms.

remove card and stick in RPI device . Upon first boot the OS will Auto Expand your filesystem giving you full free space on your card or device.

Press F12 and Quit. you will be returned to Debian Trixie Desktop. here you can use the system menus or desktop dock icons to configure your wifi,Bluetooth
timezone, locale etc. 


Pimiga is set to PAL with UAE1920x1080x32 by default. 

SOUND 3.5 on PI3 or Pi4 or usb audio?  inside Amiberry under the sound there is a dropdown menu at the top
simply select your sound card . then click config/save


want more punch? oveclock it open a terminal window and type

sudo nano /boot/firmware/config.txt

scroll to the bottom and remove the # marks from the two entries of force_turbo and Arm_Freq
as shown in the pi4 series text below.

[Overclock dis bitch remove # from whichever to turn on]

[pi4 series]
force_turbo=1
arm_freq=2000
#you can go as high as 2200 safe or more w cooling

[pi5 series]
#force_turbo=1
#arm_freq=3000
#you can go as high as 3100 safe or more w cooling


Ctrl x save and reboot


Joysticks/Controllers: plug in at boot, configure in emulator (f12/input port 1 drop down . select your controller, resume, or save config resume.
 if not using a controller leave amiberry setting to disabled for port 1 , or keyboard may place a 2p when pressing "2" and other weird key issues. 

Bluetooth device? - Pi4 and 400 have BT5.0 built in , range sucks, but its there. to pair a device, top right of linux bluetooth menu, click the bluetooth icon and pair your device. 
**note some controllers like Xbox or PS3 and 4 have to be plugged in when pairing. once paired you can trust it to autoreconnect. then when pimiga starts, 
F12/input your dropdown for controller to your device. then config/save  and resume. your good for next time. 
IF the controller is turned on before pimiga is turned on it will auto bluetooth reconnect. 

USB: 
hot swappable- mounts on pimiga as USB:  wait for the popup before you access it inside pimiga. *note right click show all files to see the items on your thumbdrive. or just quit the emulator and use Xfce file manager to do what you need. 




INTEL: 

burn image (rpi imager or Balena etcher), eject disk , reinsert disk, copy amiga 1200 3.1 kickstart rom to the only fat32 drive your pc will see DO NOT FORMAT OR INITIALIZE
any unknown disk, your PC does not read Linux Ext4 by default! its path is /boot/firmware/kick folder rename to kick.rom

if you have old rom copy your rom.key also. New rom purchasers must run their purchased emu (amigaforever) once to decrypt its roms.

boot from uefi menu on pc' or mac hold alt key on power on and choose usb device - turnoff secure boot!
Grub bootloader should load in blue and auto load Pimiga

EXPAND FILE SYSTEM

on intel devices from the terminal or desktop menus launch or run from terminal  
sudo gparted
make sure you drop down your device to the correct one if booting a usb/other so you dont overwrite your internal hard disks. pay attention to this. 
if you erase your own hard drive because you failed to understand this then it is on you!!!!
right click on the 63gb partition and choose expand/resize  drag arrow to end of disk to fill avail space. click green checkmark. it will proceed. no reboot necessary. launch pimiga when complete. 

WIFI/ETHERNET/ AMD Graphics cards

the vast majority of devices were added for drivers. you may have to right click enable wifi in the xfce menu. if your device is not showing up try ethernet. if you even need to use it online. 
worst case you can run sudo synaptic from the terminal and once loaded search "wifi" and in the results you can simply select any missing firmwares it finds. The Same goes for newer AMD graphics cards. 
I did not load everything in the world as there are too many and it would make the download size of the image unbearable. a basic vga looking no driver can get you to the package 
maanager where you can search and select the firmwares "aka drivers" to install. then just
click apply/install and reboot. hopefully this works. ethernet should work on almost anything you can try. 

Joysticks/Controllers: plug in at boot, configure in emulator (f12/input port 1 drop down . select your controller, resume, or save config resume.
 if not using a controller leave amiberry setting to disabled for port 1 , or keyboard may place a 2p when pressing "2" and other weird key issues. 

Bluetooth device? - to pair a device, top right of XFCE menu, click the bluetooth icon and pair your device. **note some controllers like Xbox or PS3 and 4 have to be plugged in when pairing. 
once paired you can trust it to autoreconnect. then when pimiga starts, F12/input your dropdown for controller to your device. then config/save  and resume. your good for next time. IF the controller is turned on before pimiga is turned on it will auto bluetooth reconnect. 

USB: 
hot swappable- mounts on pimiga as USB:  wait for the popup before you access it inside pimiga. *note right click show all files to see the items on your thumbdrive. or just quit the emulator and use Xfce file manager to do what you need. 

thats it!


username pi
pw pimiga

root pw pimiga

partition info: loaded from /home/pi/pimiga/disks

System:= DH0 - Amiga Operating system, and program locations.
Demos: = DH1 - Demos/roms/whdload demos.
Games: = DH2 - Games,whdload directories for iGame, and doom.
Work:  = DH3 - books,docs,downloads,graphics for Scalos wb pics etc, videos.
USB:   = DH4 - usb mount see notes on usb above.


remember nothing is perfect in Amiga land. but this is fun.
This image is for you to make functional and customize to your liking. 

Thank you Amiga user for using this. it helps keep the Amiga alive in one form or the other. I hope it brings a smile or two. 




A Special Special thanks to the OG "Paul C" aka Rockheddie for the endless hours of building the original pimiga. 
laying the base that would become these newer versions, and for having the idea making this possible.

Ssecial thanks to:
MiDWaN for the amazing Amiberry emulator. your frequent updates. and my 9 million issues and question assistance with 50hz audio sync! 

Bloodwych for the original ClassicWB

Henrik S for the amazing HstWB.

Thanks to all the "testers" for helping out with troubleshooting, identifying and helping the fixes for the many problems. 

TRU, Wiretap, Renegade, FreeMilk. 

finally thanks to all the original authors of the software used on this image. 

if you made it this far, we have a discord for additional assistance, which is linked in my about me page links of my youtube channel. 

now i gracefully bow out. thats all folks. im done. 

Enjoy.

"Dr" Chris 
December 2025