uConsole os Images

Here are the download links for uConsole OS images:

You can find the image files on this GitHub page: uConsole OS Images.

After downloading the files, you need to uncompress them. Please note that MacOS requires version 11.6 or higher to uncompress 7z files.

For flashing the uConsole OS image, you can use the following tools:

  • Windows and macOS users can use Etcher to flash the image.
  • Linux users can use the “dd” command to flash the image.

If you want to use the 4G extension, you can find helpful tips on how to use it on the uConsole Wiki.

Additionally, we have a new uConsole keyboard firmware flash program available. You can download it from this link: uConsole Keyboard Firmware Flash Program.

This firmware update fixes a bug related to the fn key and changes the volume key logic. Here’s how you can flash the firmware on uConsole(A06 or CM4 only) or a PC running Ubuntu 22.04:

  1. Download the uconsole_keyboard_flash.tar.gz file.
  2. Extract the contents of the archive: tar zxvf uconsole_keyboard_flash.tar.gz.
  3. Install the required package using the following command: sudo apt install -y dfu-util.
  4. Navigate to the extracted directory: cd uconsole_keyboard_flash.
  5. Execute the flash script with root privileges: sudo ./flash.sh.
  6. If everything goes well, you will see a progress bar indicating the flashing process.
  7. If any issues occur or the keyboard loses control (which is unlikely), simply reboot uConsole to resolve it.
  8. Rest assured that this flash program will not brick your keyboard.

Excellent thank you. I’ve installed the A6 build and the keyboard flash successfully from these links.

1 Like

I ordered the CM4 version, is there a way to install another linux distro? debian, ubuntu,… on another SD card? is there a drivers issues maybe?

Since is a CM4, My best guess is that you can use other distros, the problem is maybe you need to do specific configurations, like rotate the screen.

yeah,you are right

and here is the kernel patch:

the kernel of uConsole cm4 now have rotation by default, no need to adjust


Nice to know, thanks. I want to bake my own image based on the latest Ubuntu (23.04 today) but I think there will be some adjustments to be made that will be documented later. DevTerm already has a lot of information on its wiki, but uConsole, since is a newer project, will have more details soon, I think.

Is the screen rotation in kernel planned for Devterm too?

I’m in the batch that received their uConsole, but without the CM4 adapter. I do have a CM3 to put in, though, in the meantime. Which OS image should I use? I see a Clockwork OS 0.5 that presumably is from older devices, so I’ll try that, but anything else I should look at?

I haven’t seen a CM3 image that will work. I would like a 64 bit CM3 image, haven’t had time to attempt to build one.

They haven’t produced instructions on building an OS for this thing either. Not sure how hard that would be.

They have the instructions here:

Here is for CM3: Create DevTerm CM3 OS image from scratch · clockworkpi/DevTerm Wiki · GitHub

1 Like

I see that they do include notes for the uConsole now, thought it was for DevTerm only.

Hi have you managed to make a ubuntu image as of yet?

Hi! Not yet. The instructions to build an image for Raspberry Pi 4 are inexistent.

1 Like

I was able to build a debian image using: GitHub - LibreRetroToy/armbian-clockworkpi-a06: armbian-clockworkpi-a06
but with the patches from here: GitHub - clockworkpi/uConsole: uConsole git repo


I was able to boot into the image, go through the armbian setup and log into XFCE.
Keyboard and trackpad seem to work fine, as do the arrow keys. I was also able to get online, so I think I would call this a success!


They’re right here.

1 Like