GalliumOS Wiki - User contributions [en]

Additional Software

2018-03-26T03:12:35Z

Dvdmuckle: Add section on mounting gdrive via fstab

GalliumOS comes with a good selection of desktop and utility software, but there is a huge variety of additional options and alternatives.

GalliumOS can install any software packages built for Ubuntu, directly from the Canonical package servers.

There are also some frequently-requested applications that are not available from Canonical, or are more complicated to install. A few are listed here. Please add more!

== Desktop ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb
</pre>



=== Adobe Flash ===

Adobe Flash apps (and Twitch streams, etc) require Adobe Flash Player, which is not included by default in GalliumOS.

* Install adobe-flashplugin from Canonical's <code>partner</code> repository.
<pre style="margin:0 0 0 2em; padding:0.4em;">
sudo add-apt-repository "deb http://archive.canonical.com/ubuntu $(lsb_release -sc) partner"
sudo apt-get update
sudo apt-get install adobe-flashplugin
</pre>
* Confirm installation by entering <code>chrome://plugins</code> (Chromium) or <code>about:plugins</code> (Firefox) into the URL bar

The proprietary version of Google Chrome includes PepperFlash, and does not require an additional plugin.

=== Firefox Aurora ===

Aurora is the '''developer preview''' of Firefox.

The '''stable''' version of Firefox can be installed from the standard Canonical repositories with <code>sudo apt install firefox</code>.

More info: https://launchpad.net/~ubuntu-mozilla-daily/+archive/ubuntu/firefox-aurora

=== Pale Moon ===

Pale Moon is a web browser, originally derived from Firefox, and optimized for performance.

* Official site: http://linux.palemoon.org/
* Installation: https://software.opensuse.org/download.html?project=home%3Astevenpusser&package=palemoon
** (Follow instructions for Ubuntu)

=== TeamViewer ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
curl -OL http://download.teamviewer.com/download/teamviewer_i386.deb
sudo dpkg -i teamviewer_i386.deb
</pre>

=== Google Drive integration<br> ===
* Install the software
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:alessandro-strada/ppa
sudo apt-get update
sudo apt-get install google-drive-ocamlfuse
</pre>

* Run google-drive-ocamlfuse for first time setup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse
</pre>

You'll get a browser window asking you to sign in to your Google account and if you want to give gdfuse OAuth2 Endpoint permission to access your Drive files. Hit Accept / Allow for any following dialog. Close the browser window.

* Next, create a directory where your Google Drive files will be mounted, preferably in your home directory, and mount Google Drive to that directory.
<pre style="margin:0 0 0 1.5em">
mkdir ~/googledrive
google-drive-ocamlfuse ~/googledrive
</pre>

You can check if Google Drive is mounted by performing:
<pre style="margin:0 0 0 1.5em">
mount
</pre>

You can also check how much space you have left:
<pre style="margin:0 0 0 1.5em">
df
</pre>

If you want to unmount, simply run
<pre style="margin:0 0 0 1.5em">
fusermount -u ~/googledrive
</pre>

* To mount Google Drive at startup, set the following command to run at boot with Session and Startup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse -label default /home/<user>/googledrive
</pre>

Alternatively, you may wish to set Google Drive to mount at startup using the <code>/etc/fstab</code> file. If so, create the file <code>/usr/bin/gdfuse</code> with the following contents, replacing <code><user></code> with your GalliumOS username, then run <code>sudo chmod +x /usr/bin/gdfuse</code>.
<pre style="margin:0 0 0 1.5em">
#!/bin/bash
su <user> -l -c "google-drive-ocamlfuse $*"
exit 0
</pre>
Next, add the following line to your <code>/etc/fstab</code>, again replacing <code><user></code> with your user, and replacing the <code>uid/<code> and <code>gid</code> values with the values retrieved from the <code>echo $UID</code> and <code>echo $GID</code> commands respectively.
<pre style="margin:0 0 0 1.5em">
gdfuse /home/<user>/googledrive fuse uid=1000,gid=1000,user 0 0
</pre>
If you decide to change the mount location for Google Drive, make sure the location is owned by your user. You can do so by running <code>chown $UID:$GID /mount/location</code>.

A word of warning, large files such as movies or large videos don't work too well with google-drive-ocamlfuse using default settings. Files are cached to ~/.gdfuse/default/cache. A config file can be found in the directory above that, with parameters to allow for streaming larger files, cache size, etc.. The streaming larger files parameter is perfect for large videos and movies. For more information, check out gdfuse on GitHub.

Adapted from: http://xmodulo.com/mount-google-drive-linux.html

Most up-to-date instructions can be found on project home page: https://github.com/astrada/google-drive-ocamlfuse/wiki

=== Skype ===

Download the .deb below, and install using:
<pre style="margin:0 0 0 1.5em">
sudo dpkg -i skypeforlinux-64.deb
</pre>

Deb download: https://www.skype.com/en/download-skype/skype-for-linux/downloading-web/?type=weblinux-deb

If you have the older Skype client installed, you will need to update to the newest client. For information on the older client, see: https://help.ubuntu.com/community/Skype

Source: https://blogs.skype.com/news/2017/03/01/the-skype-for-linux-beta-version-5-0-is-now-available-for-download

Note that while this is the only officially supported Skype client, it is an beta, so not everything may work.

=== Wine ===

Wine has been a source of frustration. These instructions are verified on a fresh install of 2.0.

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository ppa:ubuntu-wine/ppa
sudo apt-get update
sudo apt-get install wine1.8
</pre>

=== Simple Screen Recorder ===
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository -y ppa:maarten-baert/simplescreenrecorder
sudo apt-get update
sudo apt-get install simplescreenrecorder
</pre>

=== Spotify ===

<pre style="margin:0 0 0 1.5em">
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys BBEBDCB318AD50EC6865090613B00F1FD2C19886
echo deb http://repository.spotify.com stable non-free | sudo tee /etc/apt/sources.list.d/spotify.list
sudo apt-get update
sudo apt-get install spotify-client
</pre>

Source: https://www.spotify.com/us/download/linux/

=== Kodi Media Center ===

<pre style="margin:0 0 0 1.5em">
sudo apt-get install python-software-properties pkg-config software-properties-common
sudo add-apt-repository -y ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi
</pre>

== Games ==

=== Steam ===
<pre style="margin:0 0 0 1.5em">
curl -O http://repo.steampowered.com/steam/archive/precise/steam_latest.deb
sudo apt install python-apt
sudo dpkg -i steam_latest.deb
</pre>

Then launch Steam from the application launcher. Your user must be in the "sudo" group (if it is not, the dpkg command above will also fail), so that the installer can do all the things it needs to do.

=== Minecraft ===
<pre style="margin:0 0 0 1.5em">
sudo bash
apt-get install default-jre
curl -o /usr/local/bin/Minecraft.jar https://s3.amazonaws.com/Minecraft.Download/launcher/Minecraft.jar
curl -o /usr/share/pixmaps/minecraft.png https://chrx.org/minecraft.png
mkdir -p /usr/local/share/applications
cat > /usr/local/share/applications/minecraft.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Minecraft
Comment=Minecraft
Exec=java -jar /usr/local/bin/Minecraft.jar
Icon=/usr/share/pixmaps/minecraft.png
Categories=Game;
EOF
</pre>

== Utilities ==

=== grsync ===
Graphical lightweight version of rsync to back up data between drives
<pre style="margin:0 0 0 1.5em">
sudo apt-get install grsync
</pre>

=== aptik ===
Backup APT sources/repository data
<pre style="margin:0 0 0 1.5em">
sudo apt-add-repository -y ppa:teejee2008/ppa
sudo apt-get update
sudo apt-get install aptik
</pre>

=== OpenVPN ===
Install the following two packages to get OpenVPN connectivity with your favorite VPN service.
<pre style="margin:0 0 0 1.5em">
sudo apt-get install openvpn network-manager-openvpn
</pre>

=== caffeine-plus ===
Used to keep the screen awake with full screen applications such as full screen video.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:nilarimogard/webupd8
sudo apt-get update
sudo apt-get install caffeine-plus
</pre>
Source: [http://www.webupd8.org/2014/08/screensaver-lock-screen-inhibitor.html Webupd8]

== Hardware Optimization ==

=== Battery Tuning ===

==== Powertop ====
Monitor process and device power consumption. Includes a handy auto-tune option which can be run at startup that helps to minimize power consumption. Powertop also provides a calibration option, which some people have reported issues with (locks up device?).

<pre style="margin:0 0 0 1.5em">
sudo apt-get install powertop
sudo powertop
</pre>

Powertop needs to be run every time the system boots. Expand for instructions:

<div class="mw-collapsible mw-collapsed" style="border:1px #666666 dashed;padding:0.5em 1em;min-height:2em;margin:0 2em;background-color:#eee;">

Create <code>/etc/systemd/system/powertop.service</code> with the following content:

<pre style="margin:0 0 0 1.5em">
[Unit]
Description=Powertop tunings

[Service]
Type=oneshot
ExecStart=/usr/sbin/powertop --auto-tune

[Install]
WantedBy=multi-user.target
</pre>

Then reboot.

Source: https://wiki.archlinux.org/index.php/Powertop
</div>

==== TLP ====

Advanced power management tool that also provides a default configuration optimized for battery life for "install and forget it" benefits. TLP has reportedly provided some improvement to battery life. Your mileage may vary.

<div style="background-color:#ffffcc;margin:0 0 0.5em 1.5em; padding:0.3em;border:1px solid #ccccaa">NOTE: There are also reports of system instability while running TLP. If you experience any issues, try disabling it first.</div>

<pre style="margin:0 0 0 1.5em">sudo add-apt-repository ppa:linrunner/tlp
sudo apt-get install tlp
sudo tlp start</pre>

== Miscellaneous ==

These have been discussed, but are not presently candidates for inclusion in the default installation. They might be of special interest, might have important caveats, or might be the unchosen of other options. Presented here for convenience.

==== Changing the Window Manager ====
* The <code>i3</code> window manager is a minimal tiling window manager that can be successfully installed alongside the default galliumos WM (<code>xfce4</code>). Instructions are available here[https://wiki.galliumos.org/FAQ/i3wm]. If you want to try something totally new in terms of user-experience, try this out. If you want to improve your development workflow, try this out (then go look up emacs).

==== Hardware temperature monitor ====
* <code>xfce4-sensors-plugin</code> from Ubuntu repositories. '''WARNING:''' Do '''not''' select <code>tachos</code>. It will crash your desktop.

==== Clipboard Manager ====
* <code>clipit</code> from Ubuntu repositories. Developer homepage is missing. Be conscious of the security implications of all clipboard managers.

==== Video Player ====
* https://mpv.io/ Lightweight, but very minimal UI
* <code>smplayer</code> from Ubuntu repositories. Lightweight.

==== Screen Recorder ====
* <code>OBS</code> from PPA. One of the most popular screen recording tools. See https://obsproject.com/ for more info.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:obsproject/obs-studio
sudo apt-get update
sudo apt-get install obs-studio
</pre>
* <code>kazam</code> from Ubuntu repositories. Alternative to <code>simplescreenrecorder</code>, above. See https://apps.ubuntu.com/cat/applications/kazam/ for more info.

==== Disk Usage/Performance Indicators ====
* <code>xfce4-goodies</code> from Ubuntu repositories includes a free space checker applet
* <code>xfce4-diskperf-plugin</code> from Ubuntu repositories is a disk performance monitor applet, and shows usage as well

Media

2017-06-19T17:25:13Z

Dvdmuckle: Added Ars Technica Article

== GalliumOS Media Coverage ==

Media outlets big and small. If you have written about GalliumOS, or know someone who has, please let us know so we can add you to our list.

For media inquiries, please reach us at contact-at-galliumos-dot-org!

* '''Ars Technica''' [https://arstechnica.com/gadgets/2017/06/how-to-install-linux-on-a-chromebook/ How To Install Linux on a Chromebook] (2017-06-19)
* '''Linux Luddites''' [https://linuxluddites.com/shows/episode-85/ Linux Luddites Episode #85] (2016-08-22)
* '''Nick Janetakis''' [http://nickjanetakis.com/blog/transform-a-toshiba-chromebook-cb35-into-a-linux-development-environment-with-galliumos Transform a Toshiba Chromebook CB35 (2015) into a Linux development environment with GalliumOS] (2016-07-30)
* '''Jean-Pierre Buntinx '''[https://medium.com/@jdebunt/why-i-switched-to-galliumos-on-my-acer-c720-chromebook-a61e38b2f24d#.frabh8516 Why I Switched to GalliumOS On My Acer C720 Chromebook] (2016-05-17)
* '''tech lore by igor''' [https://techlorebyigor.blogspot.com/2016/04/my-review-of-galliumos-v10.html My Review of GalliumOS v1.0] (2016-04-05) (we're not the North Korean mafia, we super promise!)
* '''Foss Force''' [http://fossforce.com/2016/03/screencast-look-galliumos A Screencast Look at GalliumOS] (2016-03-25)
* '''Linux Action Show''' [http://www.jupiterbroadcasting.com/92926/pre-scale-las-las-401/ Pre SCaLE LAS | LAS 401] (2016-01-24)
* '''Linux.com''' [http://www.linux.com/learn/tutorials/870387-galliumos-the-ideal-linux-distribution-for-chromebook-hardware/ GalliumOS: The Ideal Linux Distribution for Chromebook Hardware] (2015-12-05)
* '''ITWorld.com''' [http://www.itworld.com/article/3004051/linux/galliumos-beta-released-for-chromebooks-and-chromeboxes.html GalliumOS Linux beta released for Chromebooks and Chromeboxes] (2015-11-12)
* '''ChromeCrunch''' [http://chromecrunch.com/galliumos-for-chromeos-is-finally-here-beta-1-is-ready-to-install-on-chromebook/ GalliumOS For ChromeOS Is Finally Here! Beta 1 Is Ready To Install] (2015-11-12)
* '''Elio's Corner''' [http://elioqoshi.me/2015/11/galliumos-beta/ GalliumOS – A Linux alternative for ChromeOS] (2015-11-12)
* '''ColtonDRG.com''' [https://coltondrg.com/2015/11/galliumos-beta-1-released/ GalliumOS Beta 1 Released] (2015-11-11)

== Non-English ==

We don't really know what these say... We hope they're good! :D

* '''Omicrono''' (es) [http://www.omicrono.com/2016/05/galliumos-chromebook-chrome-os/ GalliumOS, la alternativa perfecta a ChromeOS] (2016-05-26)
* '''linuxadictos''' (es) [http://www.linuxadictos.com/galliumos-beta-disponible-de-la-mejor-distro-al-estilo-chrome-os.html GalliumOS beta disponible de la mejor distro al estilo Chrome OS] (2015-11-17)
* '''Cloudspace.news''' (ru) [http://cloudspace.news/linux-chromebook-galliumos/ Опубликована первая версия GalliumOS] (2015-11-13)

Hardware Compatibility

2017-04-27T01:47:39Z

Dvdmuckle: fixed closing reference tag

In order to install and run GalliumOS, your ChromeOS device needs firmware with Legacy Boot capability. This feature is typically provided by [http://www.seabios.org/ SeaBIOS], and included in [http://coreboot.org coreboot].

Some Chromebooks and Chromeboxes have Legacy Boot enabled in the default factory firmware. Other models require a firmware update to add or enable the feature, and unfortunately some models will not work at all.

In general, ChromeOS devices fall into categories by the core architecture of their CPU:

* '''Intel Haswell''', '''Broadwell''', '''Bay Trail''', and '''Sandy/Ivy Bridge''' Chromebooks and Chromeboxes are supported by GalliumOS
* '''Intel Braswell''' and '''Skylake''' models are newer and ''mostly'' supported
* '''Intel Pineview''' models are older and <span style="color:#cc0000">not supported</span>: they do not ship with compatible firmware, and custom firmware is not presently available
* '''ARM''' models are <span style="color:#cc0000">not supported</span>: they do not ship with compatible firmware, and custom firmware is not presently available

The table below lists all ChromeOS devices ever produced, and the vital details regarding their ability to support GalliumOS. If you find any errors or omissions, please let us know!

If you run into any issues not covered here, please check our [https://github.com/GalliumOS/galliumos-distro/issues issue tracker] and submit a bug report.

Third party firmware updates for many devices are available from several parties -- see [[Firmware]].

Additionally, some devices can support dual-boot (GalliumOS alongside ChromeOS) either with stock firmware or with updated firmware. See [https://chrx.org/ chrx] for full details.

<span style="display:none">

<ref name="Pineview"/>
<ref name="ARM"/>
<ref name="SandyIvy"/>
<ref name="Haswell"/>
<ref name="Broadwell"/>
<ref name="BayTrail"/>
<ref name="Braswell"/>
<ref name="Skylake"/>
<ref name="hwid"/>
<ref name="chrx"/>
<ref name="TextMode"/>
<ref name="HiDPI2560"/>
<ref name="SAMUS"/>
<ref name="PANTHER"/>
</span>

== GalliumOS Support by Model ==



{| class="wikitable"
|-
! scope="col"| Model
! scope="col"| Hardware ID<ref name="hwid"/>
! scope="col"| Released
! scope="col"| Processor
! scope="col"| Supports GalliumOS?
! scope="col"| … with factory firmware?
! scope="col"| … with custom firmware?
! scope="col"| … dual-boot with ChromeOS?<ref name="chrx"/>
! scope="col"| More Info
|-
| Acer AC700
| ZGB
| 2011
| Intel Pineview<ref name="Pineview"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="Pineview"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Acer C7
| PARROT
| 2012
| Intel Sandy/Ivy Bridge<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ffe8e8" | No
|-
| Acer C710
| PARROT
| 2012
| Intel Sandy/Ivy Bridge<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ffe8e8" | No
|-
| Acer C720
| PEPPY
| 2013
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Peppy|Installation]]
|-
| Acer C720P
| PEPPY
| 2013
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Peppy|Installation]]
|-
| Acer C730
| GNAWTY
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Acer C910
| YUNA
| 2014
| Intel Broadwell<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffffcc" | Yes, with issues:<br>text display<ref name="TextMode"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Acer Chromebook 11 (C740)
| PAINE
| 2014
| Intel Broadwell<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffffcc" | Yes, with issues:<br>text display<ref name="TextMode"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Acer Chromebook 11 (CB3-111)
| GNAWTY
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Acer Chromebook 11 (CB3-131)
| GNAWTY
| 2016
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Acer Chromebook 11 (C735)
| GNAWTY
| 2016
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Acer Chromebook 11 N7 (C731)
| RELM
| 2017
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Acer Chromebook 13 C810
| (tbd)
| 2015
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Acer Chromebook 13 (CB5-311)
| BIG
| 2014
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Acer Chromebook 14 (CB3-431)
| EDGAR
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Acer Chromebook 14 For Work (CP5-471)
| LARS
| 2016
| Intel Skylake<ref name="Skylake"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: internal audio<ref name="Skylake"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: boot video<ref name="Skylake"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Skylake"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Acer Chromebook 15 (CB3-531)
| BANJO
| 2015
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Acer Chromebook 15 (CB5-571)
| YUNA
| 2014
| Intel Broadwell<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffffcc" | Yes, with issues:<br>text display<ref name="TextMode"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Acer Chromebook 15 (CB3-532)
| BANON
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Acer Chromebook R11 (CB5-132T, C738T)
| CYAN
| 2015
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: internal audio
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Acer Chromebook R13 (CB5-312T)
| ELM
| 2016
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Acer Chromebox CXI
| MCCLOUD
| 2014
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Panther|Installation]]
|-
| Acer Chromebox CXI2
| RIKKU
| 2015
| Intel Broadwell<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| AOPEN Chromebase Commercial 22 (WT22M)
| SUMO
| 2015
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| AOPEN Chromebox Commercial (DE3255)
| NINJA
| 2015
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| ASUS Chromebook C200
| SQUAWKS
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| ASUS Chromebook C201PA
| SPEEDY
| 2015
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| ASUS Chromebook C202SA
| TERRA
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| ASUS Chromebook C300
| QUAWKS
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| ASUS Chromebook C300SA
| TERRA
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| ASUS Chromebook C301SA
| TERRA
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| ASUS Chromebook Flip C302
| CAVE
| 2016
| Intel Skylake<ref name="Skylake"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: internal audio<ref name="Skylake"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: boot video<ref name="Skylake"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Skylake"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| ASUS Chromebox CN60
| PANTHER
| 2014
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffffcc" | Yes, with issues:<br>USB init<ref name="PANTHER"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Panther|Installation]]
|-
| ASUS Chromebox CN62
| GUADO
| 2015
| Intel Broadwell<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| ASUS Flip C100
| MINNIE
| 2015
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| CTL J2 Chromebook for Education
| JERRY
| 2015
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| CTL J4 Chromebook for Education
| JERRY
| 2015
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| CTL NL6 Education Chromebook
| ENGUARDE
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| CTL NL61 Chromebook
| RELM
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Dell Chromebook 11
| WOLF
| 2014
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Dell Chromebook 11 (3120)
| CANDY
| 2015
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Dell Chromebook 11 (3180)
| KEFKA
| 2017
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Dell Chromebook 11 (3189)
| KEFKA
| 2017
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Dell Chromebook 13 (7310)
| LULU
| 2015
| Intel Broadwell<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffffcc" | Yes, with issues:<br>text display<ref name="TextMode"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Lulu|Installation]]
|-
| Dell Chromebook 13 (3380)
| ASUKA
| 2017
| Intel Skylake<ref name="Skylake"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: internal audio<ref name="Skylake"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: boot video<ref name="Skylake"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Skylake"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Dell Chromebox
| TRICKY
| 2014
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Panther|Installation]]
|-
| Edxis Education Chromebook
| RELM
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Google Chromebook Pixel
| LINK
| 2013
| Intel Ivy Bridge<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: HiDPI<ref name="HiDPI2560"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues?
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Google Chromebook Pixel
| SAMUS
| 2015
| Intel Broadwell<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="SAMUS"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Samus|Installation]]
|-
| Google Cr-48
| MARIO
| 2011
| Intel Pineview<ref name="Pineview"/>
| style="text-align:center;background-color:#ffffcc" | Possibly<ref name="Pineview"/>
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ffffcc" | Possibly<ref name="Pineview"/>
| style="text-align:center;background-color:#ffffcc" | Possibly, after firmware update<ref name="chrx"/>
|-
| Haier Chromebook 11
| JAQ
| 2015
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Haier Chromebook 11 (edu)
| MIGHTY
| 2015
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Haier Chromebook 11 G2
| HELI
| 2015
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| HEXA Chromebook Pi
| EXPRESSO
| 2014
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| HiSense Chromebook 11
| JERRY
| 2015
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| HP Chromebook 11 G1
| SPRING
| 2013
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| HP Chromebook 11 G2
| SKATE
| 2013
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| HP Chromebook 11 G3
| KIP
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| HP Chromebook 11 G4
| KIP
| 2015
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| HP Chromebook 11 G5
| SETZER
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| HP Chromebook 11 G5 EE
| RELM
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| HP Chromebook 13
| CHELL
| 2016
| Intel Skylake<ref name="Skylake"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: internal audio<ref name="Skylake"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: boot video<ref name="Skylake"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Skylake"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| HP Chromebook 14
| FALCO
| 2013
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| HP Chromebook 14 G3
| BLAZE
| 2014
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| HP Chromebook 14 G4
| KIP
| 2015
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| HP Chromebox
| ZAKO
| 2014
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffffcc" | Yes, with issues:<br>USB init<ref name="PANTHER"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Panther|Installation]]
|-
| HP Pavilion Chromebook 14
| BUTTERFLY
| 2013
| Intel Sandy Bridge<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ffe8e8" | No
|-
| LG Chromebase (22CV241)
| MONROE
| 2014
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ffffcc" | Probably
|
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ffffcc" | Probably<ref name="chrx"/>
|-
| LG Chromebase (22CB25S)
| MONROE
| 2016
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ffffcc" | Probably
|
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ffffcc" | Probably<ref name="chrx"/>
|-
| Lenovo 100S Chromebook
| ORCO
| 2015
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Lenovo N20 Chromebook
| CLAPPER
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Lenovo N20P Chromebook
| CLAPPER
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Lenovo N21 Chromebook
| ENGUARDE
| 2015
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Lenovo N22 Chromebook
| REKS
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Lenovo N42 Chromebook
| REKS
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Lenovo ThinkCentre Chromebox
| TIDUS
| 2015
| Intel Broadwell<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Lenovo ThinkPad 11e Chromebook
| GLIMMER
| 2015
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Lenovo ThinkPad 11e Chromebook G3
| ULTIMA
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Lenovo ThinkPad 13 Chromebook
| SENTRY
| 2016
| Intel Skylake<ref name="Skylake"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: internal audio<ref name="Skylake"/>
| style="text-align:center;background-color:#ffffcc" | Yes, with issues: boot video<ref name="Skylake"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Skylake"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Lenovo ThinkPad Yoga
| GLIMMER
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Lenovo ThinkPad Yoga G3
| ULTIMA
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Lenovo X131e Chromebook
| STOUT
| 2013
| Intel Ivy Bridge<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ffe8e8" | No
|-
| Mecer V2 Chromebook
| RELM
| 2017
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| NComputing Chromebook CX100
| JERRY
| 2016
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Samsung Chromebook (XE303C12)
| SNOW
| 2012
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Samsung Chromebook 2 (XE500C12)
| WINKY
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [https://sites.google.com/site/winkychromebook/ Installation]
|-
| Samsung Chromebook 2 (XE503C12)
| PIT
| 2014
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Samsung Chromebook 2 (XE503C32)
| PI
| 2014
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Samsung Chromebook 3 (XE500C13)
| CELES
| 2016
| Intel Braswell<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Braswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
|-
| Samsung Chromebook Plus (XE513C24)
| KEVIN
| 2017
| ARM<ref name="ARM"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="ARM"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Samsung Series 3 Chromebox
| STUMPY
| 2012
| Intel Sandy Bridge<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ffe8e8" | No
|-
| Samsung Series 5
| ALEX
| 2011
| Intel Pineview<ref name="Pineview"/>
| style="text-align:center;background-color:#ffcccc" | No<ref name="Pineview"/>
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
| style="text-align:center;background-color:#ffe8e8" | -
|-
| Samsung Series 5 550
| LUMPY
| 2012
| Intel Sandy Bridge<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="SandyIvy"/>
| style="text-align:center;background-color:#ffe8e8" | No
|-
| Senkatel Edu
| ENGUARDE
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Toshiba Chromebook CB30
| LEON
| 2014
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Toshiba Chromebook CB35
| LEON
| 2014
| Intel Haswell<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Haswell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
| Toshiba Chromebook 2 CB30
| SWANKY
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Toshiba Chromebook 2 CB35
| SWANKY
| 2014
| Intel Bay Trail<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="BayTrail"/>
| style="text-align:center;background-color:#ccffcc" | Yes, after firmware update<ref name="chrx"/>
| style="text-align:center;" | [[Installing/Baytrail|Installation]]
|-
| Toshiba Chromebook 2 CB35
| GANDOF
| 2015
| Intel Broadwell<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes
| style="text-align:center;background-color:#ffffcc" | Yes, with issues:<br>text display<ref name="TextMode"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="Broadwell"/>
| style="text-align:center;background-color:#ccffcc" | Yes<ref name="chrx"/>
|-
! scope="col"| Model
! scope="col"| Hardware ID
! scope="col"| Released
! scope="col"| Processor
! scope="col"| Supports GalliumOS?
! scope="col"| … with factory firmware?
! scope="col"| … with custom firmware?
! scope="col"| … dual-boot with ChromeOS?<ref name="chrx"/>
! scope="col"| More Info
|-
|}

=== Notes ===

<references>
<ref name="Pineview">
'''Pineview''' models do not ship with compatible firmware, and custom firmware is not generally available. MARIO (Google Cr-48) might be an exception. See [[Support/Pineview]].
</ref>
<ref name="SandyIvy">
'''Sandy/Ivy Bridge''' models are supported. See [[Support/SandyIvy]].
</ref>
<ref name="Haswell">
'''Haswell''' models are well-supported. See [[Support/Haswell]].
</ref>
<ref name="BayTrail">
'''Bay Trail''' models are supported. See [[Support/BayTrail]].
</ref>
<ref name="Broadwell">
'''Broadwell''' models are well-supported. See [[Support/Broadwell]].
</ref>
<ref name="ARM">
'''ARM''' models do not ship with compatible firmware, and custom firmware is not available at this time. See [[Support/ARM]].
</ref>
<ref name="Braswell">
'''Braswell''' models are '''mostly''' supported. See [[Support/Braswell]] and [https://github.com/GalliumOS/galliumos-distro/issues/270 Braswell Platform Validation].
</ref>
<ref name="Skylake">
'''Skylake''' models are '''mostly''' supported. See [[Support/Skylake]] and [https://github.com/GalliumOS/galliumos-distro/issues/274 Skylake Platform Validation].
</ref>
<ref name="TextMode">'''Text Mode''':
The factory firmware of this model fails to display text-mode output, so messages printed to screen during the early boot process will be invisible. This can be functional, but very difficult to debug if problems arise. Updated FULL ROM firmware fixes it. See [[Firmware]].
</ref>
<ref name="HiDPI2560">'''HiDPI''':
This model has a 2560x1700 display. GalliumOS (Xfce, Gtk2, xfwm4) will work at this geometry, but GUI elements will be very small (possibly unusably small), since they are not scaled appropriately. You can install the <code>galliumos-hidpi</code> package for better settings.
</ref>
<ref name="SAMUS">'''SAMUS'''
(Google Pixel, 2015) See [[Installing/Samus]] for some notes on audio and HiDPI config.
</ref>
<ref name="PANTHER">'''PANTHER/ZAKO'''
(ASUS Chromebox, 2014 / HP Chromebox, 2014) have a broken factory legacy boot payload that fails to initialize the USB3 ports; custom firmware is the only resolution. See also [[Installing/Panther]].
</ref>
<ref name="hwid">'''Hardware ID''': Each Chromebook/box/base model is identified by a hardware ID. Some manufacturers reuse model names for different hardware IDs (e.g. Samsung), and others market several versions of the same hardware ID (e.g. HP). For purposes of support questions, hardware ID is the most important identifier for your model. You can check your Hardware ID from the Developer Mode boot screen ("OS verification is OFF"), from the Terminal (<code>dmidecode -s system-product-name</code>) or from inside ChromeOS by navigating to <code>chrome://system</code>, where it's called <code>hardware_class</code>.
</ref>
<ref name="chrx">'''Dual-Booting''' with ChromeOS is possible where the factory firmware supports legacy booting (SeaBIOS), or the custom firmware installs legacy boot capability without removing ChromeOS boot functionality. Currently, dual-boot setups are installed via [https://chrx.org/ chrx].
</ref>
</references>

Additional Software

2017-03-01T17:40:41Z

Dvdmuckle: /* Skype */

GalliumOS comes with a good selection of desktop and utility software, but there is a huge variety of additional options and alternatives.

GalliumOS can install any software packages built for Ubuntu, directly from the Canonical package servers.

There are also some frequently-requested applications that are not available from Canonical, or are more complicated to install. A few are listed here. Please add more!

== Desktop ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb
</pre>



=== Adobe Flash ===

Adobe Flash apps (and Twitch streams, etc) require Adobe Flash Player, which is not included by default in GalliumOS.

* Install adobe-flashplugin from Canonical's <code>partner</code> repository.
<pre style="margin:0 0 0 2em; padding:0.4em;">
sudo add-apt-repository "deb http://archive.canonical.com/ubuntu $(lsb_release -sc) partner"
sudo apt-get update
sudo apt-get install adobe-flashplugin
</pre>
* Confirm installation by entering <code>chrome://plugins</code> (Chromium) or <code>about:plugins</code> (Firefox) into the URL bar

The proprietary version of Google Chrome includes PepperFlash, and does not require an additional plugin.

=== Firefox Aurora ===

Aurora is the '''developer preview''' of Firefox.

The '''stable''' version of Firefox can be installed from the standard Canonical repositories with <code>sudo apt install firefox</code>.

More info: https://launchpad.net/~ubuntu-mozilla-daily/+archive/ubuntu/firefox-aurora

=== Pale Moon ===

Pale Moon is a web browser, originally derived from Firefox, and optimized for performance.

* Official site: http://linux.palemoon.org/
* Installation: https://software.opensuse.org/download.html?project=home%3Astevenpusser&package=palemoon
** (Follow instructions for Ubuntu)

=== TeamViewer ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
curl -OL http://download.teamviewer.com/download/teamviewer_i386.deb
sudo dpkg -i teamviewer_i386.deb
</pre>

=== Google Drive integration<br> ===
* Install the software
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:alessandro-strada/ppa
sudo apt-get update
sudo apt-get install google-drive-ocamlfuse
</pre>

* Run google-drive-ocamlfuse for first time setup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse
</pre>

You'll get a browser window asking you to sign in to your Google account and if you want to give gdfuse OAuth2 Endpoint permission to access your Drive files. Hit Accept / Allow for any following dialog. Close the browser window.

* Next, create a directory where your Google Drive files will be mounted, preferably in your home directory, and mount Google Drive to that directory.
<pre style="margin:0 0 0 1.5em">
mkdir ~/googledrive
google-drive-ocamlfuse ~/googledrive
</pre>

You can check if Google Drive is mounted by performing:
<pre style="margin:0 0 0 1.5em">
mount
</pre>

You can also check how much space you have left:
<pre style="margin:0 0 0 1.5em">
df
</pre>

If you want to unmount, simply run
<pre style="margin:0 0 0 1.5em">
fusermount -u ~/googledrive
</pre>

* To mount Google Drive at startup, set the following command to run at boot with Session and Startup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse -label default /home/<user>/googledrive
</pre>

A word of warning, large files such as movies or large videos don't work too well with google-drive-ocamlfuse using default settings. Files are cached to ~/.gdfuse/default/cache. A config file can be found in the directory above that, with parameters to allow for streaming larger files, cache size, etc.. The streaming larger files parameter is perfect for large videos and movies. For more information, check out gdfuse on GitHub.

Adapted from: http://xmodulo.com/mount-google-drive-linux.html

Most up-to-date instructions can be found on project home page: https://github.com/astrada/google-drive-ocamlfuse/wiki

=== Skype ===

Download the .deb below, and install using:
<pre style="margin:0 0 0 1.5em">
sudo dpkg -i skypeforlinux-64.deb
</pre>

Deb download: https://www.skype.com/en/download-skype/skype-for-linux/downloading-web/?type=weblinux-deb

If you have the older Skype client installed, you will need to update to the newest client. For information on the older client, see: https://help.ubuntu.com/community/Skype

Source: https://blogs.skype.com/news/2017/03/01/the-skype-for-linux-beta-version-5-0-is-now-available-for-download/?utm_source=t.co&utm_medium=referral

Note that while this is the only officially supported Skype client, it is an beta, so not everything may work.

=== Wine ===

Wine has been a source of frustration. These instructions are verified on a fresh install of 2.0.

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository ppa:ubuntu-wine/ppa
sudo apt-get update
sudo apt-get install wine1.8
</pre>

=== Simple Screen Recorder ===
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository -y ppa:maarten-baert/simplescreenrecorder
sudo apt-get update
sudo apt-get install simplescreenrecorder
</pre>

=== Spotify ===

<pre style="margin:0 0 0 1.5em">
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys BBEBDCB318AD50EC6865090613B00F1FD2C19886
echo deb http://repository.spotify.com stable non-free | sudo tee /etc/apt/sources.list.d/spotify.list
sudo apt-get update
sudo apt-get install spotify-client
</pre>

Source: https://www.spotify.com/us/download/linux/

=== Kodi Media Center ===

<pre style="margin:0 0 0 1.5em">
sudo apt-get install python-software-properties pkg-config software-properties-common
sudo add-apt-repository -y ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi
</pre>

== Games ==

=== Steam ===
<pre style="margin:0 0 0 1.5em">
curl -O http://repo.steampowered.com/steam/archive/precise/steam_latest.deb
sudo apt install python-apt
sudo dpkg -i steam_latest.deb
</pre>

Then launch Steam from the application launcher. Your user must be in the "sudo" group (if it is not, the dpkg command above will also fail), so that the installer can do all the things it needs to do.

=== Minecraft ===
<pre style="margin:0 0 0 1.5em">
sudo bash
apt-get install default-jre
curl -o /usr/local/bin/Minecraft.jar https://s3.amazonaws.com/Minecraft.Download/launcher/Minecraft.jar
curl -o /usr/share/pixmaps/minecraft.png https://chrx.org/minecraft.png
mkdir -p /usr/local/share/applications
cat > /usr/local/share/applications/minecraft.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Minecraft
Comment=Minecraft
Exec=java -jar /usr/local/bin/Minecraft.jar
Icon=/usr/share/pixmaps/minecraft.png
Categories=Game;
EOF
</pre>

== Utilities ==

=== grsync ===
Graphical lightweight version of rsync to back up data between drives
<pre style="margin:0 0 0 1.5em">
sudo apt-get install grsync
</pre>

=== aptik ===
Backup APT sources/repository data
<pre style="margin:0 0 0 1.5em">
sudo apt-add-repository -y ppa:teejee2008/ppa
sudo apt-get update
sudo apt-get install aptik
</pre>

=== OpenVPN ===
Install the following two packages to get OpenVPN connectivity with your favorite VPN service.
<pre style="margin:0 0 0 1.5em">
sudo apt-get install openvpn network-manager-openvpn
</pre>

=== caffeine-plus ===
Used to keep the screen awake with full screen applications such as full screen video.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:nilarimogard/webupd8
sudo apt-get update
sudo apt-get install caffeine-plus
</pre>
Source: [http://www.webupd8.org/2014/08/screensaver-lock-screen-inhibitor.html Webupd8]

== Hardware Optimization ==

=== Battery Tuning ===

==== Powertop ====
Monitor process and device power consumption. Includes a handy auto-tune option which can be run at startup that helps to minimize power consumption. Powertop also provides a calibration option, which some people have reported issues with (locks up device?).

<pre style="margin:0 0 0 1.5em">
sudo apt-get install powertop
sudo powertop
</pre>

Powertop needs to be run every time the system boots. Expand for instructions:

<div class="mw-collapsible mw-collapsed" style="border:1px #666666 dashed;padding:0.5em 1em;min-height:2em;margin:0 2em;background-color:#eee;">

Create <code>/etc/systemd/system/powertop.service</code> with the following content:

<pre style="margin:0 0 0 1.5em">
[Unit]
Description=Powertop tunings

[Service]
Type=oneshot
ExecStart=/usr/sbin/powertop --auto-tune

[Install]
WantedBy=multi-user.target
</pre>

Then reboot.

Source: https://wiki.archlinux.org/index.php/Powertop
</div>

==== TLP ====

Advanced power management tool that also provides a default configuration optimized for battery life for "install and forget it" benefits. TLP has reportedly provided some improvement to battery life. Your mileage may vary.

<div style="background-color:#ffffcc;margin:0 0 0.5em 1.5em; padding:0.3em;border:1px solid #ccccaa">NOTE: There are also reports of system instability while running TLP. If you experience any issues, try disabling it first.</div>

<pre style="margin:0 0 0 1.5em">sudo add-apt-repository ppa:linrunner/tlp
sudo apt-get install tlp
sudo tlp start</pre>

== Miscellaneous ==

These have been discussed, but are not presently candidates for inclusion in the default installation. They might be of special interest, might have important caveats, or might be the unchosen of other options. Presented here for convenience.

==== Hardware temperature monitor ====
* <code>xfce4-sensors-plugin</code> from Ubuntu repositories. '''WARNING:''' Do '''not''' select <code>tachos</code>. It will crash your desktop.

==== Clipboard Manager ====
* <code>clipit</code> from Ubuntu repositories. Developer homepage is missing. Be conscious of the security implications of all clipboard managers.

==== Video Player ====
* https://mpv.io/ Lightweight, but very minimal UI
* <code>smplayer</code> from Ubuntu repositories. Lightweight.

==== Screen Recorder ====
* <code>OBS</code> from PPA. One of the most popular screen recording tools. See https://obsproject.com/ for more info.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:obsproject/obs-studio
sudo apt-get update
sudo apt-get install obs-studio
</pre>
* <code>kazam</code> from Ubuntu repositories. Alternative to <code>simplescreenrecorder</code>, above. See https://apps.ubuntu.com/cat/applications/kazam/ for more info.

==== Disk Usage/Performance Indicators ====
* <code>xfce4-goodies</code> from Ubuntu repositories includes a free space checker applet
* <code>xfce4-diskperf-plugin</code> from Ubuntu repositories is a disk performance monitor applet, and shows usage as well

Additional Software

2017-02-28T23:01:16Z

Dvdmuckle: /* Skype */

GalliumOS comes with a good selection of desktop and utility software, but there is a huge variety of additional options and alternatives.

GalliumOS can install any software packages built for Ubuntu, directly from the Canonical package servers.

There are also some frequently-requested applications that are not available from Canonical, or are more complicated to install. A few are listed here. Please add more!

== Desktop ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb
</pre>



=== Adobe Flash ===

Adobe Flash apps (and Twitch streams, etc) require Adobe Flash Player, which is not included by default in GalliumOS.

* Install adobe-flashplugin from Canonical's <code>partner</code> repository.
<pre style="margin:0 0 0 2em; padding:0.4em;">
sudo add-apt-repository "deb http://archive.canonical.com/ubuntu $(lsb_release -sc) partner"
sudo apt-get update
sudo apt-get install adobe-flashplugin
</pre>
* Confirm installation by entering <code>chrome://plugins</code> (Chromium) or <code>about:plugins</code> (Firefox) into the URL bar

The proprietary version of Google Chrome includes PepperFlash, and does not require an additional plugin.

=== Firefox Aurora ===

Aurora is the '''developer preview''' of Firefox.

The '''stable''' version of Firefox can be installed from the standard Canonical repositories with <code>sudo apt install firefox</code>.

More info: https://launchpad.net/~ubuntu-mozilla-daily/+archive/ubuntu/firefox-aurora

=== Pale Moon ===

Pale Moon is a web browser, originally derived from Firefox, and optimized for performance.

* Official site: http://linux.palemoon.org/
* Installation: https://software.opensuse.org/download.html?project=home%3Astevenpusser&package=palemoon
** (Follow instructions for Ubuntu)

=== TeamViewer ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
curl -OL http://download.teamviewer.com/download/teamviewer_i386.deb
sudo dpkg -i teamviewer_i386.deb
</pre>

=== Google Drive integration<br> ===
* Install the software
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:alessandro-strada/ppa
sudo apt-get update
sudo apt-get install google-drive-ocamlfuse
</pre>

* Run google-drive-ocamlfuse for first time setup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse
</pre>

You'll get a browser window asking you to sign in to your Google account and if you want to give gdfuse OAuth2 Endpoint permission to access your Drive files. Hit Accept / Allow for any following dialog. Close the browser window.

* Next, create a directory where your Google Drive files will be mounted, preferably in your home directory, and mount Google Drive to that directory.
<pre style="margin:0 0 0 1.5em">
mkdir ~/googledrive
google-drive-ocamlfuse ~/googledrive
</pre>

You can check if Google Drive is mounted by performing:
<pre style="margin:0 0 0 1.5em">
mount
</pre>

You can also check how much space you have left:
<pre style="margin:0 0 0 1.5em">
df
</pre>

If you want to unmount, simply run
<pre style="margin:0 0 0 1.5em">
fusermount -u ~/googledrive
</pre>

* To mount Google Drive at startup, set the following command to run at boot with Session and Startup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse -label default /home/<user>/googledrive
</pre>

A word of warning, large files such as movies or large videos don't work too well with google-drive-ocamlfuse using default settings. Files are cached to ~/.gdfuse/default/cache. A config file can be found in the directory above that, with parameters to allow for streaming larger files, cache size, etc.. The streaming larger files parameter is perfect for large videos and movies. For more information, check out gdfuse on GitHub.

Adapted from: http://xmodulo.com/mount-google-drive-linux.html

Most up-to-date instructions can be found on project home page: https://github.com/astrada/google-drive-ocamlfuse/wiki

=== Skype ===

Download the .deb below, and install using:
<pre style="margin:0 0 0 1.5em">
sudo dpkg -i skypeforlinux-64-alpha.deb
</pre>

Deb download: https://www.skype.com/en/download-skype/skype-for-linux/downloading-web/?type=weblinux-deb

If you have the older Skype client installed, you will need to update to the newest client. For information on the older client, see: https://help.ubuntu.com/community/Skype

Source: https://community.skype.com/t5/Linux/Skype-for-Linux-Alpha-and-calling-on-Chrome-amp-Chromebooks/td-p/4434299

Note that while this is the only officially supported Skype client, it is an alpha, so not everything may work.

=== Wine ===

Wine has been a source of frustration. These instructions are verified on a fresh install of 2.0.

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository ppa:ubuntu-wine/ppa
sudo apt-get update
sudo apt-get install wine1.8
</pre>

=== Simple Screen Recorder ===
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository -y ppa:maarten-baert/simplescreenrecorder
sudo apt-get update
sudo apt-get install simplescreenrecorder
</pre>

=== Spotify ===

<pre style="margin:0 0 0 1.5em">
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys BBEBDCB318AD50EC6865090613B00F1FD2C19886
echo deb http://repository.spotify.com stable non-free | sudo tee /etc/apt/sources.list.d/spotify.list
sudo apt-get update
sudo apt-get install spotify-client
</pre>

Source: https://www.spotify.com/us/download/linux/

=== Kodi Media Center ===

<pre style="margin:0 0 0 1.5em">
sudo apt-get install python-software-properties pkg-config software-properties-common
sudo add-apt-repository -y ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi
</pre>

== Games ==

=== Steam ===
<pre style="margin:0 0 0 1.5em">
curl -O http://repo.steampowered.com/steam/archive/precise/steam_latest.deb
sudo apt install python-apt
sudo dpkg -i steam_latest.deb
</pre>

Then launch Steam from the application launcher. Your user must be in the "sudo" group (if it is not, the dpkg command above will also fail), so that the installer can do all the things it needs to do.

=== Minecraft ===
<pre style="margin:0 0 0 1.5em">
sudo bash
apt-get install default-jre
curl -o /usr/local/bin/Minecraft.jar https://s3.amazonaws.com/Minecraft.Download/launcher/Minecraft.jar
curl -o /usr/share/pixmaps/minecraft.png https://chrx.org/minecraft.png
mkdir -p /usr/local/share/applications
cat > /usr/local/share/applications/minecraft.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Minecraft
Comment=Minecraft
Exec=java -jar /usr/local/bin/Minecraft.jar
Icon=/usr/share/pixmaps/minecraft.png
Categories=Game;
EOF
</pre>

== Utilities ==

=== grsync ===
Graphical lightweight version of rsync to back up data between drives
<pre style="margin:0 0 0 1.5em">
sudo apt-get install grsync
</pre>

=== aptik ===
Backup APT sources/repository data
<pre style="margin:0 0 0 1.5em">
sudo apt-add-repository -y ppa:teejee2008/ppa
sudo apt-get update
sudo apt-get install aptik
</pre>

=== OpenVPN ===
Install the following two packages to get OpenVPN connectivity with your favorite VPN service.
<pre style="margin:0 0 0 1.5em">
sudo apt-get install openvpn network-manager-openvpn
</pre>

=== caffeine-plus ===
Used to keep the screen awake with full screen applications such as full screen video.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:nilarimogard/webupd8
sudo apt-get update
sudo apt-get install caffeine-plus
</pre>
Source: [http://www.webupd8.org/2014/08/screensaver-lock-screen-inhibitor.html Webupd8]

== Hardware Optimization ==

=== Battery Tuning ===

==== Powertop ====
Monitor process and device power consumption. Includes a handy auto-tune option which can be run at startup that helps to minimize power consumption. Powertop also provides a calibration option, which some people have reported issues with (locks up device?).

<pre style="margin:0 0 0 1.5em">
sudo apt-get install powertop
sudo powertop
</pre>

Powertop needs to be run every time the system boots. Expand for instructions:

<div class="mw-collapsible mw-collapsed" style="border:1px #666666 dashed;padding:0.5em 1em;min-height:2em;margin:0 2em;background-color:#eee;">

Create <code>/etc/systemd/system/powertop.service</code> with the following content:

<pre style="margin:0 0 0 1.5em">
[Unit]
Description=Powertop tunings

[Service]
Type=oneshot
ExecStart=/usr/sbin/powertop --auto-tune

[Install]
WantedBy=multi-user.target
</pre>

Then reboot.

Source: https://wiki.archlinux.org/index.php/Powertop
</div>

==== TLP ====

Advanced power management tool that also provides a default configuration optimized for battery life for "install and forget it" benefits. TLP has reportedly provided some improvement to battery life. Your mileage may vary.

<div style="background-color:#ffffcc;margin:0 0 0.5em 1.5em; padding:0.3em;border:1px solid #ccccaa">NOTE: There are also reports of system instability while running TLP. If you experience any issues, try disabling it first.</div>

<pre style="margin:0 0 0 1.5em">sudo add-apt-repository ppa:linrunner/tlp
sudo apt-get install tlp
sudo tlp start</pre>

== Miscellaneous ==

These have been discussed, but are not presently candidates for inclusion in the default installation. They might be of special interest, might have important caveats, or might be the unchosen of other options. Presented here for convenience.

==== Hardware temperature monitor ====
* <code>xfce4-sensors-plugin</code> from Ubuntu repositories. '''WARNING:''' Do '''not''' select <code>tachos</code>. It will crash your desktop.

==== Clipboard Manager ====
* <code>clipit</code> from Ubuntu repositories. Developer homepage is missing. Be conscious of the security implications of all clipboard managers.

==== Video Player ====
* https://mpv.io/ Lightweight, but very minimal UI
* <code>smplayer</code> from Ubuntu repositories. Lightweight.

==== Screen Recorder ====
* <code>OBS</code> from PPA. One of the most popular screen recording tools. See https://obsproject.com/ for more info.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:obsproject/obs-studio
sudo apt-get update
sudo apt-get install obs-studio
</pre>
* <code>kazam</code> from Ubuntu repositories. Alternative to <code>simplescreenrecorder</code>, above. See https://apps.ubuntu.com/cat/applications/kazam/ for more info.

==== Disk Usage/Performance Indicators ====
* <code>xfce4-goodies</code> from Ubuntu repositories includes a free space checker applet
* <code>xfce4-diskperf-plugin</code> from Ubuntu repositories is a disk performance monitor applet, and shows usage as well

Support/SandyIvy

2017-02-14T18:20:28Z

Dvdmuckle:

Intel processors with Sandy Bridge and Ivy Bridge cores are only used in a few ChromeOS devices.

Factory firmware support for coreboot and SeaBIOS is limited, but custom firmware is available for all Sandy/Ivy Bridge models from John Lewis: https://johnlewis.ie/custom-chromebook-firmware/rom-download/.

Full firmware for select Sandy/Ivy Bridge models is also available from MrChromebox: https://mrchromebox.tech

There are three firmware update options available:

# '''RW_LEGACY'''
#* Leaves all stock functionality intact, including the white "OS verification is OFF" screen
#* Allows device to dual-boot GalliumOS alongside ChromeOS
#* Some models ship with this feature enabled and including a working SeaBIOS
#* On some models, includes bugfixes and enables additional functionality such as booting from SD card/eMMC
#* '''''Sandy/Ivy Bridge''': only available for the Google Pixel 2013 (LINK)''
# '''BOOT_STUB'''
#* Bypasses the white "OS verification is OFF" screen
#* Removes the ability to run ChromeOS natively, creating a small risk of bricking your device
#* Leaves the “REFRESH + POWER” functionality of the stock ROM intact
#** If you engage this key sequence, device will reboot and try to run ChromeOS Recovery (which will fail)
#** This process will repeat on every boot until you disassemble the device and briefly disconnect the battery
# '''Full ROM'''
#* Installs a complete ROM containing a coreboot build and a working SeaBIOS
#* Bypasses the white "OS verification is OFF" screen
#* Removes the ability to run ChromeOS natively, creating a small risk of bricking your device
#* Will wipe out all product data
#* This option is the most invasive and may include bugs or idiosyncrasies that the stock firmware does not
#* '''''Sandy/Ivy Bridge''': Enables hardware virtualization extensions and suspend''

Additional Software

2017-02-14T04:28:07Z

Dvdmuckle: /* Skype */

GalliumOS comes with a good selection of desktop and utility software, but there is a huge variety of additional options and alternatives.

GalliumOS can install any software packages built for Ubuntu, directly from the Canonical package servers.

There are also some frequently-requested applications that are not available from Canonical, or are more complicated to install. A few are listed here. Please add more!

== Desktop ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb
</pre>



=== Adobe Flash ===

Adobe Flash apps (and Twitch streams, etc) require Adobe Flash Player, which is not included by default in GalliumOS.

* Install adobe-flashplugin from Canonical's <code>partner</code> repository.
<pre style="margin:0 0 0 2em; padding:0.4em;">
sudo add-apt-repository "deb http://archive.canonical.com/ubuntu $(lsb_release -sc) partner"
sudo apt-get update
sudo apt-get install adobe-flashplugin
</pre>
* Confirm installation by entering <code>chrome://plugins</code> (Chromium) or <code>about:plugins</code> (Firefox) into the URL bar

The proprietary version of Google Chrome includes PepperFlash, and does not require an additional plugin.

=== Firefox Aurora ===

Aurora is the '''developer preview''' of Firefox.

The '''stable''' version of Firefox can be installed from the standard Canonical repositories with <code>sudo apt install firefox</code>.

More info: https://launchpad.net/~ubuntu-mozilla-daily/+archive/ubuntu/firefox-aurora

=== Pale Moon ===

Pale Moon is a web browser, originally derived from Firefox, and optimized for performance.

* Official site: http://linux.palemoon.org/
* Installation: https://software.opensuse.org/download.html?project=home%3Astevenpusser&package=palemoon
** (Follow instructions for Ubuntu)

=== TeamViewer ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
curl -OL http://download.teamviewer.com/download/teamviewer_i386.deb
sudo dpkg -i teamviewer_i386.deb
</pre>

=== Google Drive integration<br> ===
* Install the software
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:alessandro-strada/ppa
sudo apt-get update
sudo apt-get install google-drive-ocamlfuse
</pre>

* Run google-drive-ocamlfuse for first time setup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse
</pre>

You'll get a browser window asking you to sign in to your Google account and if you want to give gdfuse OAuth2 Endpoint permission to access your Drive files. Hit Accept / Allow for any following dialog. Close the browser window.

* Next, create a directory where your Google Drive files will be mounted, preferably in your home directory, and mount Google Drive to that directory.
<pre style="margin:0 0 0 1.5em">
mkdir ~/googledrive
google-drive-ocamlfuse ~/googledrive
</pre>

You can check if Google Drive is mounted by performing:
<pre style="margin:0 0 0 1.5em">
mount
</pre>

You can also check how much space you have left:
<pre style="margin:0 0 0 1.5em">
df
</pre>

If you want to unmount, simply run
<pre style="margin:0 0 0 1.5em">
fusermount -u ~/googledrive
</pre>

* To mount Google Drive at startup, set the following command to run at boot with Session and Startup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse -label default /home/<user>/googledrive
</pre>

A word of warning, large files such as movies or large videos don't work too well with google-drive-ocamlfuse using default settings. Files are cached to ~/.gdfuse/default/cache. A config file can be found in the directory above that, with parameters to allow for streaming larger files, cache size, etc.. The streaming larger files parameter is perfect for large videos and movies. For more information, check out gdfuse on GitHub.

Adapted from: http://xmodulo.com/mount-google-drive-linux.html

Most up-to-date instructions can be found on project home page: https://github.com/astrada/google-drive-ocamlfuse/wiki

=== Skype ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository "deb http://archive.canonical.com/ $(lsb_release -sc) partner"
sudo apt-get update && sudo apt-get install skype
</pre>

'''NOTE: ON MARCH 1ST, THIS CLIENT WILL NO LONGER FUNCTION. PLEASE SWITCH TO THE NEW CLIENT.'''

This is the older version of Skype, if you're looking for the newer Skype for Linux Alpha, please see here: https://community.skype.com/t5/Linux/Skype-for-Linux-Alpha-and-calling-on-Chrome-amp-Chromebooks/td-p/4434299

Source: https://help.ubuntu.com/community/Skype

See also: https://www.skype.com/en/download-skype/skype-for-linux/

=== Wine ===

Wine has been a source of frustration. These instructions are verified on a fresh install of 2.0.

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository ppa:ubuntu-wine/ppa
sudo apt-get update
sudo apt-get install wine1.8
</pre>

=== Simple Screen Recorder ===
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository -y ppa:maarten-baert/simplescreenrecorder
sudo apt-get update
sudo apt-get install simplescreenrecorder
</pre>

=== Spotify ===

<pre style="margin:0 0 0 1.5em">
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys BBEBDCB318AD50EC6865090613B00F1FD2C19886
echo deb http://repository.spotify.com stable non-free | sudo tee /etc/apt/sources.list.d/spotify.list
sudo apt-get update
sudo apt-get install spotify-client
</pre>

Source: https://www.spotify.com/us/download/linux/

=== Kodi Media Center ===

<pre style="margin:0 0 0 1.5em">
sudo apt-get install python-software-properties pkg-config software-properties-common
sudo add-apt-repository -y ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi
</pre>

== Games ==

=== Steam ===
<pre style="margin:0 0 0 1.5em">
curl -O http://repo.steampowered.com/steam/archive/precise/steam_latest.deb
sudo apt install python-apt
sudo dpkg -i steam_latest.deb
</pre>

Then launch Steam from the application launcher. Your user must be in the "sudo" group (if it is not, the dpkg command above will also fail), so that the installer can do all the things it needs to do.

=== Minecraft ===
<pre style="margin:0 0 0 1.5em">
sudo bash
apt-get install default-jre
curl -o /usr/local/bin/Minecraft.jar https://s3.amazonaws.com/Minecraft.Download/launcher/Minecraft.jar
curl -o /usr/share/pixmaps/minecraft.png https://chrx.org/minecraft.png
mkdir -p /usr/local/share/applications
cat > /usr/local/share/applications/minecraft.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Minecraft
Comment=Minecraft
Exec=java -jar /usr/local/bin/Minecraft.jar
Icon=/usr/share/pixmaps/minecraft.png
Categories=Game;
EOF
</pre>

== Utilities ==

=== grsync ===
Graphical lightweight version of rsync to back up data between drives
<pre style="margin:0 0 0 1.5em">
sudo apt-get install grsync
</pre>

=== aptik ===
Backup APT sources/repository data
<pre style="margin:0 0 0 1.5em">
sudo apt-add-repository -y ppa:teejee2008/ppa
sudo apt-get update
sudo apt-get install aptik
</pre>

=== OpenVPN ===
Install the following two packages to get OpenVPN connectivity with your favorite VPN service.
<pre style="margin:0 0 0 1.5em">
sudo apt-get install openvpn network-manager-openvpn
</pre>

=== caffeine-plus ===
Used to keep the screen awake with full screen applications such as full screen video.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:nilarimogard/webupd8
sudo apt-get update
sudo apt-get install caffeine-plus
</pre>
Source: [http://www.webupd8.org/2014/08/screensaver-lock-screen-inhibitor.html Webupd8]

== Hardware Optimization ==

=== Battery Tuning ===

==== Powertop ====
Monitor process and device power consumption. Includes a handy auto-tune option which can be run at startup that helps to minimize power consumption. Powertop also provides a calibration option, which some people have reported issues with (locks up device?).

<pre style="margin:0 0 0 1.5em">
sudo apt-get install powertop
sudo powertop
</pre>

Powertop needs to be run every time the system boots. Expand for instructions:

<div class="mw-collapsible mw-collapsed" style="border:1px #666666 dashed;padding:0.5em 1em;min-height:2em;margin:0 2em;background-color:#eee;">

Create <code>/etc/systemd/system/powertop.service</code> with the following content:

<pre style="margin:0 0 0 1.5em">
[Unit]
Description=Powertop tunings

[Service]
Type=oneshot
ExecStart=/usr/sbin/powertop --auto-tune

[Install]
WantedBy=multi-user.target
</pre>

Then reboot.

Source: https://wiki.archlinux.org/index.php/Powertop
</div>

==== TLP ====

Advanced power management tool that also provides a default configuration optimized for battery life for "install and forget it" benefits. TLP has reportedly provided some improvement to battery life. Your mileage may vary.

<div style="background-color:#ffffcc;margin:0 0 0.5em 1.5em; padding:0.3em;border:1px solid #ccccaa">NOTE: There are also reports of system instability while running TLP. If you experience any issues, try disabling it first.</div>

<pre style="margin:0 0 0 1.5em">sudo add-apt-repository ppa:linrunner/tlp
sudo apt-get install tlp
sudo tlp start</pre>

== Miscellaneous ==

These have been discussed, but are not presently candidates for inclusion in the default installation. They might be of special interest, might have important caveats, or might be the unchosen of other options. Presented here for convenience.

==== Hardware temperature monitor ====
* <code>xfce4-sensors-plugin</code> from Ubuntu repositories. '''WARNING:''' Do '''not''' select <code>tachos</code>. It will crash your desktop.

==== Clipboard Manager ====
* <code>clipit</code> from Ubuntu repositories. Developer homepage is missing. Be conscious of the security implications of all clipboard managers.

==== Video Player ====
* https://mpv.io/ Lightweight, but very minimal UI
* <code>smplayer</code> from Ubuntu repositories. Lightweight.

==== Screen Recorder ====
* <code>OBS</code> from PPA. One of the most popular screen recording tools. See https://obsproject.com/ for more info.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:obsproject/obs-studio
sudo apt-get update
sudo apt-get install obs-studio
</pre>
* <code>kazam</code> from Ubuntu repositories. Alternative to <code>simplescreenrecorder</code>, above. See https://apps.ubuntu.com/cat/applications/kazam/ for more info.

==== Disk Usage/Performance Indicators ====
* <code>xfce4-goodies</code> from Ubuntu repositories includes a free space checker applet
* <code>xfce4-diskperf-plugin</code> from Ubuntu repositories is a disk performance monitor applet, and shows usage as well

News/2016 Annual Report and Announcement

2017-01-26T02:16:59Z

Dvdmuckle: /* Stickers and T-Shirts */

== GalliumOS Project, 2016 ==

As we close the books on our first full year of operations, we'd like to thank everyone who helped make it such a great year for the GalliumOS Project!

Thank you for contributing, answering questions on Reddit and IRC, ''asking'' questions on Reddit and IRC, researching configuration tweaks, testing new builds, and reporting successes and failures.

We're looking forward to more in 2017, and hope you'll join us for the ride!

We have some announcements as well as some statistics for the past year.

== Stickers and T-Shirts ==

<gallery mode="traditional">
Image:stickerClear.png| 1.5" square clear sticker
Image:stickerWhite.png| 1x4" white sticker
Image:shirt.png| Blue unisex tee
Image:womens tee.png| Blue women's tee
</gallery>

We will be sending GalliumOS stickers to PayPal contributors in 2017. Be sure to include a mailing address with your [https://galliumos.org/donate PayPal donation], and we'll send you two stickers (one of each). If you've already donated in 2017, thank you! -- and check your email for one from us requesting your mailing address. If you would like to contribute, but do '''not''' want stickers, just let us know.

We also have [https://teespring.com/galliumos shirts available] for a limited time through Teespring. They have the logo with "GalliumOS" on the front in your choice of blue, black, or gray, in unisex or women's. The campaign will run for two weeks, from January 23rd to February 7th. T-shirt pricing is set to cover our costs to Teespring and will not be a significant source of funds for the Project.

EDIT: It's come to our attention that Teespring will be discontinuing the color of blue we're using for our shirts. If you really want a shirt in that particular blue, now might be the only time.

== 2016 in Numbers ==

=== GalliumOS ISO Downloads and Installs ===

GalliumOS downloads are available from [https://galliumos.org/download primary] and [https://galliumos.org/releases/MIRRORS mirror] sites. You can also download through [https://galliumos.org/download BitTorrent].

Installation instructions and options are documented on the [https://wiki.galliumos.org/Installing GalliumOS wiki].

{| class="wikitable"
|-
| '''45,194'''
| ISO Downloads:<br>
{| class="wikitable"
| style="text-align:right;" | 19,088
| Haswell
|-
| style="text-align:right;" | 7,834
| Broadwell
|-
| style="text-align:right;" | 14,249
| Bay Trail
|-
| style="text-align:right;" | 3,556
| Sandy/Ivy Bridge
|-
| style="text-align:right;" | 399
| Braswell
|-
| style="text-align:right;" | 33
| Skylake
|-
| style="text-align:right;" | 36
| Samus
|}
|-
| '''16,344'''
| chrx installs
|}

=== Web Statistics ===

GalliumOS documentation and support is provided through our [https://galliumos.org website], our [https://wiki.galliumos.org wiki], the GalliumOS [https://reddit.com/r/GalliumOS subreddit], and [https://galliumos.org/irc IRC]. Please join us in any of those places if you have any questions or would like to help work on GalliumOS!

{| class="wikitable"
!
! Unique users, monthly
! Page views, monthly
! Data transfer, monthly
|-
| [https://galliumos.org/ galliumos.org]
| style="text-align:right;" | 20,811
| style="text-align:right;" | 66,792
| style="text-align:right;" | 2343 GB
|-
| [https://reddit.com/r/GalliumOS Reddit]
| style="text-align:right;" | 5,581
| style="text-align:right;" | 20,477
|}

=== Finances ===

'''Thank You''' to everyone who contributed in 2016!

We will be sending GalliumOS stickers to all contributors in 2017! Be sure to include your shipping address when you [https://galliumos.org/donate contribute through Paypal]!

{| class="wikitable"
|-
| style="text-align:right;" | '''$89.76'''
| Account balance, starting 2016
|-
| style="text-align:right;" | '''193'''
| Contributions
|-
| style="text-align:right;" | '''$3850.01'''
| Total contributions
|-
| '''($3198.08)'''
| Expenses:<br>
{| class="wikitable"
| style="text-align:right;" | $182.21
|PayPal fees
|-
| style="text-align:right;" | $657.41
|Hosting for web/download/build servers
|-
| style="text-align:right;" | $1478.41
|Hardware for test and development<br>(GNAWTYx2, BANJO, CYAN, EDGAR, LARS, TERRA, SENTRY)
|-
| style="text-align:right;" | $87.53
|Other (domain renewals, shipping costs, etc)
|-
| style="text-align:right;" | $100.00
|Donation to the Numix Project
|-
| style="text-align:right;" | $133.00
|GalliumOS promotional stickers
|-
| style="text-align:right;" | $559.52
|Taxes, estimated
|}
|-
| style="text-align:right;" | '''$741.69'''
| Account balance, ending 2016
|}

== GalliumOS 2.1 ==

GalliumOS 2.1 is nearing release. We'll be making a separate announcement soon. The 2.1 release will include support for UEFI booting, as well as audio for most Braswell models, and package updates for all. Nightly images are available now.

== Discuss ==

Discuss this post on [https://redd.it/5pq3kg Reddit].

== Thank You! ==

- The GalliumOS Team, 20170120

News/2016 Annual Report and Announcement

2017-01-23T17:03:12Z

Dvdmuckle: synced campaign length

== GalliumOS Project, 2016 ==

As we close the books on our first full year of operations, we'd like to thank everyone who helped make it such a great year for the GalliumOS Project!

Thank you for contributing, answering questions on Reddit and IRC, ''asking'' questions on Reddit and IRC, researching configuration tweaks, testing new builds, and reporting successes and failures.

We're looking forward to more in 2017, and hope you'll join us for the ride!

We have some announcements as well as some statistics for the past year.

== Stickers and T-Shirts ==

<gallery mode="traditional">
Image:stickerClear.png| 1.5" square clear sticker
Image:stickerWhite.png| 1x4" white sticker
Image:shirt.png| Blue unisex tee
Image:womens tee.png| Blue women's tee
</gallery>

We will be sending GalliumOS stickers to PayPal contributors in 2017. Be sure to include a mailing address with your [https://galliumos.org/donate PayPal donation], and we'll send you two stickers (one of each). If you've already donated in 2017, thank you! -- and check your email for one from us requesting your mailing address. If you would like to contribute, but do '''not''' want stickers, just let us know.

We also have [https://teespring.com/galliumos shirts available] for a limited time through Teespring. They have the logo with "GalliumOS" on the front in your choice of blue, black, or gray, in unisex or women's. The campaign will run for two weeks, from January 23rd to February 7th. T-shirt pricing is set to cover our costs to Teespring and will not be a significant source of funds for the Project.

== 2016 in Numbers ==

=== GalliumOS ISO Downloads and Installs ===

GalliumOS downloads are available from [https://galliumos.org/download primary] and [https://galliumos.org/releases/MIRRORS mirror] sites. You can also download through [https://galliumos.org/download BitTorrent].

Installation instructions and options are documented on the [https://wiki.galliumos.org/Installing GalliumOS wiki].

{| class="wikitable"
|-
| '''45,194'''
| ISO Downloads:<br>
{| class="wikitable"
| style="text-align:right;" | 19,088
| Haswell
|-
| style="text-align:right;" | 7,834
| Broadwell
|-
| style="text-align:right;" | 14,249
| Bay Trail
|-
| style="text-align:right;" | 3,556
| Sandy/Ivy Bridge
|-
| style="text-align:right;" | 399
| Braswell
|-
| style="text-align:right;" | 33
| Skylake
|-
| style="text-align:right;" | 36
| Samus
|}
|-
| '''16,344'''
| chrx installs
|}

=== Web Statistics ===

GalliumOS documentation and support is provided through our [https://galliumos.org website], our [https://wiki.galliumos.org wiki], the GalliumOS [https://reddit.com/r/GalliumOS subreddit], and [https://galliumos.org/irc IRC]. Please join us in any of those places if you have any questions or would like to help work on GalliumOS!

{| class="wikitable"
!
! Unique users, monthly
! Page views, monthly
! Data transfer, monthly
|-
| [https://galliumos.org/ galliumos.org]
| style="text-align:right;" | 20,811
| style="text-align:right;" | 66,792
| style="text-align:right;" | 2343 GB
|-
| [https://reddit.com/r/GalliumOS Reddit]
| style="text-align:right;" | 5,581
| style="text-align:right;" | 20,477
|}

=== Finances ===

'''Thank You''' to everyone who contributed in 2016!

We will be sending GalliumOS stickers to all contributors in 2017! Be sure to include your shipping address when you [https://galliumos.org/donate contribute through Paypal]!

{| class="wikitable"
|-
| style="text-align:right;" | '''$89.76'''
| Account balance, starting 2016
|-
| style="text-align:right;" | '''193'''
| Contributions
|-
| style="text-align:right;" | '''$3850.01'''
| Total contributions
|-
| '''($3198.08)'''
| Expenses:<br>
{| class="wikitable"
| style="text-align:right;" | $182.21
|PayPal fees
|-
| style="text-align:right;" | $657.41
|Hosting for web/download/build servers
|-
| style="text-align:right;" | $1478.41
|Hardware for test and development<br>(GNAWTYx2, BANJO, CYAN, EDGAR, LARS, TERRA, SENTRY)
|-
| style="text-align:right;" | $87.53
|Other (domain renewals, shipping costs, etc)
|-
| style="text-align:right;" | $100.00
|Donation to the Numix Project
|-
| style="text-align:right;" | $133.00
|GalliumOS promotional stickers
|-
| style="text-align:right;" | $559.52
|Taxes, estimated
|}
|-
| style="text-align:right;" | '''$741.69'''
| Account balance, ending 2016
|}

== GalliumOS 2.1 ==

GalliumOS 2.1 is nearing release. We'll be making a separate announcement soon. The 2.1 release will include support for UEFI booting, as well as audio for most Braswell models, and package updates for all. Nightly images are available now.

== Thank You! ==

- The GalliumOS Team, 20170120

File:Womens tee.png

2017-01-23T16:48:32Z

Dvdmuckle: Dvdmuckle uploaded a new version of File:Womens tee.png

reup

News/2016 Annual Report and Announcement

2017-01-21T23:08:55Z

Dvdmuckle: updated campaign date to projected run time

== GalliumOS Project, 2016 ==

As we close the books on our first full year of operations, we'd like to thank everyone who helped make it such a great year for the GalliumOS Project!

Thank you for contributing, answering questions on Reddit and IRC, ''asking'' questions on Reddit and IRC, researching configuration tweaks, testing new builds, and reporting successes and failures.

We're looking forward to more in 2017, and hope you'll join us for the ride!

We have some announcements as well as some statistics for the past year.

== Shirts and Stickers ==

<gallery mode="traditional">
Image:stickerClear.png| 1.5" square clear sticker
Image:stickerWhite.png| 1x4" white sticker
Image:shirt.png| Blue unisex shirt
</gallery>

We now have stickers available to people that donate through PayPal for this year. They come in two varieties. If you'd like stickers, please send a mailing address with your PayPal donation. To donate, please go to [https://galliumos.org/donate our donation page.] Each mailing address sent with a donation will receive one of each variety of sticker.

We also have [https://teespring.com/galliumos shirts available] for a limited time through Teespring. They have the logo with "GalliumOS" on the front in your choice of blue, black, or gray, in unisex or women's. The campaign will run for two weeks, from January 23rd to February 6th. If you miss your chance to purchase a shirt, don't worry, we will run the campaign again another time. We have made the shirts as inexpensive as possible, and any proceeds that we receive will be put into the donation pool.

== 2016 in Numbers ==

=== GalliumOS ISO Downloads and Installs ===

GalliumOS downloads are available from [https://galliumos.org/download primary] and [https://galliumos.org/releases/MIRRORS mirror] sites. You can also download through [https://galliumos.org/download BitTorrent].

Installation instructions and options are documented on the [https://wiki.galliumos.org/Installing GalliumOS wiki].

{| class="wikitable"
|-
| '''45,194'''
| ISO Downloads:<br>
{| class="wikitable"
| style="text-align:right;" | 19,088
| Haswell
|-
| style="text-align:right;" | 7,834
| Broadwell
|-
| style="text-align:right;" | 14,249
| Bay Trail
|-
| style="text-align:right;" | 3,556
| Sandy/Ivy Bridge
|-
| style="text-align:right;" | 399
| Braswell
|-
| style="text-align:right;" | 33
| Skylake
|-
| style="text-align:right;" | 36
| Samus
|}
|-
| '''16,344'''
| chrx installs
|}

=== Web Statistics ===

GalliumOS documentation and support is provided through our [https://galliumos.org website], our [https://wiki.galliumos.org wiki], the GalliumOS [https://reddit.com/r/GalliumOS subreddit], and [https://galliumos.org/irc IRC]. Please join us in any of those places if you have any questions or would like to help work on GalliumOS!

{| class="wikitable"
!
! Unique users, monthly
! Page views, monthly
! Data transfer, monthly
|-
| [https://galliumos.org/ galliumos.org]
| style="text-align:right;" | 20,811
| style="text-align:right;" | 66,792
| style="text-align:right;" | 2343 GB
|-
| [https://reddit.com/r/GalliumOS Reddit]
| style="text-align:right;" | 5,581
| style="text-align:right;" | 20,477
|}

=== Finances ===

'''Thank You''' to everyone who contributed in 2016!

We will be sending GalliumOS stickers to all contributors in 2017! Be sure to include your shipping address when you [https://galliumos.org/donate contribute through Paypal]!

{| class="wikitable"
|-
| style="text-align:right;" | '''$89.76'''
| Account balance, starting 2016
|-
| style="text-align:right;" | '''193'''
| Contributions
|-
| style="text-align:right;" | '''$3850.01'''
| Total contributions
|-
| '''($3198.08)'''
| Expenses:<br>
{| class="wikitable"
| style="text-align:right;" | $182.21
|PayPal fees
|-
| style="text-align:right;" | $657.41
|Hosting for web/download/build servers
|-
| style="text-align:right;" | $1478.41
|Hardware for test and development<br>(GNAWTYx2, BANJO, CYAN, EDGAR, LARS, TERRA, SENTRY)
|-
| style="text-align:right;" | $87.53
|Other (domain renewals, shipping costs, etc)
|-
| style="text-align:right;" | $100.00
|Donation to the Numix Project
|-
| style="text-align:right;" | $133.00
|GalliumOS promotional stickers
|-
| style="text-align:right;" | $559.52
|Taxes, estimated
|}
|-
| style="text-align:right;" | '''$741.69'''
| Account balance, ending 2016
|}

== GalliumOS 2.1 ==

GalliumOS 2.1 is nearing release. We'll be making a separate announcement soon. The 2.1 release will include support for UEFI booting, as well as audio for most Braswell models, and package updates for all. Nightly images are available now.

== Thank You! ==

- The GalliumOS Team, 20170120

News/2016 Annual Report and Announcement

2017-01-18T19:30:34Z

Dvdmuckle:

== GalliumOS Project, 2016 ==

As we close the books on our first full year of operations, we'd like to thank everyone who helped make it such a great year for the GalliumOS Project!

Thank you for contributing, answering questions on Reddit and IRC, ''asking'' questions on Reddit and IRC, researching configuration tweaks, testing new builds, and reporting successes and failures.

We're looking forward to more in 2017, and hope you'll join us for the ride!

We have some announcements as well as some statistics for the past year.

== Shirts and Stickers ==

<gallery mode="traditional">
Image:stickerClear.png| Clear with just the logo
Image:stickerWhite.png| White with the logo and "GalliumOS"
Image:shirt.png| Blue unisex shirt with logo and "GalliumOS"
</gallery>

We now have stickers available to people that donate through PayPal for this year. They come in two varieties. If you'd like stickers, please send a mailing address with your PayPal donation. To donate, please go to [https://galliumos.org/donate our donation page.]

We also have [https://teespring.com/galliumos shirts available] for a limited time through Teespring. They have the logo with "GalliumOS" on the front in your choice of blue, black, or gray, in unisex or women's. The campaign will run for two weeks, from January 18th to February 1st. If you miss your chance to purchase a shirt, don't worry, we will run the campaign again another time.

== 2016 in Numbers ==

=== Global Domination, Progress Toward ===

{| class="wikitable"
|-
| '''45,194'''
| ISO Downloads:<br>
{| class="wikitable"
| style="text-align:right;" | 19,088
| Haswell
|-
| style="text-align:right;" | 7,834
| Broadwell
|-
| style="text-align:right;" | 14,249
| Bay Trail
|-
| style="text-align:right;" | 3,556
| Sandy/Ivy Bridge
|-
| style="text-align:right;" | 399
| Braswell
|-
| style="text-align:right;" | 33
| Skylake
|-
| style="text-align:right;" | 36
| Samus
|}
|-
| '''16,344'''
| chrx installs
|}

=== Web Statistics ===

==== galliumos.org ====

{| class="wikitable"
|-
| style="text-align:right;" | '''20,811'''
| Monthly unique users
|-
| style="text-align:right;" | '''66,792'''
| Monthly page views
|-
| style="text-align:right;" | '''2343 GB'''
| Monthly data transfer
|}

==== Reddit ====

{| class="wikitable"
|-
| style="text-align:right;" | '''5,581'''
| Monthly unique users
|-
| style="text-align:right;" | '''20,477'''
| Monthly page views
|}

=== Finances ===

{| class="wikitable"
|-
| style="text-align:right;" | '''$89.76'''
| Account balance, starting 2016
|-
| style="text-align:right;" | '''193'''
| Contributions
|-
| style="text-align:right;" | '''$3850.01'''
| Total contributions
|-
| '''$3198.08'''
| Expenses:<br>
{| class="wikitable"
| style="text-align:right;" | $182.21
|PayPal fees
|-
| style="text-align:right;" | $657.41
|Hosting for web/download/build servers
|-
| style="text-align:right;" | $1478.41
|Hardware for test and development<br>(GNAWTYx2, BANJO, CYAN, EDGAR, LARS, TERRA, SENTRY)
|-
| style="text-align:right;" | $87.53
|Other (domain renewals, shipping costs, etc)
|-
| style="text-align:right;" | $100.00
|Donation to the Numix Project
|-
| style="text-align:right;" | $133.00
|GalliumOS promotional stickers
|-
| style="text-align:right;" | $559.52
|Taxes, estimated
|}
|-
| style="text-align:right;" | '''$741.69'''
| Account balance, starting 2017
|}

== 2.1 Progress ==

Soon! We have functional UEFI multiboot images in testing, and audio is working on a couple of Braswell devices now. It's still a work in progress, and we appreciate all the help from testers and contributors alike.

== Thank You! ==

- The GalliumOS Team, 20170117

News/2016 Annual Report and Announcement

2017-01-18T18:53:36Z

Dvdmuckle: added campaign length

== GalliumOS Project, 2016 ==

As we close the books on our first full year of operations, we'd like to thank everyone who helped make it such a great year for the GalliumOS Project!

Thank you for contributing, answering questions on Reddit and IRC, ''asking'' questions on Reddit and IRC, researching configuration tweaks, testing new builds, and reporting successes and failures.

We're looking forward to more in 2017, and hope you'll join us for the ride!

We have some announcements as well as some statistics for the past year.

== Shirts and Stickers ==

<gallery mode="traditional">
Image:stickerClear.png| Clear with just the logo
Image:stickerWhite.png| White with the logo and "GalliumOS"
Image:shirt.png| Blue unisex shirt with logo and "GalliumOS"
</gallery>

We now have stickers available to people that donate through PayPal for this year. They come in two varieties. If you'd like stickers, please send a mailing address with your PayPal donation. If you'd like to donate, please go to [https://galliumos.org/donate our donation page.]

We also have [https://teespring.com/galliumos shirts available] for a limited time through Teespring. They have the logo with "GalliumOS" on the front in your choice of blue, black, or gray, in unisex or women's. The campaign will run for two weeks, from January 18th to February 1st. If you miss your chance to purchase a shirt, don't worry, we will run the campaign again another time.

== 2016 in Numbers ==

=== Global Domination, Progress Toward ===

{| class="wikitable"
|-
| '''45,194'''
| ISO Downloads:<br>
{| class="wikitable"
| style="text-align:right;" | 19,088
| Haswell
|-
| style="text-align:right;" | 7,834
| Broadwell
|-
| style="text-align:right;" | 14,249
| Bay Trail
|-
| style="text-align:right;" | 3,556
| Sandy/Ivy Bridge
|-
| style="text-align:right;" | 399
| Braswell
|-
| style="text-align:right;" | 33
| Skylake
|-
| style="text-align:right;" | 36
| Samus
|}
|-
| '''16,344'''
| chrx installs
|}

=== Web Statistics ===

==== galliumos.org ====

{| class="wikitable"
|-
| style="text-align:right;" | '''20,811'''
| Monthly unique users
|-
| style="text-align:right;" | '''66,792'''
| Monthly page views
|-
| style="text-align:right;" | '''2343 GB'''
| Monthly data transfer
|}

==== Reddit ====

{| class="wikitable"
|-
| style="text-align:right;" | '''5,581'''
| Monthly unique users
|-
| style="text-align:right;" | '''20,477'''
| Monthly page views
|}

=== Finances ===

{| class="wikitable"
|-
| style="text-align:right;" | '''$89.76'''
| Account balance, starting 2016
|-
| style="text-align:right;" | '''193'''
| Contributions
|-
| style="text-align:right;" | '''$3850.01'''
| Total contributions
|-
| '''$3198.08'''
| Expenses:<br>
{| class="wikitable"
| style="text-align:right;" | $182.21
|PayPal fees
|-
| style="text-align:right;" | $657.41
|Hosting for web/download/build servers
|-
| style="text-align:right;" | $1478.41
|Hardware for test and development<br>(GNAWTYx2, BANJO, CYAN, EDGAR, LARS, TERRA, SENTRY)
|-
| style="text-align:right;" | $87.53
|Other (domain renewals, shipping costs, etc)
|-
| style="text-align:right;" | $100.00
|Donation to the Numix Project
|-
| style="text-align:right;" | $133.00
|GalliumOS promotional stickers
|-
| style="text-align:right;" | $559.52
|Taxes, estimated
|}
|-
| style="text-align:right;" | '''$741.69'''
| Account balance, starting 2017
|}

== 2.1 Progress ==

Soon! We have functional UEFI multiboot images in testing, and audio is working on a couple of Braswell devices now. It's still a work in progress, and we appreciate all the help from testers and contributors alike.

== Thank You! ==

- The GalliumOS Team, 20170117

News/2016 Annual Report and Announcement

2017-01-18T18:00:13Z

Dvdmuckle: Dvdmuckle moved page News/2016 Annual Report & Announcement to News/2016 Annual Report and Announcement: changed from & to and

== GalliumOS Project, 2016 ==

As we close the books on our first full year of operations, we'd like to thank everyone who helped make it such a great year for the GalliumOS Project!

Thank you for contributing, answering questions on Reddit and IRC, ''asking'' questions on Reddit and IRC, researching configuration tweaks, testing new builds, and reporting successes and failures.

We're looking forward to more in 2017, and hope you'll join us for the ride!

We have some announcements as well as some statistics for the past year.

== Shirts and Stickers ==

<gallery mode="traditional">
Image:stickerClear.png| Clear with just the logo
Image:stickerWhite.png| White with the logo and "GalliumOS"
Image:shirt.png| Blue unisex shirt with logo and "GalliumOS"
</gallery>

We now have stickers available to people that donate through PayPal for this year. They come in two varieties. If you'd like stickers, please send a mailing address with your PayPal donation. If you'd like to donate, please go to [https://galliumos.org/donate our donation page.]

We also have [https://teespring.com/galliumos shirts available] for a limited time through Teespring. They have the logo with "GalliumOS" on the front in your choice of blue, black, or gray, in unisex or women's. If you miss your chance to purchase a shirt, don't worry, we will run the campaign again another time.

== 2016 in Numbers ==

=== Global Domination, Progress Toward ===

{| class="wikitable"
|-
| '''45,194'''
| ISO Downloads:<br>
{| class="wikitable"
| style="text-align:right;" | 19,088
| Haswell
|-
| style="text-align:right;" | 7,834
| Broadwell
|-
| style="text-align:right;" | 14,249
| Bay Trail
|-
| style="text-align:right;" | 3,556
| Sandy/Ivy Bridge
|-
| style="text-align:right;" | 399
| Braswell
|-
| style="text-align:right;" | 33
| Skylake
|-
| style="text-align:right;" | 36
| Samus
|}
|-
| '''16,344'''
| chrx installs
|}

=== Web Statistics ===

==== galliumos.org ====

{| class="wikitable"
|-
| style="text-align:right;" | '''20,811'''
| Monthly unique users
|-
| style="text-align:right;" | '''66,792'''
| Monthly page views
|-
| style="text-align:right;" | '''2343 GB'''
| Monthly data transfer
|}

==== Reddit ====

{| class="wikitable"
|-
| style="text-align:right;" | '''5,581'''
| Monthly unique users
|-
| style="text-align:right;" | '''20,477'''
| Monthly page views
|}

=== Finances ===

{| class="wikitable"
|-
| style="text-align:right;" | '''$89.76'''
| Account balance, starting 2016
|-
| style="text-align:right;" | '''193'''
| Contributions
|-
| style="text-align:right;" | '''$3850.01'''
| Total contributions
|-
| '''$3198.08'''
| Expenses:<br>
{| class="wikitable"
| style="text-align:right;" | $182.21
|PayPal fees
|-
| style="text-align:right;" | $657.41
|Hosting for web/download/build servers
|-
| style="text-align:right;" | $1478.41
|Hardware for test and development<br>(GNAWTYx2, BANJO, CYAN, EDGAR, LARS, TERRA, SENTRY)
|-
| style="text-align:right;" | $87.53
|Other (domain renewals, shipping costs, etc)
|-
| style="text-align:right;" | $100.00
|Donation to the Numix Project
|-
| style="text-align:right;" | $133.00
|GalliumOS promotional stickers
|-
| style="text-align:right;" | $559.52
|Taxes, estimated
|}
|-
| style="text-align:right;" | '''$741.69'''
| Account balance, starting 2017
|}

== 2.1 Progress ==

Soon! We have functional UEFI multiboot images in testing, and audio is working on a couple of Braswell devices now. It's still a work in progress, and we appreciate all the help from testers and contributors alike.

== Thank You! ==

- The GalliumOS Team, 20170117

News/2016 Annual Report & Announcement

2017-01-18T18:00:13Z

Dvdmuckle: Dvdmuckle moved page News/2016 Annual Report & Announcement to News/2016 Annual Report and Announcement: changed from & to and

#REDIRECT [[News/2016 Annual Report and Announcement]]

News/2016 Annual Report and Announcement

2017-01-18T17:59:19Z

Dvdmuckle: added mention of 2.1

== GalliumOS Project, 2016 ==

As we close the books on our first full year of operations, we'd like to thank everyone who helped make it such a great year for the GalliumOS Project!

Thank you for contributing, answering questions on Reddit and IRC, ''asking'' questions on Reddit and IRC, researching configuration tweaks, testing new builds, and reporting successes and failures.

We're looking forward to more in 2017, and hope you'll join us for the ride!

We have some announcements as well as some statistics for the past year.

== Shirts and Stickers ==

<gallery mode="traditional">
Image:stickerClear.png| Clear with just the logo
Image:stickerWhite.png| White with the logo and "GalliumOS"
Image:shirt.png| Blue unisex shirt with logo and "GalliumOS"
</gallery>

We now have stickers available to people that donate through PayPal for this year. They come in two varieties. If you'd like stickers, please send a mailing address with your PayPal donation. If you'd like to donate, please go to [https://galliumos.org/donate our donation page.]

We also have [https://teespring.com/galliumos shirts available] for a limited time through Teespring. They have the logo with "GalliumOS" on the front in your choice of blue, black, or gray, in unisex or women's. If you miss your chance to purchase a shirt, don't worry, we will run the campaign again another time.

== 2016 in Numbers ==

=== Global Domination, Progress Toward ===

{| class="wikitable"
|-
| '''45,194'''
| ISO Downloads:<br>
{| class="wikitable"
| style="text-align:right;" | 19,088
| Haswell
|-
| style="text-align:right;" | 7,834
| Broadwell
|-
| style="text-align:right;" | 14,249
| Bay Trail
|-
| style="text-align:right;" | 3,556
| Sandy/Ivy Bridge
|-
| style="text-align:right;" | 399
| Braswell
|-
| style="text-align:right;" | 33
| Skylake
|-
| style="text-align:right;" | 36
| Samus
|}
|-
| '''16,344'''
| chrx installs
|}

=== Web Statistics ===

==== galliumos.org ====

{| class="wikitable"
|-
| style="text-align:right;" | '''20,811'''
| Monthly unique users
|-
| style="text-align:right;" | '''66,792'''
| Monthly page views
|-
| style="text-align:right;" | '''2343 GB'''
| Monthly data transfer
|}

==== Reddit ====

{| class="wikitable"
|-
| style="text-align:right;" | '''5,581'''
| Monthly unique users
|-
| style="text-align:right;" | '''20,477'''
| Monthly page views
|}

=== Finances ===

{| class="wikitable"
|-
| style="text-align:right;" | '''$89.76'''
| Account balance, starting 2016
|-
| style="text-align:right;" | '''193'''
| Contributions
|-
| style="text-align:right;" | '''$3850.01'''
| Total contributions
|-
| '''$3198.08'''
| Expenses:<br>
{| class="wikitable"
| style="text-align:right;" | $182.21
|PayPal fees
|-
| style="text-align:right;" | $657.41
|Hosting for web/download/build servers
|-
| style="text-align:right;" | $1478.41
|Hardware for test and development<br>(GNAWTYx2, BANJO, CYAN, EDGAR, LARS, TERRA, SENTRY)
|-
| style="text-align:right;" | $87.53
|Other (domain renewals, shipping costs, etc)
|-
| style="text-align:right;" | $100.00
|Donation to the Numix Project
|-
| style="text-align:right;" | $133.00
|GalliumOS promotional stickers
|-
| style="text-align:right;" | $559.52
|Taxes, estimated
|}
|-
| style="text-align:right;" | '''$741.69'''
| Account balance, starting 2017
|}

== 2.1 Progress ==

Soon! We have functional UEFI multiboot images in testing, and audio is working on a couple of Braswell devices now. It's still a work in progress, and we appreciate all the help from testers and contributors alike.

== Thank You! ==

- The GalliumOS Team, 20170117

News/2016 Annual Report and Announcement

2017-01-18T17:52:56Z

Dvdmuckle: /* Shirts and Stickers */

News/2016 Annual Report and Announcement

2017-01-18T17:17:06Z

Dvdmuckle: Dvdmuckle moved page News/2016 Annual Report to News/2016 Annual Report & Announcement: added shirts and stickers announcement

News/2016 Annual Report

2017-01-18T17:17:06Z

Dvdmuckle: Dvdmuckle moved page News/2016 Annual Report to News/2016 Annual Report & Announcement: added shirts and stickers announcement

#REDIRECT [[News/2016 Annual Report & Announcement]]

News/2016 Annual Report and Announcement

2017-01-18T16:12:15Z

Dvdmuckle: moved and organized pictures

News/2016 Annual Report and Announcement

2017-01-18T05:35:35Z

Dvdmuckle: added shirt picture

File:Shirt.png

2017-01-18T05:34:09Z

Dvdmuckle:

News/2016 Annual Report and Announcement

2017-01-18T05:29:05Z

Dvdmuckle:

News/2016 Annual Report and Announcement

2017-01-18T05:23:25Z

Dvdmuckle:

File:StickerWhite.png

2017-01-18T05:19:47Z

Dvdmuckle:

File:StickerClear.png

2017-01-18T05:18:48Z

Dvdmuckle:

News/2016 Annual Report and Announcement

2017-01-18T05:15:58Z

Dvdmuckle: shirts and stickers

Additional Software

2016-12-06T05:38:50Z

Dvdmuckle: /* Skype */

GalliumOS comes with a good selection of desktop and utility software, but there is a huge variety of additional options and alternatives.

GalliumOS can install any software packages built for Ubuntu, directly from the Canonical package servers.

There are also some frequently-requested applications that are not available from Canonical, or are more complicated to install. A few are listed here. Please add more!

== Desktop ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb
</pre>



=== Adobe Flash ===

Adobe Flash apps (and Twitch streams, etc) require Adobe Flash Player, which is not included by default in GalliumOS.

* Install adobe-flashplugin from Canonical's <code>partner</code> repository.
<pre style="margin:0 0 0 2em; padding:0.4em;">
sudo add-apt-repository "deb http://archive.canonical.com/ubuntu $(lsb_release -sc) partner"
sudo apt-get update
sudo apt-get install adobe-flashplugin
</pre>
* Confirm installation by entering <code>chrome://plugins</code> (Chromium) or <code>about:plugins</code> (Firefox) into the URL bar

The proprietary version of Google Chrome includes PepperFlash, and does not require an additional plugin.

=== Firefox Aurora ===

Aurora is the '''developer preview''' of Firefox.

The '''stable''' version of Firefox can be installed from the standard Canonical repositories with <code>sudo apt install firefox</code>.

More info: https://launchpad.net/~ubuntu-mozilla-daily/+archive/ubuntu/firefox-aurora

=== Pale Moon ===

Pale Moon is a web browser, originally derived from Firefox, and optimized for performance.

* Official site: http://linux.palemoon.org/
* Installation: https://software.opensuse.org/download.html?project=home%3Astevenpusser&package=palemoon
** (Follow instructions for Ubuntu)

=== TeamViewer ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
curl -OL http://download.teamviewer.com/download/teamviewer_i386.deb
sudo dpkg -i teamviewer_i386.deb
</pre>

=== Google Drive integration ===

<p style="background-color:#ffaaaa;padding:0.2em 0.5em">NOTE: Instructions need update for GalliumOS 2.0. Error reported when adding user to <code>fuse</code> group.</p>

* Install the software
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:alessandro-strada/ppa
sudo apt-get update
sudo apt-get install google-drive-ocamlfuse
</pre>

* Next, add yourself to the Linux group ''fuse'' so you can mount Google Drive without root.
<pre style="margin:0 0 0 1.5em">
sudo usermod -a -G fuse <user_name>
exec su -l $USER
</pre>

* Run google-drive-ocamlfuse for first time setup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse
</pre>

You'll get a browser window asking you to sign in to your Google account and if you want to give gdfuse OAuth2 Endpoint permission to access your Drive files. Hit Accept / Allow for any following dialog. Close the browser window.

* Next, create a directory where your Google Drive files will be mounted, preferably in your home directory, and mount Google Drive to that directory.
<pre style="margin:0 0 0 1.5em">
mkdir ~/googledrive
google-drive-ocamlfuse ~/googledrive
</pre>

You can check if Google Drive is mounted by performing:
<pre style="margin:0 0 0 1.5em">
mount
</pre>

You can also check how much space you have left:
<pre style="margin:0 0 0 1.5em">
df
</pre>

If you want to unmount, simply run
<pre style="margin:0 0 0 1.5em">
fusermount -u ~/googledrive
</pre>

* To mount Google Drive at startup, set the following command to run at boot with Session and Startup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse -label default /home/<user>/googledrive
</pre>

A word of warning, large files such as movies or large videos don't work too well with google-drive-ocamlfuse using default settings. Files are cached to ~/.gdfuse/default/cache. A config file can be found in the directory above that, with parameters to allow for streaming larger files, cache size, etc.. The streaming larger files parameter is perfect for large videos and movies. For more information, check out gdfuse on GitHub.

Adapted from: http://xmodulo.com/mount-google-drive-linux.html

=== Skype ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository "deb http://archive.canonical.com/ $(lsb_release -sc) partner"
sudo apt-get update && sudo apt-get install skype
</pre>

'''NOTE''' This is the older version of Skype, if you're looking for the newer Skype for Linux Alpha, please see here: https://community.skype.com/t5/Linux/Skype-for-Linux-Alpha-and-calling-on-Chrome-amp-Chromebooks/td-p/4434299

Source: https://help.ubuntu.com/community/Skype

See also: https://www.skype.com/en/download-skype/skype-for-linux/

=== Wine ===

Wine has been a source of frustration. These instructions are verified on a fresh install of 2.0.

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository ppa:ubuntu-wine/ppa
sudo apt-get update
sudo apt-get install wine1.8
</pre>

=== Simple Screen Recorder ===
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository -y ppa:maarten-baert/simplescreenrecorder
sudo apt-get update
sudo apt-get install simplescreenrecorder
</pre>

=== Spotify ===

<pre style="margin:0 0 0 1.5em">
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys BBEBDCB318AD50EC6865090613B00F1FD2C19886
echo deb http://repository.spotify.com stable non-free | sudo tee /etc/apt/sources.list.d/spotify.list
sudo apt-get update
sudo apt-get install spotify-client
</pre>

Source: https://www.spotify.com/us/download/linux/

=== Kodi Media Center ===

<pre style="margin:0 0 0 1.5em">
sudo apt-get install python-software-properties pkg-config software-properties-common
sudo add-apt-repository -y ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi
</pre>

== Games ==

=== Steam ===
<pre style="margin:0 0 0 1.5em">
curl -O http://repo.steampowered.com/steam/archive/precise/steam_latest.deb
sudo dpkg -i steam_latest.deb
</pre>

Then launch Steam from the application launcher. Your user must be in the "sudo" group (if it is not, the dpkg command above will also fail), so that the installer can do all the things it needs to do.

=== Minecraft ===
<pre style="margin:0 0 0 1.5em">
sudo bash
apt-get install default-jre
curl -o /usr/local/bin/Minecraft.jar https://s3.amazonaws.com/Minecraft.Download/launcher/Minecraft.jar
curl -o /usr/share/pixmaps/minecraft.png https://chrx.org/minecraft.png
mkdir -p /usr/local/share/applications
cat > /usr/local/share/applications/minecraft.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Minecraft
Comment=Minecraft
Exec=java -jar /usr/local/bin/Minecraft.jar
Icon=/usr/share/pixmaps/minecraft.png
Categories=Game;
EOF
</pre>

== Utilities ==

=== grsync ===
Graphical lightweight version of rsync to back up data between drives
<pre style="margin:0 0 0 1.5em">
sudo apt-get install grsync
</pre>

=== aptik ===
Backup APT sources/repository data
<pre style="margin:0 0 0 1.5em">
sudo apt-add-repository -y ppa:teejee2008/ppa
sudo apt-get update
sudo apt-get install aptik
</pre>

=== OpenVPN ===
Install the following two packages to get OpenVPN connectivity with your favorite VPN service.
<pre style="margin:0 0 0 1.5em">
sudo apt-get install openvpn network-manager-openvpn
</pre>

=== caffeine-plus ===
Used to keep the screen awake with full screen applications such as full screen video.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:nilarimogard/webupd8
sudo apt-get update
sudo apt-get install caffeine-plus
</pre>
Source: [http://www.webupd8.org/2014/08/screensaver-lock-screen-inhibitor.html Webupd8]

== Hardware Optimization ==

=== Battery Tuning ===

==== Powertop ====
Monitor process and device power consumption. Includes a handy auto-tune option which can be run at startup that helps to minimize power consumption. Powertop also provides a calibration option, which some people have reported issues with (locks up device?).

<pre style="margin:0 0 0 1.5em">
sudo apt-get install powertop
sudo powertop
</pre>

Powertop needs to be run every time the system boots. Expand for instructions:

<div class="mw-collapsible mw-collapsed" style="border:1px #666666 dashed;padding:0.5em 1em;min-height:2em;margin:0 2em;background-color:#eee;">

Create <code>/etc/systemd/system/powertop.service</code> with the following content:

<pre style="margin:0 0 0 1.5em">
[Unit]
Description=Powertop tunings

[Service]
Type=oneshot
ExecStart=/usr/sbin/powertop --auto-tune

[Install]
WantedBy=multi-user.target
</pre>

Then reboot.

Source: https://wiki.archlinux.org/index.php/Powertop
</div>

==== TLP ====

Advanced power management tool that also provides a default configuration optimized for battery life for "install and forget it" benefits. TLP has reportedly provided some improvement to battery life. Your mileage may vary.

<pre style="margin:0 0 0 1.5em">sudo add-apt-repository ppa:linrunner/tlp
sudo apt-get install tlp
sudo tlp start</pre>

== Miscellaneous ==

These have been discussed, but are not presently candidates for inclusion in the default installation. They might be of special interest, might have important caveats, or might be the unchosen of other options. Presented here for convenience.

==== Hardware temperature monitor ====
* <code>xfce4-sensors-plugin</code> from Ubuntu repositories. '''WARNING:''' Do '''not''' select <code>tachos</code>. It will crash your desktop.

==== Clipboard Manager ====
* <code>clipit</code> from Ubuntu repositories. Developer homepage is missing. Be conscious of the security implications of all clipboard managers.

==== Video Player ====
* https://mpv.io/ Lightweight, but very minimal UI
* <code>smplayer</code> from Ubuntu repositories. Lightweight.

==== Screen Recorder ====
* <code>OBS</code> from PPA. One of the most popular screen recording tools. See https://obsproject.com/ for more info.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:obsproject/obs-studio
sudo apt-get update
sudo apt-get install obs-studio
</pre>
* <code>kazam</code> from Ubuntu repositories. Alternative to <code>simplescreenrecorder</code>, above. See https://apps.ubuntu.com/cat/applications/kazam/ for more info.

==== Disk Usage/Performance Indicators ====
* <code>xfce4-goodies</code> from Ubuntu repositories includes a free space checker applet
* <code>xfce4-diskperf-plugin</code> from Ubuntu repositories is a disk performance monitor applet, and shows usage as well

Installing/New To Linux

2016-10-29T21:44:52Z

Dvdmuckle: warning under restoring stock firmware section

= Tutorial: How to install GalliumOS on a Chromebook =

== Objective of this Tutorial ==
This Tutorial is aimed at people with limited or zero computer programming experience who wish to install Linux GalliumOS on their Chromebook. It is a step-by-step recipe that requires no knowledge in computer programming. Its scope is limited in that it doesn't intend to show you how to install any Linux distribution but only GalliumOS. Furthermore, the user should not attempt to install GalliumOS on a Chromebook that IS NOT on the GalliumOS Hardware Compatibility List. (See below in "Things to check first").

GalliumOS is one of the numerous Linux "distributions". A Linux distribution is a set of software packages with an installation program that allows the user not only to access his or her computer with Linux Operating System (OS) but also to complete most of the tasks that an average user is expected to do with computers (word, presentation and spreadsheet processing, audio and video playing and editing, Internet browsing, e-mailing, etc.). In that respect, it differs from "commercial" operating systems that don't provide much besides access to the computer system. Linux is the most advanced operating system in the world: as of November 2015, 494 or 98.8% of the 500 world's fastest supercomputers use the Linux kernel. (See [[wikipedia:TOP500|https://en.wikipedia.org/wiki/TOP500]])

GalliumOS is different from other Linux distributions in that it is designed for Chromebooks. But then, why would you want Linux on your Chromebook?

== Why Install Linux on a Chromebook ==
Chromebooks are lean and mean computing machines that are designed to work in conjunction with the Internet. A Chromebook "keeps" hardly any software on its internal drive; what the user needs to complete a task is downloaded from Internet - often for a price - and is not kept inside the computer when the task is done. This is why most Chromebooks are equipped with a very small solid-state drive (SSD), typically 16 or 32 gigabits (GB). Often, this SSD is not upgradable and most of the time, the random-acess memory (RAM) is not upgradable either: Chromebooks' SSD and RAM are frequently hard-wired to the motherboard. With Linux installed on a Chromebook, applications stay inside the computer and can be accessed any time, with or without Internet.

The often talked about constraint about installing Linux on a Chromebook is the SSD size. This SHOULD NOT be a deterrent when installing Linux. 16 GB is plenty to install GalliumOS; all your music, photos, videos and other paraphernalia that don’t fit on the static drive can go to an external drive. On all Chromebooks, you have the luxury of at least three ports: two USB and one SD. Without spending much, you could have at any given time 768 GB of memory on your Chromebook with three 256 GB external drives! Even a Thunderbird mail profile, for instance, can sit on an external drive without any significant speed penalty. All your Linux OS and programs can sit nicely on the 16 GB internal drive with room to spare.

Furthermore, quite a few Chromebooks now can be upgraded with a larger capacity static drive. For a little investment, you could end up with a powerful laptop for a fraction of the price that you would normally pay for something other than a Chromebook.

== Things to check first ==
You probably don’t want to venture into uncharted territory, so you need to do a few checks before you start converting your Chromebook computer to a GalliumOS Linux machine. There are many benefits with using Linux, notably the ability to run thousands of excellent applications without ever accessing the Net, but you have to be reasonably certain that your Chromebook will allow you to do that. The first place to find out whether your Chromebook is supported for a GalliumOS install is: https://wiki.galliumos.org/Hardware_Compatibility

Here are a few explanations about this table:

'''<u>Model</u>''': The basic idea is that it is not advisable to attempt a GalliumOS install unless your Chromebook Model is listed in this table.

'''<u>Hardware ID</u>''': The Hardware ID is something that you will read in your Chromebook when you create a Recovery Media for your specific model (see below). This is valuable information; '''write it down!'''

'''<u>Processor Name</u>''': The Processor name (Sandy/Ivy Bridge, Bay Trail, Haswell, Broadwell, etc.) is something else you will need when you select the GalliumOS version you have to download. See: https://galliumos.org/download.html

'''<u>Supports GalliumOS</u>''': Better be safe than sorry! Make sure that your Chromebook is supported by GalliumOS.

'''<u>Firmware</u>''': That is one of the crucial changes that may, or may not, be required to make your Chromebook a GalliumOS Linux machine. The firmware modification requirement is indicated in the column titled “…with custom firmware?”. Fortunately, this firmware change is a fairly straightforward operation thanks to the work of John Lewis. Basically, it boils down to opening a terminal page in Chrome on your Chromebook (we will get to that) and writing, or copying and pasting, a short script.

('''NOTE''': Although there is still the possibility to dual-boot (GalliumOS and ChromeOS), this is not discussed here as it is assumed that the user has a limited, small static drive on which space doesn’t really allow two Operating Systems. In this tutorial, we will dedicate the entire drive space to Linux.)

I '''<u>strongly suggest</u>''' that you '''<u>note</u>''' all the data regarding the Model name, Hardware ID, Processor Name and Firmware modification requirement specific to your Chromebook. You will need it later.

Now that you have determined that you can give yourself the go-ahead for a GalliumOS installation on your Chromebook, let’s do first a little bit of house-cleaning and preparation.

== Backup ==
You may have a few files on your Chromebook drive that you wish to keep. You should transfer all those files onto an USB flash drive or an SD drive. Remember that everything on your drive is going to be wiped out when you install GalliumOS Linux.

== Chromebook Recovery Media ==
You need to create a Chromebook Recovery Media in case, further down the road, you wish to return your Chromebook to its original state. (See at the end of this Tutorial "Back to ChromeOS".) To do that, you need to download the Chromebook Recovery Utility from the Google Web Store (it is in your ChromeOS Menu). Once downloaded, the Recovery icon will also be in your ChromeOS Menu.
[[File:Recovery-icon-02.jpg|centre|frameless|Recovery Icon in ChromeOS Menu|649x649px]]

This software allows you to create a recovery media for your Chromebook. You need a 4GB USB flash drive or SD card that does not contain data that you want to keep because this drive too is going to be totally erased to receive the recovery data.

Once the Recovery icon is in your Chromebook Launcher, click on it to start the Recovery Media creation process. Go past the first page by clicking on "Get started" to access the next page titled “Identify your Chromebook”. This page contains '''important information''' regarding your specific Chromebook model number.
[[File:Identify-Chromebook.jpg|centre|thumb|604x604px|Your Chromebook Identity]]

There is a line that states: “For this Chromebook, enter XYZ XXX-XXX-XXX-XXX”.

'''<u>Write down</u>''' the MODEL NUMBER for YOUR Chromebook. It could be something like:

GNAWTY C2C-E3N-A2M

YUNA D21-A3B-L4A-A35

YUNA D25-B3B-B4A-A4M, etc.

Everything is important in this number, so keep it in a safe place; add it to the other info you already wrote down (Model, Hardware ID, Processor, firmware required, etc.). The first word could be something like: BANJO, CANDY, FALCO, GNAWTY, MONROE, PARROT, YUNA, etc. You notice that this first word is the Hardware ID that you have seen on the “GalliumOS Support by Model” table, that we have already talked about and is displayed at:

https://wiki.galliumos.org/Hardware_Compatibility

You need the whole number, not just the first word, to create a recovery utility; you also need the name if you ever need a “shellball” to bring your Chromebook back to its original state. We’ll get back to that, but for now, make sure you have this whole number kept somewhere.

In the "Identify your Chromebook" page of the Recovery Utility, the number we just talked about extensively is already written in blue in the Recovery window; just click on it and it will print automagically in the window below. But if you were to create a recovery utility for ANOTHER Chromebook, this is the window where you would enter the specific model number as outlined above. Since Google is nice to you, you could also select the Chromebook from a list that you call up by clicking on “Select a model from a list”. It is safer however to use the model number.

Click on Continue to proceed with the actual Media creation. Just follow the instructions.

== Create your GalliumOS USB or SD installation drive ==

<div style="background-color:#ffffcc;padding:0.2em 0.5em 0;border:1px solid #ddddaa;">
<p>'''NOTE''': This section recommends a tool called "Unetbootin", which may have caused problems for some users.</p>
<p>Our standard recommendation is <code>Win32DiskImager</code> for Windows, or <code>dd</code> for Linux or macOS. More details at [[Installing/Creating_Bootable_USB]].</p>
</div>

The Operating System you want to install, GalliumOS, must be available to you on a “bootable” USB or SD drive that you need to create. You therefore proceed to https://galliumos.org/download where you download the GalliumOS version appropriate to your Chromebook architecture (Haswell, Broadwell, Bay Trail, etc.). These are the Processor names that are displayed in the Hardware Compatibility List; you should have the name specific to your Chromebook available, if you wrote it down as was suggested earlier.

This GalliumOS installation file you download is an .iso file. The beauty of a file of this type is that you have on a single file all the bits and pieces required to install a Linux operating system with everything you need on a computer. Once this file has been downloaded, however, it needs to be decompressed and put on an USB flash or SD drive. To do that, it is recommended you use an application called Unetbootin that is available for Linux, Windows and Mac. It can be downloaded at:

http://unetbootin.github.io/

Once Unetbootin is installed on your computer, you plug in an USB or SD drive and follow the indications in Unetbootin. It is recommended you use a 4GB USB drive. It has been found that Chromebooks may not boot with large capacity USB drives. Also, an USB 3 drive may also not be willing to boot. Do it cheap and simple!

Now, you should have two drives (USB or SB) to keep: one with your Chromebook Recovery Media; one with GalliumOS. Make sure you label them properly and don’t misplace or erase them.

== Prepare the Chromebook ==
=== Select the procedure according to your Chromebook architecture ===
For this step, please see https://wiki.galliumos.org/Installing/Preparing This Wiki page explains how a Chromebook has to be prepared for installation according to the architecture of its processor (CPU). You notice that the architecture names (Sandy Bridge, Haswell, Broadwell, etc.) for which a specific installation is described are the same as the Processor names we already saw at https://wiki.galliumos.org/Hardware_Compatibility

If you followed our indications so far, your Chromebook architecture should have be noted somewhere.

For every architecture, the GalliumOS Installing/Preparing tutorial refers to SeaBIOS firmware. BIOS stands for Basic Input/Output System. It is a tiny – but very important – program (firmware) that tells your computer, among other things, where to look to find an operating system that will make it go. A special type of BIOS called SeaBIOS is required to install Linux on a Chromebook. Chromebooks with Haswell CPU architecture come with SeaBIOS already installed and you normally shouldn't have to worry about it. However, some bugs are reported in the SeaBIOS preinstalled on Haswell Chromebooks. (See https://wiki.galliumos.org/Firmware) It may therefore be advisable to install another version of the SeaBIOS on these machines. If you need to “flash” (replace) the BIOS firmware on your machine, you follow the procedure indicated in the [[Installing/Preparing tutorial]]. This is a delicate operation that you don't want to botch up as you may "brick" your Chromebook. ("Bricking" means that you make your computer worth no more than a brick of the same weight!) Luckily, John Lewis’ scripts to flash Chromebook BIOS makes it very easy. Before we get there, however, you need to put your Chromebook in developer mode.

=== Get into Developer Mode ===
The process to put the device in developer mode is very well described in the [https://wiki.galliumos.org/Installing/Preparing GalliumOS Installing/Preparing] Tutorial. Just in case you are looking for the Refresh key, it is the 4th one from the top left; it shows a clockwise arrow. As indicated in the Tutorial, you need to hold the "esc" (escape) and Refresh key and start your Chromebook to begin the process of getting into Developer mode. The first page you see is the "scary one": "Chrome OS is missing or damaged. Please insert a recovery USB stick or SD card."
[[File:ChromeMissModel.jpg|centre|thumb|576x576px|Scary, but informative!]]

Once your heartbeat is back to normal after having read this ominous warning, you can quietly read what else is written on this page. You notice on the last line, at the bottom of the page, the Chromeboook Model number. If you haven't written it down yet, as you should have, you get another chance to do it. (Got the message?). Now press "ctrl+D" (the letter "D" for "developer"). You get to another (less) scary white page which, again, shows the Model number. (Did I tell you this number is important?). But it also states that "To turn OS verification OFF, press ENTER." As it's written, "Your system will reboot and local data will be cleared". Go ahead, but it's your last chance to save your birthday photos on your Chromebook SSD! If you are not sure, press ESC.
[[File:TurnOSverif.jpg|centre|thumb|564x564px|Last chance to change your mind!]]

From now on, you let your computer do its thing. It first reboots and shows a big red exclamation mark.
[[File:OSVerifOFF.jpg|centre|thumb|577x577px|Let your computer do its thing!]]

After 30 seconds, the Chromebook beeps twice and reboots, then you have another chance to change your mind and, after 30 seconds, it restarts again and prepares the system for Developer Mode.

Once you are in Developer Mode, your Chromebook is “rooted”; it means that you have access to the “root” of the computer system. It also means you have to tread carefully… Note that some older Chromebooks have a physical switch that you'll have to flip in order to turn on Developer Mode. If you aren't sure, look up instructions for your specific device on enabling Developer Mode.

It takes about 15 minutes to put your Chromebook into Developer Mode. When it's done, it reboots and you get the scary message again. Since you don't want to stare at it for 30 seconds, just press "ctrl+D" to get to your familiar ChromeOS Welcome screen.

In Developer Mode, your Chromebook still works normally. The only difference is a white window that is displayed for 30 seconds upon restart and that you can bypass by entering ctrl+D. After you are in Developer mode, it is suggested you configure your Internet access normally and enter your Gmail name and password, just to reassure you that your Chromebook is still alive and well. Also, for the continuation of the operation, you will need Internet access.

=== Remove the Write Protection, if required ===
The BIOS is write-protected through physical and software means. If you have a Sandy Bridge / Ivy Bridge or a Bay Trail Chromebook, you will have to remove the physical write protection. To do that, you have to open the computer and, generally, remove a screw. You will find the information on how to do that through a quick search in Google.
[[File:WP-screw-02.jpg|centre|thumb|720x720px|Write-protection screw (circled in red) on an Acer Chromebook 15.]]

=== Access the “shell” and flash the firmware ===
Let’s assume now that you have restarted your Chromebook in Developer mode, entered your password and accessed the Chrome browser in your Chromebook. The next step is to open a Terminal window. This will take you to the heart of your computer. The Terminal is the screen that allows you to talk to the innards of your machine through commands and scripts. (Just like you see in the movies when the hacker is about to steal government secrets!) You can do all that in a Chromebook. (Not steal government secrets, but access a terminal window!) You just have to press CTRL+ALT+T. (Kind of an anticlimax, isn’t it?)

In this black terminal screen, at the prompt, you type: “shell” (without quotation marks) and hit Enter. From now on, follow the [https://wiki.galliumos.org/Installing/Preparing Preparing/Installing] tutorial for your appropriate CPU architecture from the line where it is stated:

“and hit enter. Now you should be in bash. You’ll have a prompt that looks something like this.”

('''NOTE''': If your Chromebook has a Haswell architecture but you prefer to flash the BIOS, follow the procedure outlined for the Broadwell architecture.)

Follow John Lewis’ script carefully. I recommend that you cut and paste it into the terminal. Remember that the Terminal is just another tab in the Chrome browser; you can access any other Internet site in other tabs and flip through tabs to Cut and Paste whatever you want from one page to another page.

After John Lewis’ script has been run, you continue with the GalliumOS Installing/Preparing Tutorial with a little caveat. Where it states: “Reboot your computer, plug in your GalliumOS USB and start installing!”, it should be the other way round. You must first plug in your GalliumOS USB drive, then reboot your computer.

== Install GalliumOS ==
When the Chromebook starts, a blue Unetbootin page comes up. It shows three options and states that you edit options with the Tab key. Actually, you don’t want to edit options at this stage; you only want to select one of them. You change selections with the Arrow keys and press Enter to select. I suggest you select the second one, “Gallium Live Image and Installer”. (Selecting "Default" is also fine; it does the same thing as the second option but it doesn't say so.)
[[File:Unetboot-Select-A.jpg|centre|thumb|505x505px|Use the Arrow down key to select GalliumOS Live]]
In a few seconds, you get a beautiful display of a glass skyscraper shot from below. You also have a fully functional Operating System at your disposal but your SSD is untouched because this is a “Live USB” (or "Live SD"): you totally bypass your SDD drive to talk to your computer. You can configure your WiFi and browse the Net. You can open AbiWord text processor and write your biography. But this is not what you want right now: you want to install GalliumOS. Fortunately, at the top right of the screen, there is an icon that states – Would you believe? – Install GalliumOS. Just double-click on it and follow the instructions.
[[File:InstallGall0S.jpg|centre|thumb|608x608px|Just double-click on Install GalliumOS icon!]]

When it comes to the page titled “Preparing to install GalliumOS, a Warning pop-up windows may come up to inform you of an error. You can safely ignore. You then come up to the Installation type window. The choice here is easy: select the first option, “Erase disk and install GalliumOS”. The installation may take 15-20 minutes. Relax and let GalliumOS do its thing.
[[File:Erase-disk.jpg|centre|thumb|577x577px|An easy choice at last: Erase the disk!]]

== GalliumOS is installed! ==
Now you have removed your GalliumOS installation USB drive and restarted your computer. The first thing you see is “Press ESC for boot menu.” You press ESC and the screen shows “Select boot device:” and a choice of devices. If there is no USB flash or SD drive plugged into your computer, you have only choice # 1, that is the computer SSD. If more than one device is displayed, select the one you know is your SSD. The type and the size should help you determine which the right one is. And if you make a mistake, no big deal: you just won’t start GalliumOS.

Once GalliumOS is opened, you will want to test the applications that come with it. You can also add other applications: you have tens of thousands applications to choose from! If you want to add applications, open Synaptic Package Manager that you will find in the Menu under System.

NOTE: Many Chromebooks have small screens. In Linux, it may happen that you are not able to see the bottom of a displayed window. This is particularly embarrassing if you have something to click on in that area. There is an easy trick: keep a finger on Left Alt and click on the window. As long as you keep the Left Alt key and the left mouse button pressed in, you can bring the window up or down, and move it around wherever you please.

=== Keyboard ===
GalliumOS is a fantastic Linux distribution tailored to Chromebooks. So, of course, the first thing to check is the keyboard because, as you know, the Chromebook keyboard is not standard.

==== Capital Lock Key ====
You may be from the "old school" like me and prefer to use the Chromebook Search key as a "Normal" Capital Lock key.

To get your Capital Lock back, you have to modify a file and create another one.

Besides being useful, this procedure will show you how easy it is to change things in Linux.
* Open Thunar File Manager. Under View, select "Show Hidden Files". Files that you were not aware of now show up in your Home folder.
* One of the file is ".bashrc". Notice the dot (.) before the file name. This dot is what causes this file to be hidden. Simple, isn't it?
* Right click on .bashrc and select "Open with Mousepad".
* When .bashrc is open in Mousepad, cut and paste the following lines at the bottom of the file.
if [-s ~/.Xmodmap]; then

xmodmap ~/.Xmodmap

fi
* Save the file.
* Still in Mousepad, go to File and click on New.
* In this new document, just enter:
keycode 133 = Caps_Lock
* Save this file in your Home folder as .Xmodmap (Don't forget the "dot" before the file name!).
* Close Mousepad and Log out of your session and back in. Your Capital Lock key should now work "normally".
Note that an external keyboard plugged into your Chromebook through whatever connection (USB, Bluetooth, etc.) will work as it is supposed to do according to the particular model, even if you modify/create the configuration files as indicated above. (See below in "Chromebook Special Keys".)

==== Chromebook Special Keys ====
Once you have confirmed that your Capital Lock is working, go the GalliumOS Menu (Icon in the left hand corner of the Taskbar) and go to Settings, then to Settings Manager. In the Settings window, click on Keyboard (under Hardware). Select the tab Layout. Under "Keyboard model", select: "Chromebook | No overlay | F keys mapped to media keys". You now have a standard Chromebook keyboard with the exception of the Search key that is now a normal Caps Lock. You can use the special function keys normally (Full Screen, Brightness, Volume, etc.).

You can also use the Keyboard Model window to select an external keyboard you wish to use if you plug one in. If you don't find the exact keyboard model in the list, you may use one close enough (same manufacturer, similar performance, etc.). You can try and see until you find a model that fits your needs. You can always use your mouse to change your selection if your external keyboard has a strange behavior.

=== Mouse and Touchpad ===
You may also prefer to use a mouse because the touchpad may feel awkward to use for you and interferes with your typing. Many people prefer having the touchpad deactivated when they type. There is a simple solution called: Touchpad Indicator. To install this application, go to:

http://tipsonubuntu.com/2014/05/26/install-touchpad-indicator-ubuntu-14-04/

Follow the instructions, except that at the beginning, you won't access the terminal by entering Ctrl+Alt+T. But it's even simpler in GalliumOS: just click in the taskbar on the icon that shows an arrow head and a minus sign.

Once Touchpad Indicator is installed, you need to reboot the computer for the Touchpad-indicator to work. In the Menu, the application is under Accessories; click on it to start. It will put an icon in the right of the taskbar, in an area generally called the "tray". However, the icon may not be visible, depending on the Desktop theme you have selected. If you see what looks like an empty spot in the tray, it may well be the Touchpad indicator icon. Click on it and select Preferences. First go to Theme and select the icon on the right; the Touchpad-indicator icon should now be visible in the tray. While you are in Touchpad indicator Preferences, go to the Actions tab, and select "Disable touchpad when a mouse plugged" and "Enable touuchpad on exit". In General options, select "Autostart". With this configuration, the touchpad will be ON when you start the computer without a mouse and OFF when a mouse is plugged in.

=== Printers ===
Your printers may have been detected by Linux and configured. In the GalliumOS Menu, under System, select Printers. Click on Add. If you have one or more Network printers - that is the most probable scenario - just click on Network Printer and Find Network Printer. It may take a while (15-20 seconds), but the printers on your local network should be detected. If the system proposes a "generic printer" or if you cannot find the exact printer model in the list under the manufacturer's name, it means that the driver is not available in the present Linux kernel; however, it is most probably available on the manufacturer’s site. Just go to their site, enter your computer model and follow the instructions. Actually, as a rule, it always safer to check if there is a Linux driver on the manufacturer's site.

If you have downloaded a printer driver, or any other software for that matter, as a .deb file (the application file format in GalliumOS), you install it using GDebi. To do so, open your Thunar file manager (the icon on the taskbar that looks like a folder), go to the Downloads folder and find in there the file with the ".deb" suffix you just downloaded. Right click on the file icon and select "Open with GDebi package manager". Follow the instructions.

=== New Applications and Updates ===
You have thousands of applications at your disposal in Linux. You also have in GalliumOS a very easy and efficient tool to install applications: Synaptic Package Manager. In GalliumOS Menu, the Synaptic Package Manager is found under System. Just click on it, enter your password, search the application you need and, when it is listed in the window, right click on the window and select "Mark for Installation". You may have to Mark additional required changes (the system will ask you if you accept to do that), and you then click Apply. That's all.

If you want to install all updates that may have cropped up since your GalliumOS version first came out, you also use the Synaptic Package Manager. First, you click on All, in the left window, then on Reload, in the Icon bar, then on Mark All Upgrades, also in the Icon bar. You just have to click Apply, still in the Icon bar, and all your software will be updated.

=== File Transfer on Private Network ===
If you want to transfer files between computers on your own private network, through your own router, the easiest way is to install Nautilus file manager. Use Synaptic Package Manager to select and install the Nautilus application.

In Nautilus, you just right click on the folder you want to share and select Share on local network.

=== Office Suite ===
AbiWord is a simple and efficient application for word-processing. In AbiWord, you can open and save Microsoft<sup>TM</sup> Office Word documents.

If you need a full Office Suite, look no further than LibreOffice, a free and open-source software. All the praise you may read on Internet about this Office Suite is well deserved.

In case you absolutely need the actual Microsoft<sup>TM</sup> Office Suite, your option is to use Wine, an application that makes Windows applications "believe" they are in Windows OS. Wine per se is a bit tricky to configure; the user without a thorough knowledge of Wine may not obtain satisfactory results when attempting to use it. However, you will find in Synaptic Package Manager a front-end for Wine called PlayOnLinux that will make installing Windows application a breeze. Once installed in GalliumOS, PlayOnLinux comes in the Menu under Games (?!!). Installing Microsoft Office with PlayOnLinux is fairly straightforward. However, installing the updates or "Service Packs (SP)" may be a bit trickier, so here is how it goes.

Let's assume that you have installed MS Office 2007 with PlayOnLinux. You also downloaded the appropriate update from the MS site (SP3, in the case of Office 2007); it goes into your Downloads folder. You now open PlayOnLinux (in Games, remember?) and you click on the Configure icon. In the PlayOnLinux configuration window, you click on Office2007 (or whichever MS Office Suite you installed). You now click on the Miscellaneous tab and click on "Run a .exe file in this virtual drive". You select in Downloads the MS Office Service Pack .exe file and follow the instructions. Your MS Office 2007 will be updated as required.

If you really want to make it very simple, you may wish to install CrossOver Office by Codeweavers. (See https://www.codeweavers.com) This application is not free but it simplifies greatly the installation of Windows applications in Linux.

== Back to ChromeOS ==
<div style="background-color:#ffffcc;padding:0.2em 0.5em 0;border:1px solid #ddddaa;">
<p>'''NOTE''': This section recommends using the John Lewis flashrom script/utility to return to stock firmware.</p>
<p>We recommend using the MrChromebox script for restoring stock firmware and changing GBB flags. More details at https://mrchromebox.tech/.</p>
</div>
You may wish to return your Chromebook to its original state; in other words, you want to run it under ChromeOS instead of GalliumOS. This is also a fairly simple operation as long as you follow the procedure.

If you flashed the original Chromebook BIOS to install GalliumOS, you have to flash again the BIOS to bring it back to original. Remember that even if you have a Haswell CPU, you may have chosen to install initially John Lewis' SeaBIOS.

=== Download the appropriate shellball ===
The first thing to do is to download a "shellball", that is a folder that contains a bunch of files specific to your particular Chromebook to bring it back to original. You find the shellballs at:

https://johnlewis.ie/Chromebook-ROMs/shellballs

When you get to that page, you see an Index listing names which should be familiar to you: it is your Hardware ID that was displayed in the [[Hardware Compatibility List]] that we referred to at the beginning of this tutorial. You may wish to go back to that list, just to be sure.

Open Thunar and go to your Home page. In there, create a folder named "shellball". Download into that folder all the files under the appropriate shellball name that you found in the [[shellballs list]].

=== Get John Lewis' flashrom utility ===
Next, go to https://johnlewis.ie/Chromebook-ROMs/utils/

In the list, right click on "flashrom" and click on "Save Target As ...". Save this file in your Home folder.

In Thunar, go to your Home folder, right click on this downloaded "flashrom" file and Rename it "flashrom.sh"

Open a Terminal window. (XFCE Terminal is in your Panel and your Menu.) The Terminal normally opens in your Home folder. (The prompt should show [YOUR_COMPUTER_NAME]:~$)

You are now going to make "flashrom.sh" executable. To do so, at the prompt, type:

chmod +x flashrom.sh

While you are in the terminal, change to the shellball folder. To do so, at the prompt, type:

cd shellball

Now that you are in "shellball", there is a file there that you have to make executable; it is "gbb_utility". So you type at the prompt:

chmod +x gbb_utility

=== Enter the required commands ===
Still in the terminal, you now have to type the commands below. You may Cut and Paste, EXCEPT the "hwid" which is specific to your Chromebook.

'''<u>NOTE:</u>'''
* When you type the commands, ensure that you have two dashes before « set » and « hwid » and not an M-dash (a single long dash). Text editors have a mind of their own and sometimes replace two consecutive dashes by a single M-dash.
* Replace the Hardware ID (hwid) number (ABCXYX X1X-Y2Y-Z3Z) by the one specific to your Chromebook and that you should have kept. Mine is GNAWTY C2C-E3N-A2M; yours is probably different.
* If a command does not work, i.e. you get a message like “Command cannot be found” it is quite likely that you missed a dot (.) or a slash (/) at the beginning of the command line.
* The file "bios.bin.new" may not be present in the shellball folder. In that case, the second and forth commands below are not required.
The commands are:

./gbb_utility --set --hwid='ABCXYX X1X-Y2Y-Z3Z' bios.bin

./gbb_utility --set --hwid='ABCXYX X1X-Y2Y-Z3Z' bios.bin.new

./gbb_utility --set --flags=0x489 bios.bin

./gbb_utility --set --flags=0x489 bios.bin.new

Everytime, the system should confirm that the command was successful.

Still in the terminal, return to the home folder by typing "cd" and two dots at the prompt, like so:

cd ..

Then, run this command:

sudo ./flashrom.sh -w shellball/bios.bin

=== Restart your computer ===
Your Chromebook first displays a message with a red exclamation mark stating: OS verification is OFF.

After some beeps, another message appears: "Chrome OS is missing or damaged. Please insert a recovery USB stick or SD card.

Insert your USB or SD Chromebook Recovery Media into the appropriate port. Follow the instructions.

(Basically, just wait until the recovery is complete.)

When it's done, remove the Recovery Media and the Chromebook restarts.

After the restart, you get a beep, then the usual Chromebook opening page.

Enter all the required data to log into your Chromebook.

=== Reset the "flags" and OS Verification ===
You don't really have to know what these flags are. Just keep in mind that they dictate the sequence of the boot process. You need to reset them for your Chromebook to boot like new.

Open a terminal with CTRL+ALT+T

At the command prompt, type “shell” and press Enter.

Type each of the following command, pressing Enter after each one:

sudo flashrom --wp-disable

sudo /usr/share/vboot/bin/set_gbb_flags.sh 0x000

sudo flashrom --wp-enable

Restart the computer.

You get the message stating "OS verification is OFF. Press SPACE to re-enable." Press the spacebar.

Your Chromebook is now - almost - back to where it was when new.

To make it complete, reinstall the physical write protect device (probably a single screw to put back in place) if a change on the motherboard was required to disable the physical BIOS write-protection.

== Conclusion: How much space left? ==
The major concern for a Chromebook user after installing GalliumOS is the amount of space left on the SDD. As initially mentioned, unless you have a large SSD because either you bought a top-of-the line Chromebook or you upgraded to a larger SSD, the usual SSD size on a Chromebook is 16GB. Normally, however, the data files (text, image, video, etc.) should preferably be stored on external drives when using a Chromebook. Still, as a matter of interest, I checked with GParted (available in Settings) the space used on my 16GB Acer CB3-111 after a GalliumOS installation; several applications were added and a complete OS update was performed. I have 5.74GB of free space left, that is more than 1/3 of the drive. But I have to mention that I installed more applications than I'll ever need! For instance, I installed the complete LibreOffice Suite AS WELL AS the complete Microsoft Office 2007 suite, with three grammar and spell-checkers (English, Spanish, French). I also installed Firefox AND Chrome on top of Chromium. So it may be safe to say that for about 90% of the average computer users, space should not be an issue on a Chromebook, provided external USB flash or SD drives are used to keep non-executable files.

Additional Software

2016-09-25T20:14:26Z

Dvdmuckle: /* Wine */

GalliumOS comes with a good selection of desktop and utility software, but there is a huge variety of additional options and alternatives.

GalliumOS can install any software packages built for Ubuntu, directly from the Canonical package servers.

There are also some frequently-requested applications that are not available from Canonical, or are more complicated to install. A few are listed here. Please add more!

== Desktop ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb
</pre>



=== Adobe Flash ===

Adobe Flash apps (and Twitch streams, etc) require Adobe Flash Player, which is not included by default in GalliumOS.

* Install adobe-flashplugin from Canonical's <code>partner</code> repository.
<pre style="margin:0 0 0 2em; padding:0.4em;">
sudo add-apt-repository "deb http://archive.canonical.com/ubuntu $(lsb_release -sc) partner"
sudo apt-get update
sudo apt-get install adobe-flashplugin
</pre>
* Confirm installation by entering <code>chrome://plugins</code> (Chromium) or <code>about:plugins</code> (Firefox) into the URL bar

The proprietary version of Google Chrome includes PepperFlash, and does not require an additional plugin.

=== Firefox Aurora (developer preview) ===

See https://launchpad.net/~ubuntu-mozilla-daily/+archive/ubuntu/firefox-aurora

=== TeamViewer ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
curl -OL http://download.teamviewer.com/download/teamviewer_i386.deb
sudo dpkg -i teamviewer_i386.deb
</pre>

=== Google Drive integration ===

<p style="background-color:#ffaaaa;padding:0.2em 0.5em">NOTE: Instructions need update for GalliumOS 2.0. Error reported when adding user to <code>fuse</code> group.</p>

* Install the software
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:alessandro-strada/ppa
sudo apt-get update
sudo apt-get install google-drive-ocamlfuse
</pre>

* Next, add yourself to the Linux group ''fuse'' so you can mount Google Drive without root.
<pre style="margin:0 0 0 1.5em">
sudo usermod -a -G fuse <user_name>
exec su -l $USER
</pre>

* Run google-drive-ocamlfuse for first time setup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse
</pre>

You'll get a browser window asking you to sign in to your Google account and if you want to give gdfuse OAuth2 Endpoint permission to access your Drive files. Hit Accept / Allow for any following dialog. Close the browser window.

* Next, create a directory where your Google Drive files will be mounted, preferably in your home directory, and mount Google Drive to that directory.
<pre style="margin:0 0 0 1.5em">
mkdir ~/googledrive
google-drive-ocamlfuse ~/googledrive
</pre>

You can check if Google Drive is mounted by performing:
<pre style="margin:0 0 0 1.5em">
mount
</pre>

You can also check how much space you have left:
<pre style="margin:0 0 0 1.5em">
df
</pre>

If you want to unmount, simply run
<pre style="margin:0 0 0 1.5em">
fusermount -u ~/googledrive
</pre>

* To mount Google Drive at startup, set the following command to run at boot with Session and Startup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse -label default /home/<user>/googledrive
</pre>

A word of warning, large files such as movies or large videos don't work too well with google-drive-ocamlfuse using default settings. Files are cached to ~/.gdfuse/default/cache. A config file can be found in the directory above that, with parameters to allow for streaming larger files, cache size, etc.. The streaming larger files parameter is perfect for large videos and movies. For more information, check out gdfuse on GitHub.

Adapted from: http://xmodulo.com/mount-google-drive-linux.html

=== Skype ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository "deb http://archive.canonical.com/ $(lsb_release -sc) partner"
sudo apt-get update && sudo apt-get install skype
</pre>

Source: https://help.ubuntu.com/community/Skype

See also: https://www.skype.com/en/download-skype/skype-for-linux/

=== Wine ===

Wine has been a source of frustration. These instructions are verified on a fresh install of 2.0.

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository ppa:ubuntu-wine/ppa
sudo apt-get update
sudo apt-get install wine1.8
</pre>

=== Simple Screen Recorder ===
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository -y ppa:maarten-baert/simplescreenrecorder
sudo apt-get update
sudo apt-get install simplescreenrecorder
</pre>

=== Spotify ===

<pre style="margin:0 0 0 1.5em">
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys BBEBDCB318AD50EC6865090613B00F1FD2C19886
echo deb http://repository.spotify.com stable non-free | sudo tee /etc/apt/sources.list.d/spotify.list
sudo apt-get update
sudo apt-get install spotify-client
</pre>

Source: https://www.spotify.com/us/download/linux/

=== Kodi Media Center ===

<pre style="margin:0 0 0 1.5em">
sudo apt-get install python-software-properties pkg-config software-properties-common
sudo add-apt-repository -y ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi
</pre>

== Games ==

=== Steam ===
<pre style="margin:0 0 0 1.5em">
curl -O http://repo.steampowered.com/steam/archive/precise/steam_latest.deb
sudo dpkg -i steam_latest.deb
</pre>

Then launch Steam from the application launcher. Your user must be in the "sudo" group (if it is not, the dpkg command above will also fail), so that the installer can do all the things it needs to do.

=== Minecraft ===
<pre style="margin:0 0 0 1.5em">
sudo bash
apt-get install default-jre
curl -o /usr/local/bin/Minecraft.jar https://s3.amazonaws.com/Minecraft.Download/launcher/Minecraft.jar
curl -o /usr/share/pixmaps/minecraft.png https://chrx.org/minecraft.png
mkdir -p /usr/local/share/applications
cat > /usr/local/share/applications/minecraft.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Minecraft
Comment=Minecraft
Exec=java -jar /usr/local/bin/Minecraft.jar
Icon=/usr/share/pixmaps/minecraft.png
Categories=Game;
EOF
</pre>

== Utilities ==

=== grsync ===
Graphical lightweight version of rsync to back up data between drives
<pre style="margin:0 0 0 1.5em">
sudo apt-get install grsync
</pre>

=== aptik ===
Backup APT sources/repository data
<pre style="margin:0 0 0 1.5em">
sudo apt-add-repository -y ppa:teejee2008/ppa
sudo apt-get update
sudo apt-get install aptik
</pre>

=== OpenVPN ===
Install the following two packages to get OpenVPN connectivity with your favorite VPN service.
<pre style="margin:0 0 0 1.5em">
sudo apt-get install openvpn network-manager-openvpn
</pre>

=== caffeine-plus ===
Used to keep the screen awake with full screen applications such as full screen video.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:nilarimogard/webupd8
sudo apt-get update
sudo apt-get install caffeine-plus
</pre>
Source: [http://www.webupd8.org/2014/08/screensaver-lock-screen-inhibitor.html Webupd8]

== Hardware Optimization ==

=== Battery Tuning ===

==== Powertop ====
Monitor process and device power consumption. Includes a handy auto-tune option which can be run at startup that helps to minimize power consumption. Powertop also provides a calibration option, which some people have reported issues with (locks up device?).

<pre style="margin:0 0 0 1.5em">
sudo apt-get install powertop
sudo powertop
</pre>

Powertop needs to be run every time the system boots. Expand for instructions:

<div class="mw-collapsible mw-collapsed" style="border:1px #666666 dashed;padding:0.5em 1em;min-height:2em;margin:0 2em;background-color:#eee;">

Create <code>/etc/systemd/system/powertop.service</code> with the following content:

<pre style="margin:0 0 0 1.5em">
[Unit]
Description=Powertop tunings

[Service]
Type=oneshot
ExecStart=/usr/sbin/powertop --auto-tune

[Install]
WantedBy=multi-user.target
</pre>

Then reboot.

Source: https://wiki.archlinux.org/index.php/Powertop
</div>

==== TLP ====

Advanced power management tool that also provides a default configuration optimized for battery life for "install and forget it" benefits. TLP has reportedly provided some improvement to battery life. Your mileage may vary.

<pre style="margin:0 0 0 1.5em">sudo add-apt-repository ppa:linrunner/tlp
sudo apt-get install tlp
sudo tlp start</pre>

== Miscellaneous ==

These have been discussed, but are not presently candidates for inclusion in the default installation. They might be of special interest, might have important caveats, or might be the unchosen of other options. Presented here for convenience.

==== Hardware temperature monitor ====
* <code>xfce4-sensors-plugin</code> from Ubuntu repositories. '''WARNING:''' Do '''not''' select <code>tachos</code>. It will crash your desktop.

==== Clipboard Manager ====
* <code>clipit</code> from Ubuntu repositories. Developer homepage is missing. Be conscious of the security implications of all clipboard managers.

==== Video Player ====
* https://mpv.io/ Lightweight, but very minimal UI
* <code>smplayer</code> from Ubuntu repositories. Lightweight.

==== Screen Recorder ====
* <code>OBS</code> from PPA. One of the most popular screen recording tools. See https://obsproject.com/ for more info.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:obsproject/obs-studio
sudo apt-get update
sudo apt-get install obs-studio
</pre>
* <code>kazam</code> from Ubuntu repositories. Alternative to <code>simplescreenrecorder</code>, above. See https://apps.ubuntu.com/cat/applications/kazam/ for more info.

==== Disk Usage/Performance Indicators ====
* <code>xfce4-goodies</code> from Ubuntu repositories includes a free space checker applet
* <code>xfce4-diskperf-plugin</code> from Ubuntu repositories is a disk performance monitor applet, and shows usage as well

Media

2016-08-22T19:02:06Z

Dvdmuckle: Added Linux Luddites link

== GalliumOS Media Coverage ==

Media outlets big and small. If you have written about GalliumOS, or know someone who has, please let us know so we can add you to our list.

For media inquiries, please reach us at contact-at-galliumos-dot-org!

* '''Linux Luddites''' [https://linuxluddites.com/shows/episode-85/ Linux Luddites Episode #85] (2016-08-22)
* '''Nick Janetakis''' [http://nickjanetakis.com/blog/transform-a-toshiba-chromebook-cb35-into-a-linux-development-environment-with-galliumos Transform a Toshiba Chromebook CB35 (2015) into a Linux development environment with GalliumOS] (2016-07-30)
* '''Jean-Pierre Buntinx '''[https://medium.com/@jdebunt/why-i-switched-to-galliumos-on-my-acer-c720-chromebook-a61e38b2f24d#.frabh8516 Why I Switched to GalliumOS On My Acer C720 Chromebook] (2016-05-17)
* '''tech lore by igor''' [https://techlorebyigor.blogspot.com/2016/04/my-review-of-galliumos-v10.html My Review of GalliumOS v1.0] (2016-04-05) (we're not the North Korean mafia, we super promise!)
* '''Foss Force''' [http://fossforce.com/2016/03/screencast-look-galliumos A Screencast Look at GalliumOS] (2016-03-25)
* '''Linux Action Show''' [http://www.jupiterbroadcasting.com/92926/pre-scale-las-las-401/ Pre SCaLE LAS | LAS 401] (2016-01-24)
* '''Linux.com''' [http://www.linux.com/learn/tutorials/870387-galliumos-the-ideal-linux-distribution-for-chromebook-hardware/ GalliumOS: The Ideal Linux Distribution for Chromebook Hardware] (2015-12-05)
* '''ITWorld.com''' [http://www.itworld.com/article/3004051/linux/galliumos-beta-released-for-chromebooks-and-chromeboxes.html GalliumOS Linux beta released for Chromebooks and Chromeboxes] (2015-11-12)
* '''ChromeCrunch''' [http://chromecrunch.com/galliumos-for-chromeos-is-finally-here-beta-1-is-ready-to-install-on-chromebook/ GalliumOS For ChromeOS Is Finally Here! Beta 1 Is Ready To Install] (2015-11-12)
* '''Elio's Corner''' [http://elioqoshi.me/2015/11/galliumos-beta/ GalliumOS – A Linux alternative for ChromeOS] (2015-11-12)
* '''ColtonDRG.com''' [https://coltondrg.com/2015/11/galliumos-beta-1-released/ GalliumOS Beta 1 Released] (2015-11-11)

== Non-English ==

We don't really know what these say... We hope they're good! :D

* '''Omicrono''' (es) [http://www.omicrono.com/2016/05/galliumos-chromebook-chrome-os/ GalliumOS, la alternativa perfecta a ChromeOS] (2016-05-26)
* '''linuxadictos''' (es) [http://www.linuxadictos.com/galliumos-beta-disponible-de-la-mejor-distro-al-estilo-chrome-os.html GalliumOS beta disponible de la mejor distro al estilo Chrome OS] (2015-11-17)
* '''Cloudspace.news''' (ru) [http://cloudspace.news/linux-chromebook-galliumos/ Опубликована первая версия GalliumOS] (2015-11-13)

Additional Software

2016-08-06T22:25:52Z

Dvdmuckle: Powertop needs to run as root; service should pull from /usr/sbin

<p style="background-color:#ffaaaa;padding:0.2em 0.5em">'''NOTE (20160702)''' Most of the instructions here are for GalliumOS 1.0 and have not yet been tested for GalliumOS 2.0. Most will work without change, but some updates will probably be necessary. These will be updated soon, but please let us know if you run into any issues!</p>

GalliumOS comes with a good selection of desktop and utility software, but there is a huge variety of additional options and alternatives.

GalliumOS can install any software packages built for Ubuntu, directly from the Canonical package servers.

There are also some frequently-requested applications that are not available from Canonical, or are more complicated to install. A few are listed here. Please add more!

== Desktop ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb
</pre>



=== Adobe Flash ===

Adobe Flash apps (and Twitch streams, etc) require Adobe Flash Player, which is not included by default in GalliumOS.

* Install adobe-flashplugin from Canonical's <code>partner</code> repository.
<pre style="margin:0 0 0 2em; padding:0.4em;">
sudo add-apt-repository "deb http://archive.canonical.com/ubuntu vivid partner"
sudo apt-get update
sudo apt-get install adobe-flashplugin
</pre>
* Confirm installation by entering <code>chrome://plugins</code> (Chromium) or <code>about:plugins</code> (Firefox) into the URL bar

The proprietary version of Google Chrome includes PepperFlash, and does not require an additional plugin.

* '''For GalliumOS 2.0''': Process is still valid, but replace <code>vivid</code> with <code>xenial</code> in the <code>add-apt-repository</code> command line.

=== Firefox Aurora (developer preview) ===

See https://launchpad.net/~ubuntu-mozilla-daily/+archive/ubuntu/firefox-aurora

=== TeamViewer ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
curl -OL http://download.teamviewer.com/download/teamviewer_i386.deb
sudo dpkg -i teamviewer_i386.deb
</pre>

=== Google Drive integration ===

<p style="background-color:#ffaaaa;padding:0.2em 0.5em">NOTE: Instructions need update for GalliumOS 2.0. Error reported when adding user to <code>fuse</code> group.</p>

* Install the software
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:alessandro-strada/ppa
sudo apt-get update
sudo apt-get install google-drive-ocamlfuse
</pre>

* Next, add yourself to the Linux group ''fuse'' so you can mount Google Drive without root.
<pre style="margin:0 0 0 1.5em">
sudo usermod -a -G fuse <user_name>
exec su -l $USER
</pre>

* Run google-drive-ocamlfuse for first time setup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse
</pre>

You'll get a browser window asking you to sign in to your Google account and if you want to give gdfuse OAuth2 Endpoint permission to access your Drive files. Hit Accept / Allow for any following dialog. Close the browser window.

* Next, create a directory where your Google Drive files will be mounted, preferably in your home directory, and mount Google Drive to that directory.
<pre style="margin:0 0 0 1.5em">
mkdir ~/googledrive
google-drive-ocamlfuse ~/googledrive
</pre>

You can check if Google Drive is mounted by performing:
<pre style="margin:0 0 0 1.5em">
mount
</pre>

You can also check how much space you have left:
<pre style="margin:0 0 0 1.5em">
df
</pre>

If you want to unmount, simply run
<pre style="margin:0 0 0 1.5em">
fusermount -u ~/googledrive
</pre>

* To mount Google Drive at startup, set the following command to run at boot with Session and Startup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse -label default /home/<user>/googledrive
</pre>

A word of warning, large files such as movies or large videos don't work too well with google-drive-ocamlfuse using default settings. Files are cached to ~/.gdfuse/default/cache. A config file can be found in the directory above that, with parameters to allow for streaming larger files, cache size, etc.. The streaming larger files parameter is perfect for large videos and movies. For more information, check out gdfuse on GitHub.

Adapted from: http://xmodulo.com/mount-google-drive-linux.html

=== Skype ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository "deb http://archive.canonical.com/ $(lsb_release -sc) partner"
sudo apt-get update && sudo apt-get install skype
</pre>

Source: https://help.ubuntu.com/community/Skype

See also: https://www.skype.com/en/download-skype/skype-for-linux/

=== Wine ===

Wine has been a source of frustration. These instructions are verified on a fresh install of 1.0beta2.

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository ppa:ubuntu-wine/ppa
sudo apt-get update
sudo apt-get install wine1.8
</pre>

=== Simple Screen Recorder ===
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository -y ppa:maarten-baert/simplescreenrecorder
sudo apt-get update
sudo apt-get install simplescreenrecorder
</pre>

=== Spotify ===

<pre style="margin:0 0 0 1.5em">
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys BBEBDCB318AD50EC6865090613B00F1FD2C19886
echo deb http://repository.spotify.com stable non-free | sudo tee /etc/apt/sources.list.d/spotify.list
sudo apt-get update
sudo apt-get install spotify-client
</pre>

Source: https://www.spotify.com/us/download/linux/

=== Kodi Media Center ===

<pre style="margin:0 0 0 1.5em">
sudo apt-get install python-software-properties pkg-config software-properties-common
sudo add-apt-repository -y ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi
</pre>

== Games ==

=== Steam ===
<pre style="margin:0 0 0 1.5em">
curl -O http://repo.steampowered.com/steam/archive/precise/steam_latest.deb
sudo dpkg -i steam_latest.deb
</pre>

Then launch Steam from the application launcher. Your user must be in the "sudo" group (if it is not, the dpkg command above will also fail), so that the installer can do all the things it needs to do.

=== Minecraft ===
<pre style="margin:0 0 0 1.5em">
sudo bash
apt-get install default-jre
curl -o /usr/local/bin/Minecraft.jar https://s3.amazonaws.com/Minecraft.Download/launcher/Minecraft.jar
curl -o /usr/share/pixmaps/minecraft.png https://chrx.org/minecraft.png
mkdir -p /usr/local/share/applications
cat > /usr/local/share/applications/minecraft.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Minecraft
Comment=Minecraft
Exec=java -jar /usr/local/bin/Minecraft.jar
Icon=/usr/share/pixmaps/minecraft.png
Categories=Game;
EOF
</pre>

== Utilities ==

=== grsync ===
Graphical lightweight version of rsync to back up data between drives
<pre style="margin:0 0 0 1.5em">
sudo apt-get install grsync
</pre>

=== aptik ===
Backup APT sources/repository data
<pre style="margin:0 0 0 1.5em">
sudo apt-add-repository -y ppa:teejee2008/ppa
sudo apt-get update
sudo apt-get install aptik
</pre>

=== OpenVPN ===
Install the following two packages to get OpenVPN connectivity with your favorite VPN service.
<pre style="margin:0 0 0 1.5em">
sudo apt-get install openvpn network-manager-openvpn
</pre>

=== caffeine-plus ===
Used to keep the screen awake with full screen applications such as full screen video.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:nilarimogard/webupd8
sudo apt-get update
sudo apt-get install caffeine-plus
</pre>
Source: [http://www.webupd8.org/2014/08/screensaver-lock-screen-inhibitor.html Webupd8]

== Hardware Optimization ==

=== Battery Tuning ===

==== Powertop ====
Monitor process and device power consumption. Includes a handy auto-tune option which can be run at startup that helps to minimize power consumption. Powertop also provides a calibration option, which some people have reported issues with (locks up device?).

<pre style="margin:0 0 0 1.5em">
sudo apt-get install powertop
sudo powertop
</pre>

Powertop needs to be run every time the system boots. Expand for instructions:

<div class="mw-collapsible mw-collapsed" style="border:1px #666666 dashed;padding:0.5em 1em;min-height:2em;margin:0 2em;background-color:#eee;">

Create <code>/etc/systemd/system/powertop.service</code> with the following content:

<pre style="margin:0 0 0 1.5em">
[Unit]
Description=Powertop tunings

[Service]
Type=oneshot
ExecStart=/usr/sbin/powertop --auto-tune

[Install]
WantedBy=multi-user.target
</pre>

Then reboot.

Source: https://wiki.archlinux.org/index.php/Powertop
</div>

==== TLP ====

Advanced power management tool that also provides a default configuration optimized for battery life for "install and forget it" benefits. TLP has reportedly provided some improvement to battery life. Your mileage may vary.

<pre style="margin:0 0 0 1.5em">sudo add-apt-repository ppa:linrunner/tlp
sudo apt-get install tlp
sudo tlp start</pre>

== Miscellaneous ==

These have been discussed, but are not presently candidates for inclusion in the default installation. They might be of special interest, might have important caveats, or might be the unchosen of other options. Presented here for convenience.

==== Hardware temperature monitor ====
* <code>xfce4-sensors-plugin</code> from Ubuntu repositories. '''WARNING:''' Do '''not''' select <code>tachos</code>. It will crash your desktop.

==== Clipboard Manager ====
* <code>clipit</code> from Ubuntu repositories. Developer homepage is missing. Be conscious of the security implications of all clipboard managers.

==== Video Player ====
* https://mpv.io/ Lightweight, but very minimal UI
* <code>smplayer</code> from Ubuntu repositories. Lightweight.

==== Screen Recorder ====
* <code>kazam</code> from Ubuntu repositories. Alternative to <code>simplescreenrecorder</code>, above. See https://apps.ubuntu.com/cat/applications/kazam/ for more info.

==== Disk Usage/Performance Indicators ====
* <code>xfce4-goodies</code> from Ubuntu repositories includes a free space checker applet
* <code>xfce4-diskperf-plugin</code> from Ubuntu repositories is a disk performance monitor applet, and shows usage as well

Additional Software

2016-07-30T06:26:05Z

Dvdmuckle: Added caffeine-plus entry

<p style="background-color:#ffaaaa;padding:0.2em 0.5em">'''NOTE (20160702)''' Most of the instructions here are for GalliumOS 1.0 and have not yet been tested for GalliumOS 2.0. Most will work without change, but some updates will probably be necessary. These will be updated soon, but please let us know if you run into any issues!</p>

GalliumOS comes with a good selection of desktop and utility software, but there is a huge variety of additional options and alternatives.

GalliumOS can install any software packages built for Ubuntu, directly from the Canonical package servers.

There are also some frequently-requested applications that are not available from Canonical, or are more complicated to install. A few are listed here. Please add more!

== Desktop ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt-get -f install
</pre>

The last step is necessary to finish installing some additional package dependencies: <code>libappindicator1 libdbusmenu-gtk4 libindicator7</code>.


=== Adobe Flash ===

Adobe Flash apps (and Twitch streams, etc) require Adobe Flash Player, which is not included by default in GalliumOS.

* Install adobe-flashplugin from Canonical's <code>partner</code> repository.
<pre style="margin:0 0 0 2em; padding:0.4em;">
sudo add-apt-repository "deb http://archive.canonical.com/ubuntu vivid partner"
sudo apt-get update
sudo apt-get install adobe-flashplugin
</pre>
* Confirm installation by entering <code>chrome://plugins</code> (Chromium) or <code>about:plugins</code> (Firefox) into the URL bar

The proprietary version of Google Chrome includes PepperFlash, and does not require an additional plugin.

* '''For GalliumOS 2.0''': Process is still valid, but replace <code>vivid</code> with <code>xenial</code> in the <code>add-apt-repository</code> command line.

=== Firefox Aurora (developer preview) ===

See https://launchpad.net/~ubuntu-mozilla-daily/+archive/ubuntu/firefox-aurora

=== TeamViewer ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
curl -OL http://download.teamviewer.com/download/teamviewer_i386.deb
sudo dpkg -i teamviewer_i386.deb
</pre>

=== Google Drive integration ===

<p style="background-color:#ffaaaa;padding:0.2em 0.5em">NOTE: Instructions need update for GalliumOS 2.0. Error reported when adding user to <code>fuse</code> group.</p>

* Install the software
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:alessandro-strada/ppa
sudo apt-get update
sudo apt-get install google-drive-ocamlfuse
</pre>

* Next, add yourself to the Linux group ''fuse'' so you can mount Google Drive without root.
<pre style="margin:0 0 0 1.5em">
sudo usermod -a -G fuse <user_name>
exec su -l $USER
</pre>

* Run google-drive-ocamlfuse for first time setup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse
</pre>

You'll get a browser window asking you to sign in to your Google account and if you want to give gdfuse OAuth2 Endpoint permission to access your Drive files. Hit Accept / Allow for any following dialog. Close the browser window.

* Next, create a directory where your Google Drive files will be mounted, preferably in your home directory, and mount Google Drive to that directory.
<pre style="margin:0 0 0 1.5em">
mkdir ~/googledrive
google-drive-ocamlfuse ~/googledrive
</pre>

You can check if Google Drive is mounted by performing:
<pre style="margin:0 0 0 1.5em">
mount
</pre>

You can also check how much space you have left:
<pre style="margin:0 0 0 1.5em">
df
</pre>

If you want to unmount, simply run
<pre style="margin:0 0 0 1.5em">
fusermount -u ~/googledrive
</pre>

* To mount Google Drive at startup, set the following command to run at boot with Session and Startup.
<pre style="margin:0 0 0 1.5em">
google-drive-ocamlfuse -label default /home/<user>/googledrive
</pre>

A word of warning, large files such as movies or large videos don't work too well with google-drive-ocamlfuse using default settings. Files are cached to ~/.gdfuse/default/cache. A config file can be found in the directory above that, with parameters to allow for streaming larger files, cache size, etc.. The streaming larger files parameter is perfect for large videos and movies. For more information, check out gdfuse on GitHub.

Adapted from: http://xmodulo.com/mount-google-drive-linux.html

=== Skype ===

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository "deb http://archive.canonical.com/ $(lsb_release -sc) partner"
sudo apt-get update && sudo apt-get install skype
</pre>

Source: https://help.ubuntu.com/community/Skype

See also: https://www.skype.com/en/download-skype/skype-for-linux/

=== Wine ===

Wine has been a source of frustration. These instructions are verified on a fresh install of 1.0beta2.

<pre style="margin:0 0 0 1.5em">
sudo dpkg --add-architecture i386
sudo add-apt-repository ppa:ubuntu-wine/ppa
sudo apt-get update
sudo apt-get install wine1.8
</pre>

=== Simple Screen Recorder ===
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository -y ppa:maarten-baert/simplescreenrecorder
sudo apt-get update
sudo apt-get install simplescreenrecorder
</pre>

=== Spotify ===

<pre style="margin:0 0 0 1.5em">
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys BBEBDCB318AD50EC6865090613B00F1FD2C19886
echo deb http://repository.spotify.com stable non-free | sudo tee /etc/apt/sources.list.d/spotify.list
sudo apt-get update
sudo apt-get install spotify-client
</pre>

Source: https://www.spotify.com/us/download/linux/

=== Kodi Media Center ===

<pre style="margin:0 0 0 1.5em">
sudo apt-get install python-software-properties pkg-config software-properties-common
sudo add-apt-repository -y ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi
</pre>

== Games ==

=== Steam ===
<pre style="margin:0 0 0 1.5em">
curl -O http://repo.steampowered.com/steam/archive/precise/steam_latest.deb
sudo dpkg -i steam_latest.deb
</pre>

Then launch Steam from the application launcher. Your user must be in the "sudo" group (if it is not, the dpkg command above will also fail), so that the installer can do all the things it needs to do.

=== Minecraft ===
<pre style="margin:0 0 0 1.5em">
sudo bash
apt-get install default-jre
curl -o /usr/local/bin/Minecraft.jar https://s3.amazonaws.com/Minecraft.Download/launcher/Minecraft.jar
curl -o /usr/share/pixmaps/minecraft.png https://chrx.org/minecraft.png
mkdir -p /usr/local/share/applications
cat > /usr/local/share/applications/minecraft.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Minecraft
Comment=Minecraft
Exec=java -jar /usr/local/bin/Minecraft.jar
Icon=/usr/share/pixmaps/minecraft.png
Categories=Game;
EOF
</pre>

== Utilities ==

=== grsync ===
Graphical lightweight version of rsync to back up data between drives
<pre style="margin:0 0 0 1.5em">
sudo apt-get install grsync
</pre>

=== aptik ===
Backup APT sources/repository data
<pre style="margin:0 0 0 1.5em">
sudo apt-add-repository -y ppa:teejee2008/ppa
sudo apt-get update
sudo apt-get install aptik
</pre>

=== OpenVPN ===
Install the following two packages to get OpenVPN connectivity with your favorite VPN service.
<pre style="margin:0 0 0 1.5em">
sudo apt-get install openvpn network-manager-openvpn
</pre>

=== caffeine-plus ===
Used to keep the screen awake with full screen applications such as full screen video.
<pre style="margin:0 0 0 1.5em">
sudo add-apt-repository ppa:nilarimogard/webupd8
sudo apt-get update
sudo apt-get install caffeine-plus
</pre>
Source: [http://www.webupd8.org/2014/08/screensaver-lock-screen-inhibitor.html Webupd8]

== Hardware Optimization ==

=== Battery Tuning ===

==== Powertop ====
Monitor process and device power consumption. Includes a handy auto-tune option which can be run at startup that helps to minimize power consumption. Powertop also provides a calibration option, which some people have reported issues with (locks up device?).

<pre style="margin:0 0 0 1.5em">
sudo apt-get install powertop
sudo powertop
</pre>

Powertop needs to be run every time the system boots. Expand for instructions:

<div class="mw-collapsible mw-collapsed" style="border:1px #666666 dashed;padding:0.5em 1em;min-height:2em;margin:0 2em;background-color:#eee;">

Create <code>/etc/systemd/system/powertop.service</code> with the following content:

<pre style="margin:0 0 0 1.5em">
[Unit]
Description=Powertop tunings

[Service]
Type=oneshot
ExecStart=/usr/bin/powertop --auto-tune

[Install]
WantedBy=multi-user.target
</pre>

Then reboot.

Source: https://wiki.archlinux.org/index.php/Powertop
</div>

==== TLP ====

Advanced power management tool that also provides a default configuration optimized for battery life for "install and forget it" benefits. TLP has reportedly provided some improvement to battery life. Your mileage may vary.

<pre style="margin:0 0 0 1.5em">sudo add-apt-repository ppa:linrunner/tlp
sudo apt-get install tlp
sudo tlp start</pre>

== Miscellaneous ==

These have been discussed, but are not presently candidates for inclusion in the default installation. They might be of special interest, might have important caveats, or might be the unchosen of other options. Presented here for convenience.

==== Hardware temperature monitor ====
* <code>xfce4-sensors-plugin</code> from Ubuntu repositories. '''WARNING:''' Do '''not''' select <code>tachos</code>. It will crash your desktop.

==== Clipboard Manager ====
* <code>clipit</code> from Ubuntu repositories. Developer homepage is missing. Be conscious of the security implications of all clipboard managers.

==== Video Player ====
* https://mpv.io/ Lightweight, but very minimal UI
* <code>smplayer</code> from Ubuntu repositories. Lightweight.

==== Screen Recorder ====
* <code>kazam</code> from Ubuntu repositories. Alternative to <code>simplescreenrecorder</code>, above. See https://apps.ubuntu.com/cat/applications/kazam/ for more info.

==== Disk Usage/Performance Indicators ====
* <code>xfce4-goodies</code> from Ubuntu repositories includes a free space checker applet
* <code>xfce4-diskperf-plugin</code> from Ubuntu repositories is a disk performance monitor applet, and shows usage as well

Media keys and default keybindings

2016-07-29T01:18:02Z

Dvdmuckle: /* Key Mappings */

GalliumOS includes five keyboard layouts customized for Chromebooks. They can be configured from the GalliumOS/Whisker Menu, in Settings >> Keyboard >> Layout >> Keyboard Model.

Media keys and Function keys can be accessed either with or without pressing the "Overlay" key first, depending on your choice of keyboard layout.

== Keyboard Layouts ==

{| class="wikitable"
!Layout Name
!Overlay Key
!Top row keys (alone)
!Top row keys (with Overlay)
|-
| Chromebook / No overlay / F keys mapped to media keys
| None
| Media keys
| Media keys
|-
| Chromebook / Right alt overlay
| <code>Right-Alt</code>
| Function keys
| Media keys
|-
| style="background-color:#e0e8ff" | '''Chromebook / Right alt overlay / F keys mapped to media keys'''<br>'''** default for GalliumOS 1.0 and 2.0 **'''
| style="background-color:#e0e8ff" | <code>Right-Alt</code>
| style="background-color:#e0e8ff" | Media keys
| style="background-color:#e0e8ff" | Function keys
|-
| Chromebook / Search overlay<br>previous default (1.0beta1), and Crouton default
| <code>Super (Search)</code>
| Function keys
| Media keys
|-
| Chromebook / Search overlay / F keys mapped to media key
| <code>Super (Search)</code>
| Media keys
| Function keys
|}

== Key Mappings ==

{| class="wikitable"
!Key
!Combination
|-
|F1-F10
|Accessed directly or with <code>Overlay</code>, depending on Keyboard layout
|-
|F11
|
|-
|F12
|
|-
|Home
|<code>Overlay</code> + <code>Left Arrow</code>
|-
|End
|<code>Overlay</code> + <code>Right Arrow</code>
|-
|Page Up
|<code>Overlay</code> + <code>Up Arrow</code>
|-
|Page Down
|<code>Overlay</code> + <code>Down Arrow</code>
|-
|Insert
|<code>Overlay</code> + <code>.</code>
|-
|Delete
|<code>Overlay</code> + <code>Backspace</code>
|-
|Caps Lock
|<code>Overlay</code> + <code>Left Alt</code> (Will not work with <code>Right Alt</code> as <code>Overlay</code>)
|}

Crouton keyboard layout: https://github.com/dnschneid/crouton/wiki/Keyboard

Other discussion: https://github.com/GalliumOS/galliumos-distro/issues/50

== Keyboard Shortcuts ==

{| class="wikitable"
!Key
!Combination
|-
|Screenshot (fullscreen)
|<code>Ctrl</code> + <code>F5(display)</code>
|-
|Screenshot (window)
|<code>Ctrl</code> + <code>Shift</code> + <code>F5(display)</code>
|-
|Whisker Menu/Search
|<code>Super</code> + <code>M</code> (unless Super is Overlay)<br><code>Left-Alt</code> + <code>M</code>
|-
|Keyboard Backlight Toggle
|<code>Overlay</code> + <code>0</code>
|-
|Keyboard Backlight Brightness Down
|<code>Overlay</code> + <code>-</code>
|-
|Keyboard Backlight Brightness Up
|<code>Overlay</code> + <code>=</code>
|}

Media keys and default keybindings

2016-07-29T01:16:55Z

Dvdmuckle: /* Key Mappings */

GalliumOS includes five keyboard layouts customized for Chromebooks. They can be configured from the GalliumOS/Whisker Menu, in Settings >> Keyboard >> Layout >> Keyboard Model.

Media keys and Function keys can be accessed either with or without pressing the "Overlay" key first, depending on your choice of keyboard layout.

== Keyboard Layouts ==

{| class="wikitable"
!Layout Name
!Overlay Key
!Top row keys (alone)
!Top row keys (with Overlay)
|-
| Chromebook / No overlay / F keys mapped to media keys
| None
| Media keys
| Media keys
|-
| Chromebook / Right alt overlay
| <code>Right-Alt</code>
| Function keys
| Media keys
|-
| style="background-color:#e0e8ff" | '''Chromebook / Right alt overlay / F keys mapped to media keys'''<br>'''** default for GalliumOS 1.0 and 2.0 **'''
| style="background-color:#e0e8ff" | <code>Right-Alt</code>
| style="background-color:#e0e8ff" | Media keys
| style="background-color:#e0e8ff" | Function keys
|-
| Chromebook / Search overlay<br>previous default (1.0beta1), and Crouton default
| <code>Super (Search)</code>
| Function keys
| Media keys
|-
| Chromebook / Search overlay / F keys mapped to media key
| <code>Super (Search)</code>
| Media keys
| Function keys
|}

== Key Mappings ==

{| class="wikitable"
!Key
!Combination
|-
|F1-F10
|Accessed directly or with <code>Overlay</code>, depending on Keyboard layout
|-
|F11
|
|-
|F12
|
|-
|Home
|<code>Overlay</code> + <code>Left Arrow</code>
|-
|End
|<code>Overlay</code> + <code>Right Arrow</code>
|-
|Page Up
|<code>Overlay</code> + <code>Up Arrow</code>
|-
|Page Down
|<code>Overlay</code> + <code>Down Arrow</code>
|-
|Insert
|<code>Overlay</code> + <code>.</code>
|-
|Delete
|<code>Overlay</code> + <code>Backspace</code>
|-
|Caps Lock
|<code>Overlay</code> + <code>Left Alt</code>
|}

Crouton keyboard layout: https://github.com/dnschneid/crouton/wiki/Keyboard

Other discussion: https://github.com/GalliumOS/galliumos-distro/issues/50

== Keyboard Shortcuts ==

{| class="wikitable"
!Key
!Combination
|-
|Screenshot (fullscreen)
|<code>Ctrl</code> + <code>F5(display)</code>
|-
|Screenshot (window)
|<code>Ctrl</code> + <code>Shift</code> + <code>F5(display)</code>
|-
|Whisker Menu/Search
|<code>Super</code> + <code>M</code> (unless Super is Overlay)<br><code>Left-Alt</code> + <code>M</code>
|-
|Keyboard Backlight Toggle
|<code>Overlay</code> + <code>0</code>
|-
|Keyboard Backlight Brightness Down
|<code>Overlay</code> + <code>-</code>
|-
|Keyboard Backlight Brightness Up
|<code>Overlay</code> + <code>=</code>
|}

Media

2016-05-17T18:58:23Z

Dvdmuckle: /* GalliumOS Media Coverage */

== GalliumOS Media Coverage ==

Media outlets big and small. If you have written about GalliumOS, or know someone who has, please let us know so we can add you to our list.

For media inquiries, please reach us at contact-at-galliumos-dot-org!

* '''Jean-Pierre Buntinx '''[https://medium.com/@jdebunt/why-i-switched-to-galliumos-on-my-acer-c720-chromebook-a61e38b2f24d#.frabh8516 Why I Switched to GalliumOS On My Acer C720] Chromebook (2016-05-17)
* '''tech lore by igor''' [https://techlorebyigor.blogspot.com/2016/04/my-review-of-galliumos-v10.html My Review of GalliumOS v1.0] (2016-04-05) (we're not the North Korean mafia, we super promise!)
* '''Foss Force''' [http://fossforce.com/2016/03/screencast-look-galliumos A Screencast Look at GalliumOS] (2016-03-25)
* '''Linux Action Show''' [http://www.jupiterbroadcasting.com/92926/pre-scale-las-las-401/ Pre SCaLE LAS | LAS 401] (2016-01-24)
* '''Linux.com''' [http://www.linux.com/learn/tutorials/870387-galliumos-the-ideal-linux-distribution-for-chromebook-hardware/ GalliumOS: The Ideal Linux Distribution for Chromebook Hardware] (2015-12-05)
* '''ITWorld.com''' [http://www.itworld.com/article/3004051/linux/galliumos-beta-released-for-chromebooks-and-chromeboxes.html GalliumOS Linux beta released for Chromebooks and Chromeboxes] (2015-11-12)
* '''ChromeCrunch''' [http://chromecrunch.com/galliumos-for-chromeos-is-finally-here-beta-1-is-ready-to-install-on-chromebook/ GalliumOS For ChromeOS Is Finally Here! Beta 1 Is Ready To Install] (2015-11-12)
* '''Elio's Corner''' [http://elioqoshi.me/2015/11/galliumos-beta/ GalliumOS – A Linux alternative for ChromeOS] (2015-11-12)
* '''ColtonDRG.com''' [https://coltondrg.com/2015/11/galliumos-beta-1-released/ GalliumOS Beta 1 Released] (2015-11-11)

== Non-English ==

We don't really know what these say... We hope they're good! :D

* '''linuxadictos''' (es) [http://www.linuxadictos.com/galliumos-beta-disponible-de-la-mejor-distro-al-estilo-chrome-os.html GalliumOS beta disponible de la mejor distro al estilo Chrome OS] (2015-11-17)
* '''Cloudspace.news''' (ru) [http://cloudspace.news/linux-chromebook-galliumos/ Опубликована первая версия GalliumOS] (2015-11-13)

Installing/Peppy

2016-05-11T21:40:44Z

Dvdmuckle: /* Backup ChromeOS */

=== Creating the USB drive ===
The first thing you must do is create the bootable USB flash drive. Download the correct image for your device on your Linux machine (keeping in mind the proper chipset) and follow these steps:
# Download the '''Haswell''' GalliumOS ISO from https://galliumos.org/download
# Plug in your USB drive
# See [[Installing/Creating_Bootable_USB]] for detailed USB drive creation instructions for Linux, Mac OS X, Windows, and ChromeOS.

=== Backup ChromeOS ===
Before you install GalliumOS, it is highly recommended to create a recovery USB flash drive. ChromeOS offers a simple solution for this. Just follow these steps:
# Boot up your Chromebook and login
# Plug in a spare ~2GB+ USB flash drive
# Open the Chrome browser
# Install the [https://chrome.google.com/webstore/detail/chromebook-recovery-utili/jndclpdbaamdhonoechobihbbiimdgai ChromeOS Recovery Utility]
# Follow the simple instructions
When all is said and done, you'll have a recovery drive to use to get your system back where it was (should you not like either Linux install or something goes wrong).

Now, it's time to start the install process.

=== Boot into Developer mode ===
The next step is to reboot your device in developer mode. This is done by holding down the Escape and Refresh button and then tapping the Power button. When the device reboots, you will be greeted by a screen with a warning. Tap CTRL+D to continue on. You now have access to the developer mode and can enable the necessary boot flags. Here’s what you need to do:
# Press CTRL+Alt+T
# In the crosh screen, type <code>shell</code> and hit Enter
# Enable to necessary flags with the terminal command: <code>sudo crossystem dev_boot_usb=1 dev_boot_legacy=1</code>

=== Boot into Live Session of GalliumOS and Install ===
You can now insert your GalliumOS USB drive and reboot your Chromebook.

'''If your Chromebook has both USB2.0 (black) ports and USB3.0 (blue) ports, be sure to install your USB drive into a USB2.0 (black) port!'''

When you are presented with the same warning screen as earlier, hit CTRL+L and the device will boot from the USB drive. If the system won't boot into the live session, add mem=1024mb argument to the grub boot line. After the live session loads, you can choose to install to the hard drive. Keep in mind that every time you boot up you Chromebook you will nee to hit CTRL+L to bypass the developer mode screen.

Source: https://www.linux.com/learn/tutorials/870387-galliumos-the-ideal-linux-distribution-for-chromebook-hardware

Firmware

2016-04-18T03:38:39Z

Dvdmuckle: Changed notes for CoolStar's firmware to reflect addition of said firmware to MattDevo's script. Left existing install guides for posterity's sake.

__TOC__

== Custom Firmware ==

The stock/factory firmware on some Chromebooks and Chromeboxes contains a legacy boot payload (RW_LEGACY) capable of running Linux out of the box; however, many ChromeOS devices, particularly those with BayTrail/Braswell CPUs, do not include this capability stock and must use a 3rd party firmware update in order to run GalliumOS (or any other OS).

Three types of custom firmware updates are available (though not all types are available for every device):

=== Types ===
# '''RW_LEGACY'''
#* Updates/replaces the stock legacy boot payload (SeaBIOS) included on many models; supplements the ChromeOS / secure boot payload (BOOT_STUB)
#* Leaves all stock functionality intact, including the developer mode boot (white "OS verification is OFF") screen
#* Allows device to dual-boot GalliumOS alongside ChromeOS
#* Does not require disabling the firmware write-protect
#* Carries zero risk of bricking the device
#* On some models, includes bugfixes and enables additional functionality
# '''BOOT_STUB'''
#* Replaces the ChromeOS verified boot payload with a legacy boot payload (SeaBIOS)
#* Removes the developer mode boot (white "OS verification is OFF") screen
#* Requires the firmware write-protect screw to be removed
#* Removes the ability to run ChromeOS, creating a small risk of bricking your device
#* Leaves the recovery mode (ESC + REFRESH + POWER) functionality of the stock ROM intact
#** If you engage this key sequence, device will reboot and try to run ChromeOS Recovery (which will fail)
#** This process will repeat on every boot until you disassemble the device and briefly disconnect the battery
# '''Full Firmware / ROM'''
#* A complete firmware image which replaces the hardware init component (coreboot) and payload components (BOOT_STUB, RW_LEGACY) of the stock firmware with updated and/or customized versions of coreboot and SeaBIOS
#* Removes the developer mode boot (white "OS verification is OFF") screen
#* Removes the ability to run ChromeOS, creating a small risk of bricking your device
#* Offers the best support for booting all OSes besides ChromeOS (including Windows).
#* On many models, adds full hardware support for virtualization (vmx / VT-x)
#* Fixes many bugs and/or idiosyncrasies associated with the stock firmware (but could potentially add new ones)
#* Essentially turns your ChromeOS device into a "regular" PC / laptop

=== Availability Options ===

Check [[Hardware Compatibility]] and the appropriate [[Support]] page to determine the status of your model.

There are several custom firmware options available, depending on your Chromebook/box model class, and the features you require:

{| class="wikitable"
|-
! scope="col"| Firmware Provider / Link
! scope="col"| ARM
! scope="col"| Pineview
! scope="col"| Sandy/Ivy Bridge
! scope="col"| Haswell
! scope="col"| Broadwell
! scope="col"| Bay Trail
! scope="col"| Braswell
! scope="col"| notes
|-
| style="text-align:center" | [https://www.reddit.com/r/chrultrabook/comments/3jl45k/getting_started_guide/ CoolStar]
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Full Firmware (Chromebooks)
| style="text-align:center;background-color:#ccffcc" | Full Firmware (Chromebooks)
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ffe8e8" | No
| • Fixes factory firmware bugs<br>• Boots Linux, Mac OS X, and Windows!<br>• Install Guide: [https://docs.google.com/document/d/1yfIjx-fJXPvs6EwSdjRnokJ6ktNxeExZmVin9mamVZU/edit Haswell], [https://docs.google.com/document/d/1nFZmoRzQ03btPCGVSa4ku6JPQik-SxD__zOd1CoB2yg/edit Broadwell]• Can also be installed with MattDevo's script<br>• [https://github.com/coolstar/coreboot Firmware build scripts]
|-
| style="text-align:center" | [https://johnlewis.ie/custom-chromebook-firmware/rom-download/ johnlewis.ie]
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Full Firmware, BOOT_STUB (all)
| style="text-align:center;background-color:#ccffcc" | Full Firmware, BOOT_STUB, RW_LEGACY (all)
| style="text-align:center;background-color:#ccffcc" | RW_LEGACY (all)
| style="text-align:center;background-color:#ccffcc" | BOOT_STUB (all)
| style="text-align:center;background-color:#ffe8e8" | No
| • Fixes factory firmware bugs<br>• General purpose firmware for Linux<br>• Single script works for all supported models<br>• Firmware build scripts/configs not published
|-
| style="text-align:center" | [https://github.com/MattDevo/scripts MattDevo<br>(MrChromebox)]
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ffe8e8" | No
| style="text-align:center;background-color:#ccffcc" | Full Firmware (Chromeboxes)
| style="text-align:center;background-color:#ccffcc" | Full Firmware (Chromeboxes), RW_LEGACY (all)
| style="text-align:center;background-color:#ccffcc" | Full Firmware (Chromeboxes), RW_LEGACY (all)
| style="text-align:center;background-color:#ccffcc" | BOOT_STUB (all), RW_LEGACY (all)
| style="text-align:center;background-color:#ffe8e8" | No
| • Fixes factory firmware bugs<br>• Headless boot support for servers<br>• PXE booting support<br>• Supports integration of [http://kodi.tv/about/ Kodi Media Center]<br>• [https://github.com/MattDevo/coreboot Firmware source/build scripts] and [https://github.com/MattDevo/SeaBIOS payload source]
|}

Additions and corrections, '''please''' let us know: <code>contact</code>@<code>galliumos.org</code>

== Firmware and NVRAM Flags ==

Both the crossystem and GBB flags listed below are only relevant when booting legacy mode via RW_LEGACY (CTRL+L on dev mode boot screen); they do not have any effect when using a custom BOOT_STUB firmware.

=== crossystem ===

ChromeOS System (crossystem) flags are firmware level settings which are stored in volatile memory, and are therefore lost/reset if the battery on your Chromebook is fully drained or disconnected; they do not require firmware write protect to be disabled in order to set/unset them.

The <code>dev_boot_legacy</code> flag needs to be set (=1) in order to enable legacy booting (and installation/booting of GalliumOS). Most users do not need to set this manually, as it is set automatically when installing a RW_LEGACY firmware payload, but should be aware that it can be unset via battery drain/disconnect. This can be problematic if GalliumOS is the only OS installed on the system (as it would require the user to restore ChromeOS to re-enable legacy booting), and so it is recommended that users who are not dual-booting set the GBB flags below to ensure legacy boot capability is not "turned off" if battery power is lost.

Note: many other sources mistakenly insist that <code>dev_boot_usb</code> needs to be set as well, but it does not - that flag only enables booting ChromeOS (or an OS with a ChromeOS-signed kernel) via CTRL+U on the developer mode boot screen; it has nothing to do with booting from USB in legacy boot mode (CTRL+L).

=== GBB Flags ===

Google Binary Block (GBB) flags are firmware level settings stored directly in the firmware flash chip itself in a read-only (RO) area, and so require the firmware write protect screw to be removed before setting. The GBB flags are used to set the default boot mode (ChromeOS or legacy boot), developer mode boot screen timeout (2s or 30s), prevent exiting developer mode via spacebar, and to enable legacy booting regardless of crossystem setting, among other things.

Most users should not attempt to set these manually, but instead use MattDevo's (/u/MrChromebox) ChromeOS firmware utility script to set them based on their preferred default boot mode and boot timeout (the script automatically sets the dev mode and legacy boot mode overrides for all options except factory default). For those curious, a full description of all the GBB flags can be [https://chromium.googlesource.com/chromiumos/platform/vboot_reference/+/master/firmware/include/gbb_header.h found in the Google source code here]

Installing/Preparing

2016-04-02T22:05:25Z

Dvdmuckle: /* RW_LEGACY */ Noted additional options with MattDevo's script

If you have already used Linux on your Chromebook in the past (Crouton does NOT count), you probably don't need to do this. This article will cover the very minimal requirements for making it work on each generation of Chromebook. This means we won't flash any firmware if we don't need to. If you want instructions for flashing firmware, see [[Firmware]]. Please note that this process can be very dangerous, so please carefully read everything and do not skip any steps. We are not responsible if you brick your Chromebook, even though we think it sucks that you did. Despite the fact that the Chromebook Pixel and 2015 Chromebook Pixel are Sandy Bridge and Broadwell respectively, you should use the Haswell process for both of them. We know this doesn't make any sense, but just trust us.

== Sandy Bridge / Ivy Bridge ==

With the exception of the original Chromebook Pixel, on Sandy Bridge Chromebooks, you will have to flash your firmware. See [[Firmware]].

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now, we need to flash the firmware. Unfortunately, this means you will need to open your Chromebook. You need to open your Chromebook and either bridge the jumper with a piece of tin foil, or remove the screw that governs hardware write protection. This process varies from model to model, so you should look up how to do it on the internet. We do hope to have a guide for all models here at some point, so you don't have to go searching, but it's not ready yet, so you'll have to do some googling.

Once you've disabled the write protection, we can really get started. First, log into your Chromebook and make sure it's connected to the internet. Next, press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you just need to download and run John Lewis' script. Again, make very sure you have a stable internet connection before doing this. When you're positive you're ready, run

<code>cd; rm -f flash_chromebook_rom.sh; curl -L -O <nowiki>https://johnlewis.ie/flash_chromebook_rom.sh</nowiki>; sudo -E bash flash_chromebook_rom.sh</code>

and follow the onscreen prompts carefully. Hopefully, if everything went well, you should be good to go. Reboot your computer, plug in your GalliumOS USB, and start installing! Note that after completing this process your computer will be unable to boot. You must insert a USB drive with an operating system on it (hopefully GalliumOS :P) and install it to the hard drive.

== Haswell ==

Haswell Chromebooks are mostly incredibly easy to work with. There is no additional firmware needed. You just need to enable developer mode, enable a couple boot flags, and you're good to go!

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now you need to enable a couple boot flags, and you're good to go. Log into your Chromebook and connect it to the internet. Press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you just need to enable a couple boot flags. You can skip this step if you plan on using chrx to dualboot GalliumOS with ChromeOS.

<code>sudo crossystem dev_boot_usb=1 dev_boot_legacy=1</code>

If everything went smoothly, you should be ready to go. Just reboot your computer, pop in your GalliumOS USB, press Ctrl+L at the scary white screen, and install away! If you want to remove the scary white screen, or boot to Linux by default, see flashing [[Firmware]].

== Broadwell ==

With the exception of the 2015 Chromebook Pixel, Broadwell is the same basic process as Haswell, but it doesn't come with SeaBIOS, so we'll have to install it before we can use it. Luckily, we don't have to open up the Chromebook, and the process is very simple.

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now you need to enable a couple boot flags, and you're good to go. Log into your Chromebook and connect it to the internet. Press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you need to download and run John Lewis' script. Again, make very sure you have a stable internet connection before doing this. When you're positive you're ready, run

<code>cd; rm -f flash_chromebook_rom.sh; curl -L -O <nowiki>https://johnlewis.ie/flash_chromebook_rom.sh</nowiki>; sudo -E bash flash_chromebook_rom.sh</code>

and follow the onscreen prompts carefully. If everything went smoothly, you're almost ready to go. Now, you just need to enable a couple boot flags. You can skip this step if you're planning to use chrx to dualboot GalliumOS with ChromeOS.

<code>sudo crossystem dev_boot_usb=1 dev_boot_legacy=1</code>

If everything went smoothly, you should be ready to go. Just reboot your computer, pop in your GalliumOS USB, press Ctrl+L at the scary white screen, and install away! Unfortunately, there is no way to remove the scary white screen on Broadwell (yet!), but you can set it up to boot Linux by default. For more information, see [[Firmware]]

== Bay Trail ==

On Bay Trail Chromebooks, you will have to flash your firmware. See [[Firmware]].

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now, we need to flash the firmware. There are two options: MattDevo's RW_LEGACY or John Lewis' BOOT_STUB. If you wish to dual boot your device or don't want to open up the Chromebook, you will need RW_LEGACY.

=== BOOT_STUB ===
For the latter, you will need to open your Chromebook and either bridge the jumper with a piece of tin foil, or remove the screw that governs hardware write protection. This process varies from model to model, so you should look up how to do it on the internet. We do hope to have a guide for all models here at some point, so you don't have to go searching, but it's not ready yet, so you'll have to do some googling. Also note that this process is very complicated on the Toshiba Chromebook 2 (2014 version) because of Toshiba's poor design.

Once you've disabled the write protection, we can really get started. First, log into your Chromebook and make sure it's connected to the internet. Next, press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you just need to download and run John Lewis' script. Again, make very sure you have a stable internet connection before doing this. When you're positive you're ready, run

<code>cd; rm -f flash_chromebook_rom.sh; curl -L -O <nowiki>https://johnlewis.ie/flash_chromebook_rom.sh</nowiki>; sudo -E bash flash_chromebook_rom.sh</code>

and follow the onscreen prompts carefully. Hopefully, if everything went well, you should be good to go. Reboot your computer, plug in your GalliumOS USB, and start installing! Note that after completing this process your computer will be unable to boot. You must insert a USB drive with an operating system on it (hopefully GalliumOS :P) and install it to the hard drive.

=== RW_LEGACY ===
To flash RW_LEGACY, the write protect does not need to be disabled, but can be for additional options. Instead, use the above steps to gain bash and run the following script in place of John Lewis' script.

<code><nowiki>cd; curl -L -O https://goo.gl/1hFfO3; sudo bash 1hFfO3</nowiki></code>

There are also options such as faster boot and disabling the scary boot screen. These options will not work unless you have removed the write protect.

== Braswell ==

We know nothing about Braswell yet. We'll let you know as soon as we have information about running GalliumOS on Braswell.

Installing/Preparing

2016-04-02T21:45:26Z

Dvdmuckle: /* Bay Trail */ Added instructions for RW_LEGACY

If you have already used Linux on your Chromebook in the past (Crouton does NOT count), you probably don't need to do this. This article will cover the very minimal requirements for making it work on each generation of Chromebook. This means we won't flash any firmware if we don't need to. If you want instructions for flashing firmware, see [[Firmware]]. Please note that this process can be very dangerous, so please carefully read everything and do not skip any steps. We are not responsible if you brick your Chromebook, even though we think it sucks that you did. Despite the fact that the Chromebook Pixel and 2015 Chromebook Pixel are Sandy Bridge and Broadwell respectively, you should use the Haswell process for both of them. We know this doesn't make any sense, but just trust us.

== Sandy Bridge / Ivy Bridge ==

With the exception of the original Chromebook Pixel, on Sandy Bridge Chromebooks, you will have to flash your firmware. See [[Firmware]].

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now, we need to flash the firmware. Unfortunately, this means you will need to open your Chromebook. You need to open your Chromebook and either bridge the jumper with a piece of tin foil, or remove the screw that governs hardware write protection. This process varies from model to model, so you should look up how to do it on the internet. We do hope to have a guide for all models here at some point, so you don't have to go searching, but it's not ready yet, so you'll have to do some googling.

Once you've disabled the write protection, we can really get started. First, log into your Chromebook and make sure it's connected to the internet. Next, press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you just need to download and run John Lewis' script. Again, make very sure you have a stable internet connection before doing this. When you're positive you're ready, run

<code>cd; rm -f flash_chromebook_rom.sh; curl -L -O <nowiki>https://johnlewis.ie/flash_chromebook_rom.sh</nowiki>; sudo -E bash flash_chromebook_rom.sh</code>

and follow the onscreen prompts carefully. Hopefully, if everything went well, you should be good to go. Reboot your computer, plug in your GalliumOS USB, and start installing! Note that after completing this process your computer will be unable to boot. You must insert a USB drive with an operating system on it (hopefully GalliumOS :P) and install it to the hard drive.

== Haswell ==

Haswell Chromebooks are mostly incredibly easy to work with. There is no additional firmware needed. You just need to enable developer mode, enable a couple boot flags, and you're good to go!

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now you need to enable a couple boot flags, and you're good to go. Log into your Chromebook and connect it to the internet. Press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you just need to enable a couple boot flags. You can skip this step if you plan on using chrx to dualboot GalliumOS with ChromeOS.

<code>sudo crossystem dev_boot_usb=1 dev_boot_legacy=1</code>

If everything went smoothly, you should be ready to go. Just reboot your computer, pop in your GalliumOS USB, press Ctrl+L at the scary white screen, and install away! If you want to remove the scary white screen, or boot to Linux by default, see flashing [[Firmware]].

== Broadwell ==

With the exception of the 2015 Chromebook Pixel, Broadwell is the same basic process as Haswell, but it doesn't come with SeaBIOS, so we'll have to install it before we can use it. Luckily, we don't have to open up the Chromebook, and the process is very simple.

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now you need to enable a couple boot flags, and you're good to go. Log into your Chromebook and connect it to the internet. Press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you need to download and run John Lewis' script. Again, make very sure you have a stable internet connection before doing this. When you're positive you're ready, run

<code>cd; rm -f flash_chromebook_rom.sh; curl -L -O <nowiki>https://johnlewis.ie/flash_chromebook_rom.sh</nowiki>; sudo -E bash flash_chromebook_rom.sh</code>

and follow the onscreen prompts carefully. If everything went smoothly, you're almost ready to go. Now, you just need to enable a couple boot flags. You can skip this step if you're planning to use chrx to dualboot GalliumOS with ChromeOS.

<code>sudo crossystem dev_boot_usb=1 dev_boot_legacy=1</code>

If everything went smoothly, you should be ready to go. Just reboot your computer, pop in your GalliumOS USB, press Ctrl+L at the scary white screen, and install away! Unfortunately, there is no way to remove the scary white screen on Broadwell (yet!), but you can set it up to boot Linux by default. For more information, see [[Firmware]]

== Bay Trail ==

On Bay Trail Chromebooks, you will have to flash your firmware. See [[Firmware]].

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now, we need to flash the firmware. There are two options: MattDevo's RW_LEGACY or John Lewis' BOOT_STUB. If you wish to dual boot your device or don't want to open up the Chromebook, you will need RW_LEGACY.

=== BOOT_STUB ===
For the latter, you will need to open your Chromebook and either bridge the jumper with a piece of tin foil, or remove the screw that governs hardware write protection. This process varies from model to model, so you should look up how to do it on the internet. We do hope to have a guide for all models here at some point, so you don't have to go searching, but it's not ready yet, so you'll have to do some googling. Also note that this process is very complicated on the Toshiba Chromebook 2 (2014 version) because of Toshiba's poor design.

Once you've disabled the write protection, we can really get started. First, log into your Chromebook and make sure it's connected to the internet. Next, press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you just need to download and run John Lewis' script. Again, make very sure you have a stable internet connection before doing this. When you're positive you're ready, run

<code>cd; rm -f flash_chromebook_rom.sh; curl -L -O <nowiki>https://johnlewis.ie/flash_chromebook_rom.sh</nowiki>; sudo -E bash flash_chromebook_rom.sh</code>

and follow the onscreen prompts carefully. Hopefully, if everything went well, you should be good to go. Reboot your computer, plug in your GalliumOS USB, and start installing! Note that after completing this process your computer will be unable to boot. You must insert a USB drive with an operating system on it (hopefully GalliumOS :P) and install it to the hard drive.

=== RW_LEGACY ===
To flash RW_LEGACY, the write protect does not need to be disabled. Instead, use the above steps to gain bash and run the following script in place of John Lewis' script.

<code><nowiki>cd; curl -L -O https://goo.gl/1hFfO3; sudo bash 1hFfO3</nowiki></code>

== Braswell ==

We know nothing about Braswell yet. We'll let you know as soon as we have information about running GalliumOS on Braswell.

Additional Software

2016-02-18T16:09:43Z

Dvdmuckle: Changed "Startup Applications" to "Session and Startup"

Installing/Preparing

2016-02-07T19:16:58Z

Dvdmuckle: Changed links to the non-existent Firmware Flashing to Firmware

If you have already used Linux on your Chromebook in the past (Crouton does NOT count), you probably don't need to do this. This article will cover the very minimal requirements for making it work on each generation of Chromebook. This means we won't flash any firmware if we don't need to. If you want instructions for flashing firmware, see [[Firmware]]. Please note that this process can be very dangerous, so please carefully read everything and do not skip any steps. We are not responsible if you brick your Chromebook, even though we think it sucks that you did. Despite the fact that the Chromebook Pixel and 2015 Chromebook Pixel are Sandy Bridge and Broadwell respectively, you should use the Haswell process for both of them. We know this doesn't make any sense, but just trust us.

== Sandy Bridge / Ivy Bridge ==

With the exception of the original Chromebook Pixel, on Sandy Bridge Chromebooks, you will have to flash your firmware. Luckily, John Lewis' script makes it a very straight forward process. Unfortunately, you'll have to open up your Chromebook. Also note that after completing this process, you will no longer be able to run Chrome OS on your Chromebook, so no dualbooting for this one I'm afraid.

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now, we need to flash the firmware. Unfortunately, this means you will need to open your Chromebook. You need to open your Chromebook and either bridge the jumper with a piece of tin foil, or remove the screw that governs hardware write protection. This process varies from model to model, so you should look up how to do it on the internet. We do hope to have a guide for all models here at some point, so you don't have to go searching, but it's not ready yet, so you'll have to do some googling.

Once you've disabled the write protection, we can really get started. First, log into your Chromebook and make sure it's connected to the internet. Next, press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you just need to download and run John Lewis' script. Again, make very sure you have a stable internet connection before doing this. When you're positive you're ready, run

<code>cd; rm -f flash_chromebook_rom.sh; curl -L -O <nowiki>https://johnlewis.ie/flash_chromebook_rom.sh</nowiki>; sudo -E bash flash_chromebook_rom.sh</code>

and follow the onscreen prompts carefully. Hopefully, if everything went well, you should be good to go. Reboot your computer, plug in your GalliumOS USB, and start installing! Note that after completing this process your computer will be unable to boot. You must insert a USB drive with an operating system on it (hopefully GalliumOS :P) and install it to the hard drive.

== Haswell ==

Haswell Chromebooks are mostly incredibly easy to work with. There is no additional firmware needed. You just need to enable developer mode, enable a couple boot flags, and you're good to go!

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now you need to enable a couple boot flags, and you're good to go. Log into your Chromebook and connect it to the internet. Press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you just need to enable a couple boot flags. You can skip this step if you plan on using chrx to dualboot GalliumOS with ChromeOS.

<code>sudo crossystem dev_boot_usb=1 dev_boot_legacy=1</code>

If everything went smoothly, you should be ready to go. Just reboot your computer, pop in your GalliumOS USB, press Ctrl+L at the scary white screen, and install away! If you want to remove the scary white screen, or boot to Linux by default, see flashing [[Firmware]].

== Broadwell ==

With the exception of the 2015 Chromebook Pixel, Broadwell is the same basic process as Haswell, but it doesn't come with SeaBIOS, so we'll have to install it before we can use it. Luckily, we don't have to open up the Chromebook, and the process is very simple.

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now you need to enable a couple boot flags, and you're good to go. Log into your Chromebook and connect it to the internet. Press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you need to download and run John Lewis' script. Again, make very sure you have a stable internet connection before doing this. When you're positive you're ready, run

<code>cd; rm -f flash_chromebook_rom.sh; curl -L -O <nowiki>https://johnlewis.ie/flash_chromebook_rom.sh</nowiki>; sudo -E bash flash_chromebook_rom.sh</code>

and follow the onscreen prompts carefully. If everything went smoothly, you're almost ready to go. Now, you just need to enable a couple boot flags. You can skip this step if you're planning to use chrx to dualboot GalliumOS with ChromeOS.

<code>sudo crossystem dev_boot_usb=1 dev_boot_legacy=1</code>

If everything went smoothly, you should be ready to go. Just reboot your computer, pop in your GalliumOS USB, press Ctrl+L at the scary white screen, and install away! Unfortunately, there is no way to remove the scary white screen on Broadwell (yet!), but you can set it up to boot Linux by default. For more information, see [[Firmware]]

== Bay Trail ==

On Bay Trail Chromebooks, you will have to flash your firmware. Luckily, John Lewis' script makes it a very straight forward process. Unfortuantely, you'll have to open up your Chromebook. Also note that after completing this porcess, you will no longer be able to run Chrome OS on your Chromebook, so no dualbooting for this one I'm afraid.

First, you need to put the device in developer mode. You'll know if you're in developer mode because you will see the "scary white screen" before you are able to boot the computer. If you are not in developer mode, you can get there by shutting down your computer, holding Esc and Refresh (F3), then powering on the computer. You will see a screen that says "Chrome OS is missing or damaged.". Don't panic! This is normal. You need to press Ctrl-D. Your computer will reboot a few times and you will see a few prompts. Please note that this will wipe your data (similar to a powerwash) so make sure you have backed everything up first. Now that you're in developer mode, proceed to the next step.

Now your Chromebook is rooted. Now, we need to flash the firmware. Unfortunately, this means you will need to open your Chromebook. You need to open your Chromebook and either bridge the jumper with a piece of tin foil, or remove the screw that governs hardware write protection. This process varies from model to model, so you should look up how to do it on the internet. We do hope to have a guide for all models here at some point, so you don't have to go searching, but it's not ready yet, so you'll have to do some googling. Also note that this process is very complicated on the Toshiba Chromebook 2 (2014 version) because of Toshiba's poor design.

Once you've disabled the write protection, we can really get started. First, log into your Chromebook and make sure it's connected to the internet. Next, press Ctrl+Alt+T to open a crosh session. Now, you can open bash by simply typing

<code>shell</code>

and hit enter. Now you should be in bash. You'll have a prompt that looks something like this.

<code>chronos@localhost / $</code>

Now, you just need to download and run John Lewis' script. Again, make very sure you have a stable internet connection before doing this. When you're positive you're ready, run

<code>cd; rm -f flash_chromebook_rom.sh; curl -L -O <nowiki>https://johnlewis.ie/flash_chromebook_rom.sh</nowiki>; sudo -E bash flash_chromebook_rom.sh</code>

and follow the onscreen prompts carefully. Hopefully, if everything went well, you should be good to go. Reboot your computer, plug in your GalliumOS USB, and start installing! Note that after completing this process your computer will be unable to boot. You must insert a USB drive with an operating system on it (hopefully GalliumOS :P) and install it to the hard drive.

== Braswell ==

We know nothing about Braswell yet. We'll let you know as soon as we have information about running GalliumOS on Braswell.

Additional Software

2016-02-04T06:44:21Z

Dvdmuckle: /* Skypehttps://help.ubuntu.com/community/Skype */

Additional Software

2016-02-04T06:43:44Z

Dvdmuckle: /* Skype */

Additional Software

2016-02-04T01:59:16Z

Dvdmuckle: /* Google Drive integration<ref>http://xmodulo.com/mount-google-drive-linux.html</ref> */

Additional Software

2016-02-04T01:46:35Z

Dvdmuckle: /* Google Drive integration<ref>http://xmodulo.com/mount-google-drive-linux.html</ref> */

Additional Software

2016-02-04T01:39:13Z

Dvdmuckle: /* Google Drive integration<ref>http://xmodulo.com/mount-google-drive-linux.html</ref> */

Additional Software

2016-02-03T22:21:03Z

Dvdmuckle: /* Google Drive integration */

Additional Software

2016-02-03T22:17:09Z

Dvdmuckle: /* Google Drive integration */