Difference between revisions of "OSCAR Installation: Chrome OS"

From Apnea Board Wiki
Jump to: navigation, search

(If you launch it now...: Notes about navigation)
(5 intermediate revisions by the same user not shown)
Line 35: Line 35:
 
Click on the Install button, and after the progress bar finishes, a window with a black background will come up, looking a bit like a neater version of the old MS-DOS window.
 
Click on the Install button, and after the progress bar finishes, a window with a black background will come up, looking a bit like a neater version of the old MS-DOS window.
  
 
+
<!--  There are an awful of of words here. It's very very hard to follow as written. I strongly suggest re-writing this section with some images.  -->
 
 
  
 
=== If you have enabled Linux(Beta), then the next stage in the installation process is to learn which kind of CPU your ChromeBook uses. ===
 
=== If you have enabled Linux(Beta), then the next stage in the installation process is to learn which kind of CPU your ChromeBook uses. ===
 
To do this, open the browser, and type chrome://system and press enter
 
To do this, open the browser, and type chrome://system and press enter
Search for the term "uname". to the right of uname, you will see text that tells you what type of CPU you have. this will likely be AMD, or Intel, or you may see aarch64 or ARMv8.
+
Search <!-- "Search" implies you're using a software search tool - is this the case? If not use "Look for" -->for the term "uname". To the right of uname, you will see text that tells you what type of CPU you have. this will likely be AMD, or Intel, or you may see aarch64 or ARMv8.
If you see Intel or AMD, then you will need the package with amd64 in its name, or if you see aarch64 or ARMv8, then you will need the package with arm64 in its name.
+
If you see Intel or AMD, then you will need the Oscar package with amd64 in its name (see next section), or if you see aarch64 or ARMv8, then you will need the Oscar package with arm64 in its name.
  
 
== How do I install OSCAR on my ChromeBook? ==
 
== How do I install OSCAR on my ChromeBook? ==
  
Go to the Oscar downloads page; there's a link to that close to the middle of the black horizontal bar
+
Go to the [https://www.sleepfiles.com/OSCAR/ Oscar downloads page] <!-- Just use the link, not a description that is subject to confusion -->
not far from the top of this page.
+
 
 
Go to that page on your Chromebook, and over on the right side, you'll see the 2 ChromeBook installation packages labelled
 
Go to that page on your Chromebook, and over on the right side, you'll see the 2 ChromeBook installation packages labelled
 
  OSCAR_1.1.0_Debian9_amd64
 
  OSCAR_1.1.0_Debian9_amd64
Line 53: Line 52:
 
Download the appropriate one.
 
Download the appropriate one.
 
Your Chrome browser will probably ask you to save it, probably in your Downloads folder, so go ahead and do that.
 
Your Chrome browser will probably ask you to save it, probably in your Downloads folder, so go ahead and do that.
If it didn't ask you, it put it in Downloads.
+
If it didn't ask you, it put it in Downloads. Make a note of this location, you'll need it for the next step.
  
 
I'll include one more link that tells you how to take a screenshot on a Chromebook, so you can post a screenshot of any difficulty you have. It is
 
I'll include one more link that tells you how to take a screenshot on a Chromebook, so you can post a screenshot of any difficulty you have. It is
 
omg chrome.com/ take-screenshot-chromebook-chromeos  I'll need permission for this link; it's only required if we wish to support users in this way.
 
omg chrome.com/ take-screenshot-chromebook-chromeos  I'll need permission for this link; it's only required if we wish to support users in this way.
That isn't my call:mjphyi
+
That isn't my call:mjphyi DeepBreathing says: Links are OK so long as they comply with our commercial rules - No sites owned by a DME and no sites with a {Buy} button. Otherwise OK.
 +
 
  
 +
=== What you need to do now is to install the .deb file that you downloaded. === <!-- I didn't know that I downloaded a .deb file! I thought I downloaded Oscar! What's the story? -->
 +
<!-- We don't need to do this in Linux, it's simpler to do it from Chrome. -->
 +
If you're still in Linux, return to the Chrome desktop .
  
=== What you need to do now is to install the .deb file that you downloaded. ===
+
<!-- Do you know where the file was saved? You may have had your browser set to save it in your Downloads folder, or you may have had it set to ask you where to save anything (in which case, you probably know). Either way, n-->
We don't need to do this in Linux, it's simpler to do it from Chrome.
+
Now open the Chrome Files App, and go to the folder with the Oscar package that you downloaded. It will show as a .deb file (eg Oscar_blah_blah.deb)
Do you know where the file was saved? You may have had your browser set to save it in your Downloads folder, or you may have had it set to ask you where to save anything (in which case, you probably know). Either way, now open the Chrome Files App, and go to the folder with the .deb file that you downloaded.
 
 
                                            
 
                                            
 
When you find it, we can open it and install it from the files App.  
 
When you find it, we can open it and install it from the files App.  
 
If you are on a ChromeBox, then you are probably using a mouse, while if you are using a ChromeBook, you might be using a mouse, or you may be using the trackpad that is below the keyboard. Your trackpad supports a click anywhere in the trackpad the same way as it supports a left click with a 2 or 3 button mouse.
 
If you are on a ChromeBox, then you are probably using a mouse, while if you are using a ChromeBook, you might be using a mouse, or you may be using the trackpad that is below the keyboard. Your trackpad supports a click anywhere in the trackpad the same way as it supports a left click with a 2 or 3 button mouse.
 
   
 
   
A mouse right click is sometimes useful, and you can get the same effect by holding down the Alt key and clicking in the touchpad.
+
A mouse right click is sometimes useful, and you can get the same effect by holding down the Alt key and clicking in the touchpad.
If a mouse right click is required in these instructions, it will be shown as Alt-touchpad-click and as Mouse-right-click. Pick one, don't do both.
+
If a mouse right click is required in these instructions, it will be shown as Alt-touchpad-click and as Mouse-right-click. Pick one, don't do both.
mjphyi has noticed that although the above paragraph is correct, right clicking isn't going to be required when installing Beta-2 or later up to this point.
+
mjphyi has noticed that although the above paragraph is correct, right clicking isn't going to be required when installing Beta-2 or later up to this point.
It WILL be requiredas part of importing for the first time, and it will be repeated there, but maybe it'll disappear from here.
+
It WILL be required as part of importing for the first time, and it will be repeated there, but maybe it'll disappear from here.
 +
Note that each line is indented, causing that text to appear in a box - useful for asides like this which interrupt the flow of the narrative.
  
 
In the Chrome Files App, double click on the name of the install package that you downloaded.
 
In the Chrome Files App, double click on the name of the install package that you downloaded.
Line 82: Line 85:
 
When you get to this point, or if you see OSCAR start up, then you are halfway there, but please '''STOP NOW''' and don't go any further.
 
When you get to this point, or if you see OSCAR start up, then you are halfway there, but please '''STOP NOW''' and don't go any further.
 
The next part of installation on Chrome will be to create a profile and then to import from an SD Card.
 
The next part of installation on Chrome will be to create a profile and then to import from an SD Card.
You may have made a profile before, and you may have imported from an SD Card before, but importing from an SD card on Chrome OS for the first time is quite different, so do '''NOT''' try it until you have gone back to the page above this one, and read all of the instructions about how to do it.
+
You may have made a profile before, and you may have imported from an SD Card before, but importing from an SD card on Chrome OS for the first time is quite different, so do '''NOT''' try it until you have gone back to <!-- the page above this one, Don't use this sort of terminology else people will quickly get lost in the wiki. Put the section name and a link --> and read all of the instructions about how to do it.
  
 
After it's been done once, it will be simple.
 
After it's been done once, it will be simple.

Revision as of 01:05, 27 March 2020

Incomplete.png


A ChromeBook is a laptop, while a ChromeBox is a box to which you connect your own mouse, keyboard and monitor. In this wiki, we will use the term ChromeBook to cover both.

Can I install OSCAR on a ChromeBook or a ChromeBox?

If it is a recent one, then you can.

Linux(Beta)

The feature added to recent ChromeBooks is called Linux(Beta). You may also find this feature described by the codeword Crostini. If you ChromeBook supports Linux(Beta), then you can run OSCAR on it. If it doesn't, then you can't.

Does my ChromeBook have an SD Card slot?

It almost certainly does, but it might be a slot for a micro SD Card. Most CPAP machines use a full size SD Card though.

If your ChromeBook has a micro SD Card slot, then you can still use it, but you must either

  • Use a micro SD Card to full size SD Card adapter (many micro SD Cards are sold with one.
  • Use your full size SD Card with a USB adapter which will fit in a USB port in your ChromeBook. (Some ChromeBooks may have only USB-C ports, so check this before buying an adapter).


I'm thinking of buying a ChromeBook, how can I tell if it supports Linux(Beta)?

To learn how to answer that, go to this page What ChromeBooks support Linux(Beta) aka Crostini?

I already have a ChromeBook, how can I tell if it supports Linux(Beta)?

You could follow the instructions above, but as you already have one, it's probably easiest to just see if it can be enabled.

The first thing to do is to make sure your Chromebook is up to date.

If a ChromeBook is left on and connected to the Internet, it will update itself, and then ask you to restart it so it uses the latest version. But we want to make sure, so, on your ChromeBook, go to Settings->About Chrome OS and see if there are any updates to apply. You do this by going to the settings page (which is accessed by clicking on the little toothed gear symbol) and then finding the legend "About Chrome OS" over to the left and clicking on that. Then you should see a box up towards the top that says "Check for Updates". Click on that, and it will either tell you that you are up to date, or else start updating your system. If it starts updating, then wait for it to finish, and then follow its instructions to restart.

After the restart, or if your ChromeBook was up to date, go back to the Settings Page, and see if there is an option for "Linux(Beta)". If you do not have this option, then you can not install OSCAR. If there is, then you need to enable it. Click in the "Turn On" box, and another windows will pop up saying "Install Linux (Beta) on your ChromeBook". Click on the Install button, and after the progress bar finishes, a window with a black background will come up, looking a bit like a neater version of the old MS-DOS window.


If you have enabled Linux(Beta), then the next stage in the installation process is to learn which kind of CPU your ChromeBook uses.

To do this, open the browser, and type chrome://system and press enter Search for the term "uname". To the right of uname, you will see text that tells you what type of CPU you have. this will likely be AMD, or Intel, or you may see aarch64 or ARMv8. If you see Intel or AMD, then you will need the Oscar package with amd64 in its name (see next section), or if you see aarch64 or ARMv8, then you will need the Oscar package with arm64 in its name.

How do I install OSCAR on my ChromeBook?

Go to the Oscar downloads page

Go to that page on your Chromebook, and over on the right side, you'll see the 2 ChromeBook installation packages labelled

OSCAR_1.1.0_Debian9_amd64
OSCAR_1.1.0_Debian9_arm64

Download the appropriate one. Your Chrome browser will probably ask you to save it, probably in your Downloads folder, so go ahead and do that. If it didn't ask you, it put it in Downloads. Make a note of this location, you'll need it for the next step.

I'll include one more link that tells you how to take a screenshot on a Chromebook, so you can post a screenshot of any difficulty you have. It is omg chrome.com/ take-screenshot-chromebook-chromeos I'll need permission for this link; it's only required if we wish to support users in this way. That isn't my call:mjphyi DeepBreathing says: Links are OK so long as they comply with our commercial rules - No sites owned by a DME and no sites with a {Buy} button. Otherwise OK.


What you need to do now is to install the .deb file that you downloaded.

If you're still in Linux, return to the Chrome desktop .

Now open the Chrome Files App, and go to the folder with the Oscar package that you downloaded. It will show as a .deb file (eg Oscar_blah_blah.deb)

When you find it, we can open it and install it from the files App. If you are on a ChromeBox, then you are probably using a mouse, while if you are using a ChromeBook, you might be using a mouse, or you may be using the trackpad that is below the keyboard. Your trackpad supports a click anywhere in the trackpad the same way as it supports a left click with a 2 or 3 button mouse.

A mouse right click is sometimes useful, and you can get the same effect by holding down the Alt key and clicking in the touchpad.
If a mouse right click is required in these instructions, it will be shown as Alt-touchpad-click and as Mouse-right-click. Pick one, don't do both.
mjphyi has noticed that although the above paragraph is correct, right clicking isn't going to be required when installing Beta-2 or later up to this point.
It WILL be required as part of importing for the first time, and it will be repeated there, but maybe it'll disappear from here.
Note that each line is indented, causing that text to appear in a box - useful for asides like this which interrupt the flow of the narrative.

In the Chrome Files App, double click on the name of the install package that you downloaded. needs fleshing out, may need pictures:mjphyi It will then tell you that is has successfully started to install After a while it will tell you that the install has been successful, and invite you to launch it. You can launch it now, and you can also close the window that told you that invited you to install it.

If you launch it now...

If we are successful, we will be given a small square window that asks us to select our language as English. When you get to this point, or if you see OSCAR start up, then you are halfway there, but please STOP NOW and don't go any further. The next part of installation on Chrome will be to create a profile and then to import from an SD Card. You may have made a profile before, and you may have imported from an SD Card before, but importing from an SD card on Chrome OS for the first time is quite different, so do NOT try it until you have gone back to and read all of the instructions about how to do it.

After it's been done once, it will be simple.