GalliumOS Wiki - User contributions [en]

FAQ

2018-03-18T12:28:44Z

Onii: /* Software */

== Compatibility and Installation ==
; Will GalliumOS work on my Chromebook/Chromebox?
: Yes, for most devices. See [[Hardware Compatibility]].
: Models with Intel processors are generally well-supported.
: ARM devices are '''not supported'''.

; How do I install GalliumOS? And why would I want to?
: [[Installing GalliumOS]]
: [[Why GalliumOS?]]

; Keyboard mappings? How do I ...
: [[Media keys and default keybindings]]

; If things don't work out, can I go back to ChromeOS?
: Yes, of course. You might prefer to dual-boot (ChromeOS + GalliumOS) first, if you just want to test GalliumOS. See [[Installing]] and [[FAQ/Reverting to ChromeOS]] for details.

== Software ==
; How do I update the OS and apps?
: GalliumOS includes '''GalliumOS Update''' in the Launcher menu. It is a simple wrapper around <code>apt</code> to update installed packages. You will be notified automatically when new software is available.

; Does Minecraft work? Does Steam work?
: Yes and yes. Remember that in most cases, this is not powerful hardware. Minecraft is playable at 30fps on an Acer C720 (2GB Celeron 2955U 1.4GHz), and many Steam titles are playable on the same hardware. A faster processor and additional RAM will improve the experience, as usual.
: See [[Games]] and [[Additional Software]] for more info and installation recommendations.

; How can I run Flash apps/videos (e.g. Twitch)?
: Flash player is not installed by default. You have a few options, see [[Additional Software]].

; Can I watch Netflix under GalliumOS?
: Absolutely. You'll need Google Chrome or Firefox. See [[Additional Software]].

; How do I install software package X?
: Some packages are available directly from Ubuntu repositories, and some require a few more steps. See [[Additional Software]].

; How can I beta test new packages before general release?
: You can enable our special "testing" package repository. See [[Repositories]] for details. Thank you for helping us test!

== Performance ==
; How does GalliumOS affect battery life?
: Total run time will vary between models, but reports generally indicate battery life comparable to ChromeOS (within 10-15%, with GalliumOS sometimes exceeding ChromeOS, and sometimes the reverse).

; How much disk space will GalliumOS use?
: A fresh installation of GalliumOS 2.1 requires 2.9GB. This will increase as you install additional software and add personal data.

== Wiki ==

'''How can I contribute?'''

We need editors of this wiki. Drop into IRC Freenode [https://galliumos.org/irc #galliumos] and say hello so we can create a wiki user account for you.

You can join us on our Github page. [https://github.com/GalliumOS https://github.com/GalliumOS]

Found a bug? Issues are tracked on [https://github.com/GalliumOS/galliumos-distro/issues Github] too.

Spare some change? Of course you can! How about a monthly donation? You are generous! [https://galliumos.org/donate Donate here]

Donate your old laptop to us to test on. [mailto:info@galliumos.org Email us what you got and we'll get back to you.]

Get a dozen stickers from [https://wiki.galliumos.org/News/2016_Annual_Report_and_Announcement#Stickers_and_T-Shirts this online sticker store] and pass them out at your next Free/Open Source expo.

Spread the word about us on social media. [http://reddit.com/r/GalliumOS reddit] & [http://twitter.com/GalliumOS twitter]

Additional Software

2016-08-07T02:57:19Z

Onii: Added OBS to Screen Recorders.

<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>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

2016-08-04T16:13:18Z

Onii: New hotness to install Chrome (apt handles dependencies)

<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/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

Installing/Peppy

2016-03-21T04:18:35Z

Onii: /* Pointing out that you need Haswell. */

=== 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.html
# 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
# Go to ''chrome://imageburner''
# 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

Installing

2016-02-23T20:33:11Z

Onii: /* Traditional ISO Install */

== General Install Instructions ==
You have two possible options for installing GalliumOS:
# '''From an ISO image written to USB drive or SD card'''<br>This method works on '''most''' devices, and enables you to entirely replace ChromeOS on your internal SSD or HDD.<br>It also allows you to set up more complex configurations such as dual-booting alongside Windows or other Linux distributions.
# '''From the ChromeOS command-line using chrx'''<br>This method works on '''many''' devices, and will configure your device to dual-boot GalliumOS alongside ChromeOS.

See [[Hardware Compatibility]] for the installation options available for your ChromeOS device model.

=== Traditional ISO Install ===

The traditional installer allows you to use your entire SSD or HDD for GalliumOS. You will need to use a USB flash drive or SD card. You can even boot the GalliumOS Live image to try out the features of GalliumOS before you decide to install!

# Go to [[Installing/Preparing]] and get your Chromebook ready to run GalliumOS.
# Download a GalliumOS suitable for your device ISO from the [https://galliumos.org/download.html downloads page on GalliumOS.org]
# Write (or "burn") the ISO to a USB flash drive or an SD card. Detailed instructions for this are at [[Installing/Creating Bootable USB]]
# Plug your USB flash drive or SD card into your Chromebook
# Reboot your Chromebook and boot from the USB flash drive or SD card.
## If you have installed custom firmware, press Esc at the BIOS screen and press 2 to boot from USB.
## If you have the scary white screen, press Ctrl+L.
# Wait for GalliumOS to boot up. Once in the live environment you can play around with GalliumOS, or you can install it using the Install GalliumOS icon on the desktop.
## You will have to press Ctrl+L every time your Chromebook boots up to access Gallium OS.

=== chrx Installation ===

GalliumOS is also installable on many ChromeOS devices via [https://chrx.org/ chrx], which allows you to dual-boot GalliumOS alongside ChromeOS. Check the [https://chrx.org/#compatibility chrx hardware compatibility list] to see if your device supports chrx, and whether any preparation steps are required.

See [https://chrx.org#usage chrx installation instructions] for full details, but here's a quick overview:

# Prepare your ChromeOS device
## Enable Developer Mode
## Install firmware feature update if required (some Broadwell devices only)
# Boot device into ChromeOS and configure networking; you do not need to log in
# Switch to a virtual terminal by pressing <code>CTRL+ALT+F2(top row right arrow)</code>, then log in as user <code>chronos</code> with no password
# Run chrx: <code>curl -O <nowiki>https://chrx.org/go</nowiki> && sh go -d galliumos</code> (see [https://chrx.org/#options chrx docs] for additional options)
# Follow on-screen prompts to repartition your SSD and install GalliumOS. If this is the first time running chrx on this ChromeOS machine, chrx will reboot after the partitioning step and you will need to continue the installation by running chrx again with the same command line.
# After reboot, at the white "OS verification is OFF" screen, press <code>CTRL+L</code> for GalliumOS, or <code>CTRL+D</code> for ChromeOS

== Specific Device Install Documents ==
Our community is also making in-depth install guides for certain devices. Below is a list.
* [[Installing/Lulu|Lulu (Dell Chromebook 13)]]
* [[Installing/Panther|Panther (ASUS Chromebox 2014)]]
* [[Installing/Parrot|Parrot (Acer C710, Acer C7)]]
* [[Installing/Peppy|Peppy (Acer C720, Acer C720P)]]
* [[Installing/Kip|Kip (HP Chromebook 11 G3, HP Chromebook 11 G4, HP Chromebook 14 G4)]]
__FORCETOC__

Additional Software

2016-02-16T02:14:51Z

Onii: /* Minecraft (fixing underscores) */

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/Productivity ==

=== 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>.



=== Google Drive integration ===

* 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 Startup Applications.
<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>

== 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>

== 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>tacos</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.

Additional Software

2016-02-15T03:32:43Z

Onii: /* Google Chrome */

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/Productivity ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl-ssl.google.com/linux/linux_signing_key.pub
sudo apt-key add linux_signing_key.pub
sudo add-apt-repository -y "deb http://dl.google.com/linux/chrome/deb/ stable main"
sudo apt-get update
sudo apt-get install google-chrome-stable
rm linux_signing_key.pub
sudo sed -i '/chrome\/deb/d' /etc/apt/sources.list
</pre>

=== Google Drive integration ===

* 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 Startup Applications.
<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>

== 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>

== 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>tacos</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.

Additional Software

2016-02-15T03:22:36Z

Onii: /* Chrome: rm linux_signing_key.pub, and delete lines from sources.list since it installs its own sources.list.d file */

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/Productivity ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl-ssl.google.com/linux/linux_signing_key.pub
sudo apt-key add linux_signing_key.pub
rm linux_signing_key.pub
sudo add-apt-repository -y "deb http://dl.google.com/linux/chrome/deb/ stable main"
sudo apt-get update
sudo apt-get install google-chrome-stable
sudo sed -i '/chrome\/deb/d' /etc/apt/sources.list
</pre>

=== Google Drive integration ===

* 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 Startup Applications.
<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>

== 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>

== 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>tacos</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.

Media keys and default keybindings

2016-02-10T17:45:05Z

Onii: /* Keyboard Shortcuts */

GalliumOS includes five keyboard layouts customized for Chromebooks.

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
| Right-Alt
| Function keys
| Media keys
|-
| style="background-color:#e0e8ff" | '''Chromebook / Right alt overlay / F keys mapped to media keys'''<br>'''** current default: 1.0beta2 **'''
| style="background-color:#e0e8ff" | Right-Alt
| style="background-color:#e0e8ff" | Media keys
| style="background-color:#e0e8ff" | Function keys
|-
| Chromebook / Search overlay<br>previous default (1.0beta1), and Crouton default
| Super (Search)
| Function keys
| Media keys
|-
| Chromebook / Search overlay / F keys mapped to media key
| Super (Search)
| Media keys
| Function keys
|}

== Keyboard Shortcuts ==

{| class="wikitable"
!Key
!Combination
|-
|F1-F9
|Accessed directly or with Overlay, depending on Keyboard layout
|-
|F10
|
|-
|F11
|
|-
|F12
|
|-
|Home
|<code>Overlay</code> + <code>Left Arrow</code>
|-
|End
|[Overlay + Right]
|-
|Page Up
|[Overlay + Up]
|-
|Page Down
|[Overlay + Down]
|-
|Insert
|[Overlay + . ]
|-
|Delete
|[Overlay + Backspace]
|-
|Caps Lock
|[Overlay + Alt] (unless Alt is Overlay)
|-
|Screenshot (fullscreen)
|[Ctrl + F5(display)]
|-
|Screenshot (window)
|[Ctrl + Shift + F5(display)]
|-
|Whisker Menu/Search
|[Super + M] (unless Super is Overlay)<br>[Alt + M] (unless Alt is Overlay)
|-
|Keyboard Backlight Toggle
|[Overlay + 0]
|-
|Keyboard Backlight Brightness Down
|[Overlay + - ]
|-
|Keyboard Backlight Brightness Up
|[Overlay + = ]
|}

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

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

Stale/Releases/1.0beta2

2016-02-08T05:56:02Z

Onii:

== TODO ==

Quick list of items noted in the beta2 RCs, that don't require full tickets.

Add your vote wherever it fits. If anything needs discussion, it shall be had.

Done items are not final, just "done" in the RC noted. Revertable if consensus so leads.

{| class="wikitable"
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' "Mail Reader" in Whisker Menu goes nowhere '''
|-
! ✓
| Remove it!
| ➕ reynhout, onii, hugegreenbug
| ≈
| ➖
|-
|
| Link to Gmail
| ➕
| ≈
| ➖ reynhout, onii
|-
|
| Add Thunderbird
| ➕
| ≈ reynhout
| ➖ onii
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' PCManFM is installed, but we use Thunar '''
|-
|
| Remove PCManFM
| ➕ reynhout, hugegreenbug
| ≈
| ➖
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' "Install GalliumOS 1.0beta2" in Live icon truncates uselessly '''
|-
|
| Shorten to "Install GalliumOS"
| ➕ reynhout
| ≈
| ➖
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' <code>/etc/issue*</code> etc reflect beta1 '''
|-
|
| Update to beta2
| ➕ (everyone!)
| ≈
| ➖
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' Mouse/trackpad pointer should be black '''
|-
|
| Switch to DMZ Black
| ➕ onii, coltondrg, shinji257, reynhout, hugegreenbug
| ≈
| ➖
|-
! ☐
| colspan=4 text-align:left | ''' Move notifications to bottom right from top right, since panel is on bottom '''
|-
|
| Make it so
| ➕ onii
| ≈ reynhout
| ➖hugh
|-
! ✓ 1.0beta2rc3
| colspan=4 text-align:left | ''' Add <code>ntp</code> package so time will synchronize '''
|-
|
| Make it so
| ➕ onii, reynhout
| ≈
| ➖
|-
! ✓ 1.0beta2rc3
| colspan=4 text-align:left | ''' Keyboard layout #4 does not work for media keys in live USB '''
|-
|
| Find out what's going on
| ➕ hugegreenbug
| ≈
| ➖
|-
|
|<nowiki>Issue: https://github.com/GalliumOS/galliumos-distro/issues/57#issuecomment-181085443</nowiki>
| "fixed" because known problem & no longer default
|
|
|-
! ☐ 1.0beta2rc3
| colspan=4 text-align:left | ''' Screenshot keys need to be "XF86Display" instead of "F5" since change to keyboard layout #3'''
|-
|
| Make it so
| ➕ onii
| ≈
| ➖
|-
! ☐
| colspan=4 text-align:left | ''' Edit text after install asking to "remove CD from tray" since no one is using discs '''
|-
|
| Make it so
| ➕ onii
| ≈
| ➖
|-
|}

Stale/Releases/1.0beta2

2016-02-08T05:47:59Z

Onii:

== TODO ==

Quick list of items noted in the beta2 RCs, that don't require full tickets.

Add your vote wherever it fits. If anything needs discussion, it shall be had.

Done items are not final, just "done" in the RC noted. Revertable if consensus so leads.

{| class="wikitable"
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' "Mail Reader" in Whisker Menu goes nowhere '''
|-
! ✓
| Remove it!
| ➕ reynhout, onii, hugegreenbug
| ≈
| ➖
|-
|
| Link to Gmail
| ➕
| ≈
| ➖ reynhout, onii
|-
|
| Add Thunderbird
| ➕
| ≈ reynhout
| ➖ onii
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' PCManFM is installed, but we use Thunar '''
|-
|
| Remove PCManFM
| ➕ reynhout, hugegreenbug
| ≈
| ➖
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' "Install GalliumOS 1.0beta2" in Live icon truncates uselessly '''
|-
|
| Shorten to "Install GalliumOS"
| ➕ reynhout
| ≈
| ➖
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' <code>/etc/issue*</code> etc reflect beta1 '''
|-
|
| Update to beta2
| ➕ (everyone!)
| ≈
| ➖
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' Mouse/trackpad pointer should be black '''
|-
|
| Switch to DMZ Black
| ➕ onii, coltondrg, shinji257, reynhout, hugegreenbug
| ≈
| ➖
|-
! ☐
| colspan=4 text-align:left | ''' Move notifications to bottom right from top right, since panel is on bottom '''
|-
|
| Make it so
| ➕ onii
| ≈ reynhout
| ➖hugh
|-
! ☐
| colspan=4 text-align:left | ''' Add <code>ntp</code> package so time will synchronize '''
|-
|
| Make it so
| ➕ onii, reynhout
| ≈
| ➖
|-
! ☐
| colspan=4 text-align:left | ''' Keyboard layout #4 does not work for media keys in live USB '''
|-
|
| Find out what's going on
| ➕ hugegreenbug
| ≈
| ➖
|-
|
|<nowiki>Issue: https://github.com/GalliumOS/galliumos-distro/issues/57#issuecomment-181085443</nowiki>
|-
! ☐ 1.0beta2rc3
| colspan=4 text-align:left | ''' Screenshot keys need to be "XF86Display" instead of "F5" since change to keyboard layout #3'''
|-
|
| Make it so
| ➕ onii
| ≈
| ➖
|-
! ☐
| colspan=4 text-align:left | ''' Edit text after install asking to "remove CD from tray" since no one is using discs '''
|-
|
| Make it so
| ➕ onii
| ≈
| ➖
|-
|}

Stale/Releases/1.0beta2

2016-02-07T05:20:56Z

Onii: /* TODO */

== TODO ==

Quick list of items noted in the beta2 RCs, that don't require full tickets.

Add your vote wherever it fits. If anything needs discussion, it shall be had.

Done items are not final, just "done" in the RC noted. Revertable if consensus so leads.

{| class="wikitable"
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' "Mail Reader" in Whisker Menu goes nowhere '''
|-
! ✓
| Remove it!
| ➕ reynhout, onii
| ≈
| ➖
|-
|
| Link to Gmail
| ➕
| ≈
| ➖ reynhout, onii
|-
|
| Add Thunderbird
| ➕
| ≈ reynhout
| ➖ onii
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' PCManFM is installed, but we use Thunar '''
|-
|
| Remove PCManFM
| ➕ reynhout, hugegreenbug
| ≈
| ➖
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' "Install GalliumOS 1.0beta2" in Live icon truncates uselessly '''
|-
|
| Shorten to "Install GalliumOS"
| ➕ reynhout
| ≈
| ➖
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' <code>/etc/issue*</code> etc reflect beta1 '''
|-
|
| Update to beta2
| ➕ (everyone!)
| ≈
| ➖
|-
! ✓ 1.0beta2rc2
| colspan=4 text-align:left | ''' Mouse/trackpad pointer should be black '''
|-
|
| Switch to DMZ Black
| ➕ onii, coltondrg, shinji257, reynhout
| ≈
| ➖
|-
! ☐
| colspan=4 text-align:left | ''' Move notifications to bottom right from top right, since panel is on bottom '''
|-
|
| Make it so
| ➕ onii
| ≈ reynhout
| ➖
|-
! ☐
| colspan=4 text-align:left | ''' Add <code>ntp</code> package so time will synchronize '''
|-
|
| Make it so
| ➕ onii, reynhout
| ≈
| ➖
|-
! ☐
| colspan=4 text-align:left | ''' Keyboard layout #4 does not work for media keys in live USB '''
|-
|
| Find out what's going on
| ➕
| ≈
| ➖
|}

Stale/Releases/1.0beta2

2016-02-07T04:41:43Z

Onii: /* TODO */

Stale/Releases/1.0beta2

2016-02-06T23:54:46Z

Onii: /* TODO */

Stale/Releases/1.0beta2

2016-02-05T21:10:03Z

Onii:

== TODO ==

* No mail reader installed, but there's a link in the Whisker menu (link to Gmail?)
* <code>pcmanfm</code> is installed (from <code>lxde-core</code>, from <code>lxdm</code>). can remove?
* Fix "Install GalliumOS 1.0" shortcut name
* Update <code>/etc/issue</code>, etc
* Switch to DMZ Black? ε=ε=┏( >_<)┛ (onii made this edit) (coltondrg seconds this edit) (shinji257 thirds this edit)
* Change notifications to bottom right instead of top right

Stale/Releases/1.0beta2

2016-02-05T20:34:26Z

Onii: /* TODO */

== TODO ==

* No mail reader installed, but there's a link in the Whisker menu
* <code>pcmanfm</code> is installed (from <code>lxde-core</code>, from <code>lxdm</code>). can remove?
* Fix "Install GalliumOS 1.0" shortcut name
* Update <code>/etc/issue</code>, etc
* Switch to DMZ Black? ε=ε=┏( >_<)┛ (onii made this edit)

Additional Software

2016-02-04T15:52:05Z

Onii: /* Hardware temperature monitor */

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/Productivity ==

=== Google Chrome ===

<pre style="margin:0 0 0 1.5em">
curl -O https://dl-ssl.google.com/linux/linux_signing_key.pub
sudo apt-key add linux_signing_key.pub
sudo add-apt-repository -y "deb http://dl.google.com/linux/chrome/deb/ stable main"
sudo apt-get update
sudo apt-get install google-chrome-stable
</pre>

=== Google Drive integration ===

* 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 Startup Applications.
<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

=== Wine ===

Wine has been a source of frustration. We're working on reliable and repeatable instructions, the essentials of which will be:

* Enable i386 libraries
* Add the proper PPA package source
* Update package lists
* Install Wine

<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>

Try it, it might work! Sometimes it doesn't though. Requires more testing.

=== 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>

== 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>

== 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> Do '''not''' select "''tacos''." 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.