• AddressLast updated on 17-10-2021 14:58



To use any of these options you need to start up PCUAE Options Menu by pressing on the keyboard CTRL+0 or on THEC64 Joystick, Hold Down Menu Button+Left Fire Button.

1 About PCUAE and Overview

2 How to use Vice Mode

3 How to Change Carousel Gamelist Screens

4 How to Use Midnight Commander

5 How to use Firmware Mode

6 How to use Gadget Mode

7 How to use Autoboot Mode

8 How to Use Admin Pass

9 How to Use Jiffy Dos Mode on C64/VIC20

10 How To use PAL / NTSC in Carousel / Classic Modes

11 How To turn off Splash screens

12 How To use Linux Mode

13 Get GUID from a Controller or Joystick and How to use SDL2 Gamepad Tool


14 How to use NANDbackup

15 How to use atari mode


1 About PCUAE and Overview

PCUAE Overview – Modes, Options, Shortcut Keys.


We now have 5 different main modes in PCUAE and many new options.
1 PCUAE Mode – Enhanced with multiple 255 game carousels & options.
2 VICE Mode – 7 Classic Machines with VICE menu options & more.
3 Linux Mode – X Windows access to the file system.
4 Firmware Mode – Run standard Carousel, upgrade your firmware.
5 Gadget Mode – Connect to a PC and access the USB stick & more.

N.B. Gadget Mode has 2 sub modes:

Game Manager Mode to copy over from PCUAE Game Manager to the USB and
Nand Mode for restoring firmware.

Quick Start Guide


CTRL+F1 – Switch to VICE Mode, Exit all modes & return to TheCarousel.

CTRL+1 to 7 – select a VICE machine to run

  1. The Commodore PET – Vintage 1977 green screen beauty.
    2. Commodore Vic20 – 1982 The Friendly Computer.
    3. Commodore 64 – 1983 The best seller.
    4. Commodore Plus/4 – Less popular but an interesting machine.
    5. Commodore 128 – 128K, CP/M and C64 Mode on GO64.
    6. Super CPU C64 – This one only runs about half speed
    7. Commodore 64 DTV – A C64 with games built into a joystick.

CTRL+SHIFT+F1 – Launch Linux Mode
CTRL+Z or Menu+Right Fire Button – PCUAE Option Menu, lots of extras.
CTRL+SHIFT+F7 or Menu+Left Fire Button – Carousel Gamelist Loader Screen.
When I say CTRL+ below, I mean hold down CTRL Key then press and hold
the specified key.
Hold down both keys together for about 2 to 3 seconds or until you
hear the music stop or see the screen change and go black.
The selected option may take up to 1 minute to reboot and start
VICE Mode, VICE Mode/Linux Mode only works if you have added Autoboot Start-Up
script to the Firmware. See the PCUAE Option Menu.”

Key Combinations


CTRL+F3 – To change to TheCarousel v1.05.
This was the first version of TheCarousel that was released with
THEC64 Mini on March 29th, 2018. It has no File Loader.

You can use FIBR to load Commodore 64 program files (PRG, P00) and
to load SID Chip Tunes Music in TheCarousel 1.05.
The other carousels are not compatible with FIBR.
TheCarousel 1.05 uses the directory driver in VICE, TheCarousel 1.3.2
and higher use the image driver and FIBR does not work in them.
If you load FIBR in another version of TheCarousel you will not see
any files available in it.
When you run TheCarousel v1.0.5 for the first time it makes a symbolic
link file to libpng in the firmware, it does not work without it.
It is like a shortcut on a desktop, telling the Carousel where the
libpng library is so it can find it. It is used with saved games and for
showing the screenshots of the games in TheCarousel.

CTRL+F5 – To change to TheCarousel v1.3.2 More info on this carousel below.

CTRL+F7 – To change to TheCarousel v1.5.2. (3 versions to choose from in PCUAE Option Menu)
If you have THEC64 Mini, then it will run THEC64 Mini version of TheCarousel 1.5.2 Argent.
If you have TheC64 Maxi or TheVic20 its will run TheCarousel 1.5.2 Amora or Ares but you can run any of the 3 versions on THEC64 Maxi/VIC20 only, Amora and Ares carousels do not run on THEC64 Mini.It can now remember what carousel was run last, but if you leave it on Amora(THEC64 Maxi Carousel) and take the PCUAE USB Stick out of THEC64 Maxi and put it into THEC64 Mini, it will automatically run Argent(THEC64 Mini Carousel) because Amora carousel does not work on THEC64 Mini, it will do that to if you have it on the Ares(THEVIC20 carousel) too.

CTRL+RESTORE (CTRL+TAB on a USB PC Keyboard) – This makes the machine
reboot, not the emulator – Just reboots, nothing special, you never know when you need a reset button… 🙂

CTRL+/ (forward slash) – Turn off CTRL 1 to 7 in VICE Mode
You need this if you are in a VICE machine to do some programming, if you need to change the color of the cursor by using CTRL and one of the number keys.

PCUAE Mode TheCarousel 1.3.2 C64 Emulator control keys


These Shortcut Keys ONLY work inside the C64Emu that is part of
TheCarousel 1.3.2 (CTRL+F3).They are not for TheVic20 Emulator.

CTRL+Left Arrow Key(above CTRL Key) – Joystick Swap,
Switch Joystick Ports(Joy Port 1 to Joy Port 2 or Joy Port 2 to Joy Port 1) You will see Joystick Swap on the screen when you have swapped joy ports.
(In the carousel 1.5.2, the buttons are Menu button+B button for Joy Port 1 and Menu button+C button for Joy Port 2).

CTRL+F = Freeze Button – this is for Action Replay.

CTRL+R = Soft Reset – use this after you have used SID Swap
then it will reset the C64 and swap the SID.

CTRL+H = Hard Reset.

CTRL+S = SID Swap – 6581/8580 – you need to a soft reset
after you have done this for it to change SID Chips.

CTRL+W = Toggle Warp Mode – speed up loading times.

CTRL+U = Toggle User Port Joystick Mode.

CTRL+/ = Help Menu, see the shortcuts on the screen.
Thanks goes to Gurce for making this possible.. 🙂 RGL added this to the latest version of the carousel, the shortcuts for them are added to THEC64 Joystick and the power button, but then never added SID Swap/User Port Joystick Mode or Warp Mode to 1.5.2.

The PCUAE Option Menu


THEC64 Joystick works on the PCUAE Options Menu with THEC64 Maxi or THEVIC20 only.
It not compatible with THEC64 Mini, maybe one day it will be, if we ever get the updated source code, but you can still use the CRSR Keys to navigate or the Arrow keys and Enter and use Tab key to switch between OK and Exit buttons (at the bottom of the PCUAE Option Menu) on a USB PC Keyboard.
CTRL+F8(SHIFT+F7 PC keyboard) or Menu Button (Button 4 on the back of THEC64 Joystick)+Right Fire Button.
If using Classic Mode, use CTRL+SHIFT+F7 to load the PCUAE Option Menu.
There are more options in this menu for you to try out, more info about that in the other sections of the Help Menu.

TheCarousel Gamelist Loader


CTRL+SHIFT+F7 or Menu+Left Fire Button to launch the gamelist loader screen.
Select one of the C64 or Vic20 or your own carousels.
Make your own carousels on a PC with PCUAE Game Manager.
Each carousel can hold up to 255 entries.

2 How to Use VICE Mode



To enable VICE Mode you need to copy the Autoboot Start-Up Script
to your machines Firmware first, otherwise it will not work and just boot PCUAE Mode instead.
Autoboot is an option in the PCUAE Option Menu where you can install the start-Up Script to your Firmware and turn it on and off
N.B. VICE Mode will not work if running PCUAE from the Fake Update.
Once VICE Mode is enabled by setting Autoboot use CTRL+F1 to launch.
VICE Mode (Versatile Commodore Emulator) works with all machines.
If you power down in VICE Mode you can boot straight into VICE Mode instead of Carousel or Classic Mode next time.

Information on VICE Mode resolution


Vice Mode on the THEC64 Mini has a stretched display if set to full
screen and the aspect ratio is incorrect.
It can show in 4:3 aspect ratio but only if you enable Full Height Mode
in VICE Mode. This is a limitation of THEC64 Mini.
On TheC64 Maxi and THEVIC20 machines the VICE Mode display is at full
screen and 4:3 aspect ratio.
You can change machines in VICE Mode by using CTRL+1 to 7

VIC-20 (CTRL+2)
C64 (CTRL+3)
Plus/4 (CTRL+4)
C128 (CTRL+5)
SuperCPU64 (CTRL+6) it does work but only at low frame rate
C64 DTV (CTRL+7)

Menu button on thec64 Joystick will bring up VICE Emulator settings.
CTRL+SHIFT+F7 or Menu and RIGHT Fire on THEC64 joystick to load the
PCUAE VICE Mode Configuration Menu.
CTRL+RESTORE(CTRL+Tab on a USB PC Keyboard) – This makes the machine
reboot, not the emulator – Just reboots, nothing special, you never
know when you need a reset button…
CTRL+F1 to exit VICE Mode and go back into PCUAE Mode.
If you leave VICE Mode it does remember what machine you used last.
Next time you boot up to TheCarousel and switch to VICE mode it will
be the last machine you used.

VICE Settings Menu


Press the joystick Menu button and you will see the VICE Settings menu.
Use this menu to explore the full power of the emulated machine.
e.g. configure keys or joystick settings.
If you have set Full Height mode in VICE Configuration Menu then
be sure to set Full Borders in VICE Settings display menu and then
save your configuration for next time.
When VICE Mode loads up, the first machine it loads into is the
C64 by default.
There is an option in VICE Configuration Menu that enables Full Height
Display, it allows you to see more of the border. On THEC64 Mini
it will be a 4:3 display instead of stretched across the screen.
The screen is a bit smaller but better than when stretched
and not the right aspect ratio. It is hard to get a proper size
screen on THEC64 Mini because of resolution limitations.
You can disable the CTRL key shortcuts in VICE Mode if you want
to use the keyboard in Basic. This is useful in Vice Mode to
avoid launching a different Vice machine while typing a program.
Press CTRL key and Forward Slash (CTRL+/) Keys on THEC64
Maxi/VIC20 or on a USB PC keyboard on THEC64 Mini to disable or
enable the CTRL key combination.

3 How to Change (CGS)Carousel Gamelist Screens


Press the Menu key and left fire button or Press CTRL+SHIFT+F7
to select a new gamelist in the Carousel Gamelist Loader.
Select a new gamelist and the Carousel will load with up to 255 items from that folder.
To make your own lists see PCU Game Manager topic on the forum.
You can create a whole range of carousels to sort games, demos etc.
How you want to e.g. alphabetically, by year, by game type etc.
You can import from GameBase with PCUAE Game Manager – huge collection too.
Once imported you can sort then export to carousels/folders
You can use them in VICE Mode too but export them as cjm files to extragames folder,
you be able to load them in VICE Mode and in the File Loader in Carousel/Classic Modes too.
Vice Mode can not load the games from the carousel cause they are compressed.

4 Midnight Commander Help


You will need to use a USB Keyboard with THEC64 Mini and maybe also
with THEC64 / TheVic20 because they do not have all the keys available.

File system navigation.


Navigation of the filesystem in the directory panes is accomplished
with the CRSR (Cursor) and RESTORE (Tab) keys.
The SHIFT and CRSR keys allow selecting a file or directory.
Press the RETURN key to enter a highlighted directory.
Select the double dot (..) entry and press the Enter key to navigate to
the parent of the current directory.
Use the Tab(RESTORE) key to switch between the two directory panes.

Basic file operations


Navigation of the filesystem in the directory panes is accomplished
with the CRSR (Cursor) and RESTORE (Tab) keys.
The SHIFT and CRSR keys allow selecting a file or directory.
Press the RETURN key to enter a highlighted directory.
Select the double dot (..) entry and press the Enter key to navigate to
the parent of the current directory.
Use the Tab(RESTORE) key to switch between the two directory panes.

Basic file operations


Once you have located and highlighted a file on which you want to
perform some action, the function keys provide shortcuts to basic
file operations such as copy move, delete and so on.
To delete a file, for example, locate the desired files, highlight
them and press the F8 key to delete the file or files.
Midnight Commander will display a pop-up that asks whether you really
want to delete the file(s), answer Yes to complete the deletion.
WARNING: You can also delete directories and entire directory trees
and all of their contents recursively. (All sub-directories as well)
Midnight Commander will ask you to verify that you wish to do that.
Use the F5 key to copy highlighted files from one panel to the other.
Use the F6 key to move highlighted files to the directory in the
other panel.

Viewing files


Midnight Commander allows viewing of text files.
Highlight the desired file and press the F3 key.

The CRSR keys allow scrolling of long files.
The F3 key or pressing Run-Stop key (Esc on PC) twice will
return Midnight Commander to the directory panel.
echo ” You can also edit files by pressing F4 key instead of F5 key.”
echo ” To Close Midnight Commander type exit then press return twice.

5 How to use Firmware Mode


Firmware mode will disable PCUAE so you can safely upgrade firmware
while using PCUAE USB stick.
Boot into firmware mode, run settings and upgrade then reboot.
Once the firmware is upgraded (check settings menu) you can end.
firmware mode and restart PCUAE with CTRL+F1 or run fake firmware.

If you try to upgrade firmware using the PCUAE USB stick without going
into firmware mode it will overwrite PCUAE and corrupt it. In this case
you will need to format a USB stick and reinstall PCUAE.

Alternatively power down, remove PCUAE USB stick and upgrade firmware
using a clean USB. Reinsert PCUAE USB, restart the machine and PCUAE
by using the fake firmware in settings if it does not autostart.

6 How to use Gadget Mode


Gadget Mode only works on TheC64 and The Vic20 and not on TheC64 Mini.
If you are fed up swapping USB from TheC64 to PC and back try this.
You will need a USB A to USB A Cable.

You might have one of these cables in the cupboard if you had an
external CDROM or Hard Drive some time ago.
Some have 2 USB A plugs on one end and one USB A on the other end.
If you haven’t got one they are available online quite easily.

Connect TheC64 USB to the PC USB and run this mode.

You can copy files to/from TheC64 to the PC and/or delete them.
N.B. YOU CAN NOT edit the files on the USB stick as it can corrupt the
files on the USB stick. Use Copy and Paste only.
Eject the drive to return to PCUAE.

You can enable the Virtual Gadget Port on ttyGS0 as well to use only in
VICE Mode e.g. with a C64 Emulator get serial access for BBS boards.
This is a new feature, more about this as it develops.

More details about the different Gadget Mode capabilities on the next
couple of pages.

The USB stick will be mounted as a drive on the PC.

PCU Game Manager Mode


You can add games by using the PCU Game Manager to export games onto
the USB stick by PCU Game Manager Mode within Gadget Mode.

For this to work you will need a USB A to A Cable and connect one end
to the USB Port on the back of the machine(THEC64 Maxi/THEVIC20 Only)
and the other end plugged into a USB port of your PC
running Windows 7/10 or Linux.

Once PCUGM Mode is running, run PCU Game Manager on your PC then you
can export the games you want. This is equivalent to having the USB stick
plugged in to your PC.

Now select the new USB drive that has popped up and then export the games

you want to add to the drive.

plugged in to your PC. Now select the new USB drive that has
popped up and then export the games you want to add to the drive.

Once finished, close the File Browser and wait about 5 seconds for
file copying to complete before ejecting the USB stick.
PCUAE will now reboot the machine to refresh the games added.
echo ” if you have done this correctly you should see them in TheCarousel.

You do not need to close PCU Game Manager, you might want to add more
games after rebooting the machine and enabling PCU Game Manager Mode
again to copy more games over to TheCarousel.




You can copy (make an image of) your nand by using Win32 Disk Imager
application on Windows 7/10 or a disk imaging app on Linux and copy
NandA and NandB.

Once you have created images, eject the Nanda and Nandb on the PC then
PCUAE will reload TheCarousel.
Gadget Serial Port Parmeters-: 115200,N,8,1, look in Device Manager on
Windows 7/10 to see what port the Gadget Port is on to add it to putty
or another terminal program.

You should see the NAND as two new disk drives with their own drive
letters now.
Windows 7/10 you will not be able to see what is in the drives.
You can’t see inside NandA because it is an Android Kernel and not a
file system. You can see inside NandB in Linux because it is an Linux
ext4 file system. You can make an image of both NandA and NandB on
Windows 7/10 using Win32 Disk Imager.

7 How to use Autoboot Mode

You want this if you want to have different carousel on bootup.
You want this if you want to start directly into VICE or Linux Modes, they do not work without it.
Let me put it simply, you want this and then forget about it 😉
N.B. Autoboot adds a small file to firmware. It lies dormant if no USB
with PCUAE is fitted and boots to stock firmware. You would not know
that is was there.

Most PCUAE users will want to use Autoboot Mode.
Alternatively boot to firmware and use the fake firmware option to launch PCUAE,
it is slow and cumbersome and VICE Mode and Linux Mode will not work.

You need to first Activate Autoboot by adding the Autoboot Start-Up Script,
to the firmware otherwise it will not work, do that first before anything else,
look at Add/Remove Autoboot Start-Up Script Button below if you have not
activated Autoboot it yet.

Autoboot Mode Button


To Enable/Disable Autoboot Mode select Autoboot Mode Button.
Its the safest option to turn it on and off cause it writes only to the USB Stick.

Autoboot Mode is Enabled (On) but you need to install the Start Up Script
first to activate Autoboot Mode.

You should see the screen say Autoboot Disabled or Autoboot Enabled
when you turn it Off or On using the Autoboot Mode Button.

Add/Remove Autoboot Start-Up Script Button


If you want to Add/Remove Autoboot Start-Up Script to/from Firmware
then select Add/Remove Script Button.
This needs copying to the firmware (only once) to enable Autoboot Mode.
VICE Mode is deactivated until you Add Autoboot Start-Up Script to the firmware.
Only run this again to remove the script from firmware if needed.
DO NOT disable or enable this over and over, cause you could mess-up your firmware, use the
Autoboot Mode Button after you copied the Autoboot Start-Up Script to the firmware
to disable/Enable it, if you need too.

8 How to use Admin Password


N.B. It copies over your password shadow file in the firmware.
This removes the password Chuckpeddle from the firmware and replaces
it with no password so you can login by just using the user name only.
This is useful if you need to get into your firmware if it needs”
flashing or repairing e.g. if you broke the Nand image.”
Run this again if you want to restore the default password.

9 How to use Jiffy DOS


Jiffy DOS is a C64 Kernel replacement that speeds up disk access.
It loads a file up to 50% faster but while this mode is enabled you will not be able to load Tap Cassette files.
If you do a lot of disk and file access this is for you.

Take a look at manuals here.

The command Keys F1, F3, F5, F7 contain shortcuts to Disk commands.

***IMPORTANT*** You can not use Jiffy DOS without Accurate Disk flag (_AD) added to your disk image,
it does not work without it so make sure its added to the disk name you want to load by putting ‘_AD’
in the disks name, Example: mygame_AD.d64 or add it to its cjm file.

JiffyDOS is an enhanced DOS for the C64, SX-64, and C128 computers.
The software is programmed onto ROM chip that replace the Kernel
ROM chip on the VIC-20 or C64 motherboard and the DOS ROM chip in the 1541 disk drive.
JiffyDOS is intended to provide greater speed, commands and convenience than on stock systems.

Being ROM-based, JiffyDOS is able to provide performance without the compatibility problems of cartridges
and other speed-enhancement systems.

It was created by Mark Fellows in 1985 and and its last version was 6.01 – 1989.

In 2012 Retro Innovations released JiffyDOS for the VIC 20.

Speed comparisons


Table 1 illustrates the speed increases that can be obtained with JiffyDOS.

Note that the times shown are rounded off to the nearest second,
and do not take into account the disk spin-up delay (approx. 1/2 second)
or the time required for directory searching, which varies in relation to the size of the particular directory,
which varies in relation to the size of the particular directory.
Other factors may also influence results on individual systems.

Table 1:C-64, SX-64, C-128 in 64 Mode

St=Stock JD=JiffyDOS
——Disk Operation————————————St——JD——St—–JD——St—–JD

Load 202-block program (PRG file)————-124 12 124 9 102 8

Save 100-block program (PRG file)————–75 24 75 20 40 15

Read 125-block SEQ or USR file—————–84 15 84 13 63 9

Write 100-block SEQ or USR file—————–81 27 81 24 44 17

Read 64 154-byte REL records——————40 14 40 14 37 10

Write one 154-byte REL records————-.350 .125 .350 .120 .325 .110

Read/Write 16K on command channel——-47 9 47 9 47 9

10 How to Change to PAL/NTSC & 50/60Hz – THEC64 Maxi/THEVIC20 only


This switch between 50Hz and 60hz and back, this option does the same thing the Video Output Screen does when you switch on THEC64 Maxi machine for the first time and it allows you to pick what region your in, 50Hz Outside North America or 60Hz North America.
I made this because there is no option in the settings to change it again, you can only use the Video Output Screen once.

This menu is useful if your monitor or TV cannot cope or if you want
to experience with PAL or NTSC speed on your monitor.

Now you can play any game on EU or USA machine without resetting the machine.
This saves you from losing all your saved game files which happens because you have to reset the machine first, then pull the HDMI cable out and as it rebooting put it back in again and hope it brings up the Video Output screen(sometimes it dose not, its hit or miss), it does not always work and it can wear out your HDMI connector by pulling the cable in and out all the time, and you will start to have problems seeing the screen on the TV cause of a worn out HDMI Connector.

This is the safest way to do it.

11 How to Hide Splash Screens


Select Toggle Hide Splash screens to enable or disable the display”
of RGL and PCUAE Logos and the startup jingle at boot up.”

It displays a black screen instead of Retro Games LTD & PCUAE logos.”
It looks cool in VICE Mode, it starts up like the original machine… :-).

12 How To Use Linux Mode


You will need to install the additional Linux pack.”

N.B. You may need a USB Hub with THEC64 Mini to connect mouse and keyboard.”

When you launch this a full X windows session will boot up.”
You can exit Linux Mode with CTRL+F1 to return to PCUAE. This will boot”
PCUAE The Carousel next time.”

You can also exit by using the red button on screen with the mouse.”

This will exit Linux and boot TheCarousel BUT when you power down and”
power back up again next time it will boot into Linux Mode.”

You can copy files to and from the firmware using the file browser.”

You might be able to do other interesting things in future.”

***WARNING*** You can corrupt the Nand firmware so take care in there ;-).

13 Get GUID from a Controller or Joystick and How to use SDL2 Gamepad Tool


How To Get GUID from a Controller or Joystick


The SDL2 Game Tool is in ‘\Carousel_Games\Options\Controllers\’
if you need to install it on Linux, you can run its exe file from
its folder on the USB Stick on Windows, no need to install it.

The GUID Discovery


When you select this option it will read the GUID String from the second controller or joystick that is plugged into the machine.
The first joystick, your main joystick is needed to work with the option menu in PCUAE so do NOT unplug it.
It will take the data from any USB device that was the last one discovered/plugged in, it doesn’t check whether it’s a joystick/gamepad or not so if you run The GUID Discovery and do not have a second joystick or game controller plugged in, it will read the USB Stick instead cause it was the last device thats plugged in that it’s reading, it see the main joystick as the first device.
When you run The GUID Discovery it copies the GUID from the device to the ‘testjoys.txt’ file and show the GUID on the screen.
Make sure you plug in the right one you want to read first before you select this option.
Once it has completed, use Gadget Mode/Linux Mode or your PC to go to ‘USB:\\Carousel_Games\Options\Controllers\
and look for the file ‘testjoys.txt’ that contains the GUID string and the joystick manufacturer/name string that will look like…”
‘03000000790000001c18000011010000,SPEEDLINK COMPETITION PRO Game Controller for Android’.
Then use SDL2 GamePad Tool on your PC from:”

You can run the gamepad-tool.exe if you are using Gadget Mode on the machine by clicking on it with your mouse on Windows,
it does not need installing for it to work, then you can make the full GUID string thats needed in gamecontrollerdb.txt file for the machine to reconise your controller or joystick.

How To Use the SDL2 Gamepad Tool on Windows to make the full GUID string


1. Connect the controller or Joystick to a computer(PC) using Windows 10
2. Launch the gamepad-tool.exe on Windows from ‘\Carousel_Games\Options\Controllers\SDL2_Gamepad-Toolgamepad-tool.exe’.

If you connected multiple gamepad select the one you used to get GUID on the machine make sure
that one is plugged in to the PC. If it is still plugged in the machine, unplug it and plug it into the PC, then pick it from
the drop down list in the SDL2 Gamepad Tool.

3. You might need to change the mapping because it will probably be wrong in the app, press ‘Make New Mapping’ and follow the
instructions and look at the next page to see how the mapping on THEC64 Joystick is set and map yours to that so the
buttons work.

4. Now do this, press ‘Copy Mapping String’ and find mappings database file in ‘\Carousel_Games\Options\controllers\’ folder.”
Edit the file called gamecontrollerdb.txt with notepad++ and paste the GUID mapping string line at the end of the file.
Now add the new GUID you got earlier from The GUID Discovery option 10 in PCUAE Option Menu and copy it from ‘testjoys.txt’
file and copy over the top of the GUID string and joystick manufacturer/name string you added with the SDL2 Game Tool.”

5. Add ‘platform:Linux,’ at the end of GUID mapping string line, look for ‘platform:Windows,’ in the line and delete it.
Now you should have a fully working GUID string. Now save it and see if your controller or joystick works in the machine.”

Tip from jj0.
The easiest way to map a new joystick is to use the SDL2 Gamepad Tool on a PC to map the joystick directions and buttons to your”

Take the way the official THE64/VIC20 joysticks are mapped into account as a reference:

THE64 Joystick gamecontrollerdb.txt input name

Left Fire lefttrigger
Right Fire righttrigger
Left Triangle x
Right Triangle y”
Menu 1 a”
Menu 2 b”
Menu 3 back”
Menu 4 start”
Left/Right leftx”
Up/Down lefty”

Note that for Left/Right and Up/Down it uses the left analog
stick mapping, but it also works fine using dpleft/dpright
and dpup/dpdown instead. So if your controller only reports
dp and not leftx/lefty then you can still use it.

Then take the entire mapping string that the SDL2 Gamepad Tool
generates, change the GUID number (if different) to the one
given by option 10, put the line in the gamecontrolerdb.txt
echo ” and remove any other lines with the same GUID number.

14 How To Use NANDBackup


NANDBackup makes a copy of your NAND from your machine to a folder on your USB Stick in PCUAE.

The file location is ‘\Carousel_Games\Backup-and-Fake-Update-Store\’ on the USB Stick.

The folder will be named after your machine e.g. $THE64MODEL.

NANDBackup is in Option 3 on the PCUAE Option Menu.

After you see the ‘Disk Space On NAND/USB Stick it will prompt you:

‘Do you want to backup your NAND for safe keeping, press Yes or No’

If you want to backup your NAND then select Yes, or select No to close
it and return to the PCUAE Option Menu.
If you press Yes then it will load up the NANDbackup screen and provide
some information about it. When ready press RETURN to start the backup.

It will backup the NAND first as 2 files called nanda and nandb.

It will take a few minutes so you can go and do something useful like making a cup of tea or coffee 😉

When you come back it should have made a backup copy of your NAND.
After copying the NAND, it will also copy the included games into a different folder in the same location as your NAND.

The games do not take long to copy, maybe less that a minute.

Once copying the games to USB has completed, turn off PCUAE and unplug the USB stick and plug it into your PC to copy the back up from the USB stick to your PC hard drive for safe keeping.

That’s it, you have now made a backup copy of your NAND and games.

You will now be taken back to the PCUAE Option Menu automatically.


15 How to use atari mode


make sure autostart is on or it won’t work

From PCUAE Mode – To activate Atari Mode, press
CTRL + SHIFT + F3 and hold them until you see the
screen goes black. Once Donkey Kong (Atari800 emulator) is
loaded, you can switch emulators by pressing CTRL+1
for Atari800 emulator and CTRL +2 for Atari ++ Emulator, it will
Atari800 Emulator to start automatically from PCUAE mode first

and run the 1981 Donkey Kong game from the cartridge.
When switching emulator it doesn’t turn off like Vice Mode
it does because for some reason I haven’t yet
figured out why, it would give a black screen and no emulator

so to get around the problem i have to let the machine do it
reboot and then the emulator circuit works fine and shows the
emulator on screen, so that’s why it may seem longer
take to switch emulator, it would not be more than 30
should take seconds to switch emulators from Atari800
Emulator to Atari++ Emulator.

Load a game into Atari800 Emulator

Open Menu – F1 then select Run Atari Program and press
RETURN to save the extragames / Atari_Games folder on the USB stick
open, go to one of the folders you want to load from (folders-
Cartridges, Disks or Tapes) to get out of a menu item press
TAB or Restore key, after doing that you need to go to (use-
the CRSR Up and Down key) down currently only works because
THEC64 has only two cursor keys, Down and Right

cursor keys on the CRSR keys but you can also use a USB
keyboard) Cartridge Manager (to navigate to an item in the
menu, you can press the first letter on the keyboard
which it starts with, so if you press C on the keyboard,
Cartridge Manager highlighted and just hit return to
open that item)

and remove the Donkey Kong cartridge by tapping
highlight it and press the INST DEL key to delete it,
use the Tab or Restore key to get out and open the menu
close and now the game you selected will run.

I managed to update the mapping on the F keys so that
they are now… F1 = Menu key, F3 = Option key, F5 Selection key, F7 =
Start button

Loading a game in Atari++ Emulator

You can use the THEC64 joystick to scroll through the Atari ++ menu
move, to make it work, press fire once and move
then right and then left with the joystick and you should see the
small mouse arrow should go to the next item in the menu,
you can also plug in a USB mouse and use that instead
use, that also works

For ROMS (Cartridges) – Select Cartridge, open your rom / bin-
image from Extragames / Atari_Games / Cartridges folder,
eselect Cart type (check a box, e.g. 16k),
then click on Preferences – Exit menu and continue

For disk image – Select disk drive and make sure
it is enabled by pressing Enable.1.
then open your atr image from the extragames / folder
Atari_Games / Disk, then click on Preferences – Cold Start,
Exit menu and continue