Beta v1.

2b
Lockdown Edition

for raspberry pi 3 & 4

Released: March 2020

What Is This?
This is a preconfigured auto booting image for Raspberry Pi4 and the Pi3, using the amazing Amiberry emulator. It
contains a fully loaded RTG Amiga Workbench using Picasso96 with audio support provided by AHI.

The image is built on top of ClassicWB, so if you've ever used any CWB before you will feel at home fairly quickly with
this. If you haven't then shoot over to the ClassicWB website and read the docs for some tips and directions.

What this is not

This is not a professional setup like AmiKit, AfaOS etc. Those are incredible distributions with many hours of effort
and a deep level of customization. This image is in beta for now, and will grow and mature over time.

Why?
I've been using Raspberry Pi's for quite some time and enjoy their speed, versatility, and low price point. I tinkered
with this on a casual basis over a couple of years. I began to see the same questions on Amiga forums about having a
ready to run system out of the box, with a nice Workbench setup and ready to use. And while hesitant at first to
share my work, I eventualy decided to make this available for everyone.

How to Setup
On all versions of this image I have created a small fat32 parition called "KICK". This partition should be readable on
all operating systems. It will also facilitate as a way to upgrade and install patches in future versions.

So how do we get this up and running then? You have a couple of options here.

Setup method 1 (Local ROM copy).

(1) Unpack the image and write it to an SDCard, 32GB minimum.

(2) Open the KICK partition and copy your legally obtained kick roms into it, they need to have this specific naming
convention exactly as shown, or else it won't boot without some further configuration. The default config is foir the
A1200, as such it needs the A1200 kick rom, so make sure that you put it in this partition.

Note: If you're a Mac user, some people have advised that if the KICK partition doesn't show up Immediately after
flashing to simply eject the sdcard and reinsert it again.

(3) Safely remove your sdcard and insert it in to your Pi4, power up and have fun!

Setup method 2 (SFTP over LAN).

(1) Unpack the image and write it to an SDCard, 32GB minimum.

(2) Your kick roms need to be transfered to a specific location on the sdcard. The location is slightly different
depending on which version of the PiMIGA image you are using.

For Pi3: /mnt/kick/

For Pi4: /media/kick/

Transfer your kick roms using an FTP client, such as Filezilla. You will need to know the IP address of your Pi on your
network. If you;''re not sure how to do this you can refer to this guide:
https://www.raspberrypistarterkits.com/how-to/find-raspberry-pi-ip-address/
For connecting to your Pi you will need the correct credentials, these are:

For Pi3: User: dietpi Pass: pimiga

For Pi4: User: pi Pass: pimiga

Quick Tips

After a first boot if you do a reset, try holding the left mouse button at bootup, right mouse button as well for extra
features and menus that CWB includes.

Compatability: Some software will need you to change some Amiberry settings, you can do this without even having
to pause emeulation by using UAE Control which is on the Workbench screen.

Backdrops: From the screenbar menu you will find different categories of wallpaper which I have set to randomize.

There are 5 categories of Backdrops, the Mixed category contains all the wallpaper of the other 4 in one preset.

Default is Gradients/Mixed.

If you would like to keep just one picture permanently, open up Scalos Pattern Prefs, this can be accessed from the
screenbar System menu.
Update Packs
These will come in the future along with newer versions of this image. I am open to what you might want included
on this image, you can join in on my Patreon or email me if you have an idea. Off the top of my dome I was thinking
of categories such as these: 3D Games (Doom, Quake etc). Music packs for various systems & artist collections.
Graphics Packs, Software categories etc.

ToDo
⦁ Move away from ClassicWB, create WB3.9 and 3.14 versions from the ground up.

⦁ Optimize & speed up boot time.

⦁ Some default applications still need setting up for filetypes.

⦁ Get USB MIDI working. Setup Audio software to work with this.

⦁ Create playlists for AminetRadio for all music and modules by category and artist.

⦁ Create a custom themed MUI skin for use in all mui software.

⦁ Optimize icons and wallpapers for faster loading.

⦁ Sort iGame and remove duplicates, add new launchers.

⦁ 'Fix' legacy software and create autobooting scripts for troublesome programs.

⦁ Setup & configure all emulators, add Shapeshifter emulation.

⦁ Add newer Amiga software, dropbox, twitter, torrent etc.

⦁ Add a much more comprahensive & sorted demoscene collection.

⦁ Create a more useful coder centric environment for cross development.

⦁ Organize Demo, Games, Art, and Music folders properly, add icon thumbnails for graphics and videos.

⦁ Alot of tidying up the directories, icons, layouts, etc etc.

Bugs & Issues

There are a few cases where you might crash out of the emulation, exiting out of some demos can do this for
example. I am looking in to this to make the system more stable in the future.

The video player currently is not fully configured, as such it struggles a little with the videos on the image. This will be
fixed in a future version so that videos play silky smooth.

Some demos have issues with JIT, and also a few settings might need tweaking to get some demos to run, you can
boot to an early startup to make some demos and software work correctly!

I may in the future make scripts for stubborn legacy software to automate the proccess and make life easier.

Some programs will need you to use only native screenmodes to work, for example DeluxePaint will crash if you try
to use any uaegfx screenmodes. Be conscious of this when you are working and chosing screenmodes.

Trouble shooting
For using your gamepad and other peripherals you may need to configure the emulator, this is easy enough to do.
Simply open up the Amiberry interface using the F12 key and tweak the settings to your hearts content.

Some games and demos may run too fast or have timing issues, you can fix this in one of two ways. Firstly you could
open the GUI and change the cpu speed from Turbo to Fastest. Or you can use the UAE-Control program on
Workbench to set this without having to pause the emulation, you can also set it back after your game or demo
session is done.

If you need to access the configuration tool for any reason, first exit emulation (F12 - Quit), Login using the details
provided in this guide, and use these commands:

For Pi3: sudo dietpi-config

For Pi4: sudo raspi-config

Legal Stuff
You are free to share this image, but please don't sell it on ebay or whatever. I have done my best to put this out
there without stepping on any toes. Innevitably though I will have probably forgotten something that I needed to
remove. Anyone who finds something like that please send me a nice email and I will remove it for the next version.

Thanks & Credits

This image would not have been made possible if not for the following talented and helpful people:

MiDWan for the amazing Amiberry emulator and his frequent updates and bug fixes.

Solskogen of the Amiberry team for his helpful and patient advice.

Bloodwhych for the original ClassicWB distributions which this image is based on.

Henrik Stengaard for the amazing HstWB and support and advice in this project.

Kevin Orbaker for his generous hosting and help getting PiMIGA off the ground.

TEKK for his incredible diligence in beta testing & bug reporting, as well as helpful suggestions & continued support.

PeterK for his helpful advice and icon expertise.

Thanks also go to these guys for hosting help and more, Kevin Orbaker, David Ziegler, John Vella, Stian Eng Holte,
Olivier Bernhard.

All the authors of the software used on this image. If I have forgotten anyone just hollar at me!

_____________________________________________________

Contact
For any questions related to PiMIGA you can get in touch with me via email: pimiga20@gmail.com

If you feel like you want to support me and further development of these images, or even just buy me a beer, I would
welcome you to check out the PiMIGA Patreon page: https://www.patreon.com/pimiga

Change Log

Public Beta 1.2

Added A1200 config which is now the default.

iGame updated to v2.0-beta4.

SysInfo v4.3 added.

Pi HDMI mode set to 50hz, suggested by Stian Eng Holtet.

Partition layout improvement, suggested by Billybob Billyboba.

Configuration and kernel tips, suggested by Olivier Mallo.

Public Beta 1.1

Disabled Wait for Network for faster boot time, a lot quicker now.

Fixed default audio setting to Force HDMI, audio should now work after initial setup.

Changed name to 'Lockdown Edition'.