QDOS on Google TV walkthrough

Discussion and advice about emulating the QL on other machines.
Post Reply
User avatar
Mark Swift
Bent Pin Expansion Port
Posts: 86
Joined: Fri Jul 18, 2014 9:13 am
Location: Blackpool, Lancs, UK
Contact:

QDOS on Google TV walkthrough

Post by Mark Swift »

Hi all

This is a walk-through of how to run QDOS on a "Chromecast with Google TV".
In this setup, I make use of the Amiga (PUAE) emulator within RetroArch and a QDOS Classic kickstart ROM for UAE.
Setup is quite a lengthy process, so I thought it was worth documenting.


These are the steps:

1. Download RetroArch and QDOS Classic onto a USB stick and connect it to the Chromecast.
2. Connect a keyboard, enter developer mode, download a file browser and install RetroArch
3. Disable RetroArch Hotkey mappings and launch QDOS Classic

Note, RetroArch is not listed on the Play Store for the "Chromecast with Google TV" so you have to sideload via an apk file while in developer mode.


Here we go:

1. Download RetroArch and QDOS Classic onto a USB stick and connect it to the Chromecast.

1.1. Download the RetroArch.apk file from this URL.

https://www.RetroArch.com/?page=platforms

1.2 Copy the RetroArch.apk file onto an FAT formatted USB stick.

1.3. Download the following zip file.
It contains a current version of the QDOS Classic KickROM for UAE within a RetroArch settings folder.

QC-3955-Android-RLS.zip
(912.7 KiB) Downloaded 211 times

1.4. Copy the zip file onto an FAT formatted USB stick and unzip

1.5 Connect the USB stick to the Chromecast by way of a Type C USB 3.0 Charger Splitter

1-download.jpg

2. Connect a keyboard, enter developer mode, download a file browser and install RetroArch

2.1. Power on a Bluetooth Keyboard and place it into pairing mode

2.2. At the Chromecast Home page,
Select "Settings>Remotes and accessories>Pair remote or accessory"

2.3. Select and pair your keyboard.

2.4. At the Chromecast Home page,
Select "Settings>System>About>Android TV OS Build"
keep clicking until you see "you are now a developer"

2.5. At the Chromecast Home page,
Select "Apps>Search for apps and games"

2.6 Look for "FX" which is a decent file browser with a split screen option.

2.7 Install the App, and give it the appropriate permissions to read and write the filesystem

Select "Settings>Apps>See all apps>FX>Permissions>Files and Media>Allow..."

2.8 Copy the RetroArch folder from the USB stick onto the Main Storage

2.9 Double-click the RetroArch.apk file to install.

2.10 You will be told that the File Browser doesn't have the permissions to install unknown apps.
Assign the permissions and install

2.11 Open RetroArch

2.12 You will be told that the RetroArch doesn't have the permissions to read storage. Assign the permissions

Once RetroArch is installed, you can remove the USB stick and Charger Splitter and connect up the Chromecast as normal.

2-install.jpg

3. Disable RetroArch Hotkey mappings and launch QDOS Classic

3.1 In RetroArch, select "Settings>Input>Hotkeys"

3.2 In order to use the keyboard in QDOS, we need to disable all Hotkey keyboard mappings.
Hover over every option that says "key" and press the "a" key on the keyboard.
The option will change to "---"

3.3. Hover over the "Menu Toggle" option then press "Enter"
Hit a key on the keyboard that you would like to use to get you out of QDOS.
I use the "Home" key.

3.4 In RetroArch, select "Settings>Input>RetroPad Binds>Port 1 Controls"

3.5 Hover over any option that says "key" and press the "a" key on the keyboard.
The option will change to "---"
Do the "key a" option last, as this is the key used to clear the options.

3.6 Hover over "Device Index" and press a button on the Chromecast remote.
It should change from "N/A #1" to "Chromecast Remote"

3.7 Hover over "D-Pad Up" and press enter. When asked, press up on the Chromecast remote.

3.8 Do the same for other keys on the remote
"D-Pad Up" = "Up"
"D-Pad Down" = "Down"
"D-Pad Left" = "Left"
"D-Pad Right" = "Right"
"B Button (Down)" = "OK"
"A Button (Right)" = "Back"
You can now use the Chromecast remote to set RetroArch options

3.9. Select "Settings>Video>Scaling>Aspect Ratio", and set it to "Full"

3.10. Select "Main Menu>Load Core>Download a Core>Commodore - Amiga (PUE)"

3.11. Select "Main Menu>Load Core>Commodore - Amiga (PUE)>Start Core"
QDOS will load.

3-run.jpg

A couple of things to note.

When running QDOS on the Chromecast there is an annoying clicking sound. This doesn't happen in RetroArch on any other Android device that I've tried. The only solution at the moment is to mute the TV.

The model used here is the "Chromecast with Google TV (HD) Snow". Its about half as fast as the Wii when running QDOS.

The zip download above can be used on any Android device running RetroArch.
The Chromecast is unusual in not having a supported version of RetroArch available in the Play Store.

There are two floppy images and two QubIDE harddrive images bundled in the zip download. The names and locations of these disk images are stored in the config file called "puae_libretro_global.uae".

The location of the "puae_libretro_global.uae" config file is different depending on the version of RetroArch used, so it has been copied to three common locations. If you modify the file, make sure that you modify all 3 copies.

Finally, if you set the "Hotkey Enable" key in RetroArch, it should be possible for a core to have full keyboard support without having to clear all the Hotkeys. However I couldn't get this to work.


That's it.

QDOSonGoogleTV.gif


User avatar
Mark Swift
Bent Pin Expansion Port
Posts: 86
Joined: Fri Jul 18, 2014 9:13 am
Location: Blackpool, Lancs, UK
Contact:

Re: QDOS on Google TV walkthrough

Post by Mark Swift »

As a footnote I should add...

CTRL-Space is ignored on Android, so I have mapped in ALT-Space as a break combination.

And on other Android devices, you can download and install RetroArch from the Play Store then start from step 3.

QDOSonAndroid.gif
QDOSonAndroid.gif (943.6 KiB) Viewed 5273 times


Tinyfpga
Gold Card
Posts: 303
Joined: Thu Sep 27, 2018 1:59 am

Re: QDOS on Google TV walkthrough

Post by Tinyfpga »

I have a few impertinent questions:-
1. Can one use a Google Chromecast rather than a Google Chromecast with TV?

2. I could not find the .apk file on your link so I tried to get it from APKpure,
which is everything but pure. One tends to go round in circles with this site.
I managed to get a 184 MB file called RetroArch_1.20.0_GIT_APKPURE.apk.
This does not seem correct.

3. When you say download QDOS Classic onto a USB stick do you mean all the
unzipped files contained in QDOSclassic.zip and in a folder named QZ ?


User avatar
Mark Swift
Bent Pin Expansion Port
Posts: 86
Joined: Fri Jul 18, 2014 9:13 am
Location: Blackpool, Lancs, UK
Contact:

Re: QDOS on Google TV walkthrough

Post by Mark Swift »

Hi
Tinyfpga wrote: Wed Apr 02, 2025 11:42 pm I have a few impertinent questions:-
The very first very welcome question.
Maybe those 200+ downloads were all AI bots. :)
Tinyfpga wrote: Wed Apr 02, 2025 11:42 pm 1. Can one use a Google Chromecast rather than a Google Chromecast with TV?
No, I don't think that the original Chromecast runs Android.
Tinyfpga wrote: Wed Apr 02, 2025 11:42 pm 2. I could not find the .apk file on your link so I tried to get it from APKpure...
One thing I didn't mention, I did all the downloading on a PC.
If I tried a downloader on the Chromecast itself I just kept getting redirected to dodgy files.

On a PC go to https://www.retroarch.com/?page=platforms
Scroll down to the Android section and click on the "Download" link
Tinyfpga wrote: Wed Apr 02, 2025 11:42 pm 3. When you say download QDOS Classic onto a USB stick do you mean all the
unzipped files contained in QDOSclassic.zip and in a folder named QZ ?
No, download "QC-3955-Android-RLS.zip" from the link above and unzip it to a USB stick.
It should create a folder called "RetroArch" that is mentioned in step 2.8.

This contains all the files necessary to run QDOS on Amiga Core on RetroArch on Android.


User avatar
bwinkel67
QL Wafer Drive
Posts: 1511
Joined: Thu Oct 03, 2019 2:09 am

Re: QDOS on Google TV walkthrough

Post by bwinkel67 »

Fire OS next...


Derek_Stewart
Font of All Knowledge
Posts: 4652
Joined: Mon Dec 20, 2010 11:40 am
Location: Sunny Runcorn, Cheshire, UK

Re: QDOS on Google TV walkthrough

Post by Derek_Stewart »

Hi

I have been using this on a Samsung Galaxy A9+ SM-X210 11" Android Tablet.
IMG_20250405_193948336_HDR_AE.jpg
IMG_20250405_193925845_HDR_AE.jpg
Bluetooth keyboard not shown.

There is an on-screen keyboard by pressing Select, but it overlays the emulator window, still have to use an external keyboard.


Regards,

Derek
User avatar
Mark Swift
Bent Pin Expansion Port
Posts: 86
Joined: Fri Jul 18, 2014 9:13 am
Location: Blackpool, Lancs, UK
Contact:

Re: QDOS on Google TV walkthrough

Post by Mark Swift »

bwinkel67 wrote: Sat Apr 05, 2025 12:13 am Fire OS next...
I have this working on an old Kindle Fire 7 running FireOS 5 (android 5.1) that had been relegated to the tech drawer.

I had to copy "puae_libretro_global.uae" from the "saves" directory into the config directory, then rename that copy to be "puae_libretro_android.cfg".

Configuring RetroArch is notoriously difficult as they seem to be always moving the goal posts.
The download I used from the Amazon store was the latest at the time at version 1.20.0.
Derek_Stewart wrote: Sat Apr 05, 2025 7:46 pm There is an on-screen keyboard by pressing Select, but it overlays the emulator window, still have to use an external keyboard.
If you use a tablet in the vertical orientation, it's possible to have the on-screen keyboard at the bottom of the screen. There is a site that explains various keyboard configurations here some of which proved useful when I was setting it up. I still prefer a physical keyboard though.

QC-Kindle.gif

Although of limited use, it's still cool to see QDOS running on old tech.


Derek_Stewart
Font of All Knowledge
Posts: 4652
Joined: Mon Dec 20, 2010 11:40 am
Location: Sunny Runcorn, Cheshire, UK

Re: QDOS on Google TV walkthrough

Post by Derek_Stewart »

Hi,

Had a little fiddle around with the setting, gave :
IMG_20250409_211012813_HDR_AE.jpg


Regards,

Derek
User avatar
bwinkel67
QL Wafer Drive
Posts: 1511
Joined: Thu Oct 03, 2019 2:09 am

Re: QDOS on Google TV walkthrough

Post by bwinkel67 »

Mark Swift wrote: Wed Apr 09, 2025 7:48 am
bwinkel67 wrote: Sat Apr 05, 2025 12:13 am Fire OS next...
I have this working on an old Kindle Fire 7 running FireOS 5 (android 5.1) that had been relegated to the tech drawer.

I had to copy "puae_libretro_global.uae" from the "saves" directory into the config directory, then rename that copy to be "puae_libretro_android.cfg".

Configuring RetroArch is notoriously difficult as they seem to be always moving the goal posts.
The download I used from the Amazon store was the latest at the time at version 1.20.0.
That's cool. I think I have a Kindle Fire 7 lying around somewhere. Now I'm curious if it could run on a Pixel Watch. Then we'd have a QL on a wrist.


Post Reply