How to extract pi-topOS for Mac & Linux

Hi everyone, 

We've written out two methods for you to extract the pi-topOS! 

Method one: Mac and Linux (terminal command method) 
Method two:  Mac (graphical method) 

These tow solutions are to unzip the pi-topOS file for whoever has downloaded the zip file into the Downloads folder (located in /Users/<username>/Downloads):

Mac and Linux (terminal method): 

Open the terminal application on your computer.

For this tutorials command, we presume that your default location is in your home folder. (see image below) 

Image 1: This is where we assume your file to be located for the command.


2. Type out the command (below) into your terminal application:

`cd Downloads && tar xzvf pi-topOS.zip`

and hit Enter to begin extracting the zip file (see image below). Please note that the command it case sensitive - so please copy it exactly as written above!

Image 2: This is what it should look like in your terminal.


Leave the terminal window open until you are presented with a prompt allowing you to enter another command, indicating that the extraction is complete. The image file will have been extracted into your Downloads folder ready to be installed onto an SD card. 

Mac (graphical method):

If you are happy to install third party software, the simplest method is to install ‘The Unarchiver’ from the App Store. This will also help for future uzipping of files! If the attached link does not work. Simply open the App Store, search for ‘The Unarchiver’ in the top right, and you should see it appear in the search results (see image below):


Image 3: Depicting App Store with "The Unarchiver" in top left corner.

Click the relevant 'install' button to download and install it onto your computer. You may be required to enter your Apple ID and password. At this point, you can return to the Downloads folder in Finder, right click the pi-topOS zip file, and select 'The Unarchiver' from the 'Open With' toolbar menu (image below): 

Image 4: Depicts how to use 'The Unarchiver'

This will extract the zip file into your Downloads folder ready to be installed onto and SD card! 

We hope this helps and you enjoy the new update! :-) If you have any questions or feedback on the new pi-topOS update just drop us an email at support@pi-top.com. 

All the love to you amazing people.

Your pi-topTEAM



Having real trouble installing / writing PiTopOS on SD card having used a variation of tried and trusted methods on both Mac and Linux. Can someone have a look at the structure of the .img to verify it - there seems to be 4 partitions (inspected with gparted linux) - also having trouble fitting it on 8Gb cards as .img is a full 8Gb !!


2 people like this
Seems like latest pi-topOS has been trimmed down to about 7.8Gb - so should fit on a good quality 8Gb card

My pi-topOS crashed a bunch of times during "look for wifi networks" on initial setup.  Got passed that by skipping it and configuring after.  But then it crashed during reboot after setting time zones.  Ugh..  This time the card is corrupt so I'm downloading the OS now.  


What's the best way to load the OS onto an SD card so I can start over?

I've extracted the image file. Now what do I do? You guys say that it's ready to put on an SD card. But how?

You know, you guys should really start selling 8 or 16 GB SD's preloaded with pi-top OS. Been having a whole lotta trouble with the pi-top booting. Ever since I installed the I2C to hear the speakers that I fitted with my pi, I've had some real troubles updating and accessing the dashboard for pi, and it won't update. All the function keys (P1, P2, P3, etc) are broken. We ought to get out fresh clean copies that can plug right into the Pi and be updated if necessary once connected to the internet. Keep rolling, crunching, and pushing out those updates. I loved CEED Universe while it lasted.

Login or Signup to post a comment