h1. Requirements

!>snail.png!

While scripts tested on GNU/Linux Gentoo amd64, Debian Squeeze/Wheezy amd64, Ubuntu 12.04 LTS x86_64, Fedora 16 (Verne) x86_64. Now I begin to test the project on Slackware GNU/Linux, Arch, etc.
You need either "bbswitch":https://github.com/Bumblebee-Project/bbswitch, "acpi_call":http://github.com/avilella/acpi_call or _vgaswitheroo_ support (Linux >=2.6.34). Also the packages may be available in your distro repositories.
Also you need a "dmidecode":http://www.nongnu.org/dmidecode program installed from Your distro repositories.

h1. Installation

Before installation turn on all Video chips in BIOS.

h2. Installation on Gentoo amd64 GNU/Linux

* Wiki to the installation using layman.
Install backbone's overlay using one of the wiki's:
https://github.com/backbone/overlay/wiki
https://git.backbone.ws/portage/pages/Home
emerge latest stable snail-X.Y.Z
<pre>echo "x11-drivers/snail ~amd64" >> /etc/portage/package.keywords
emerge snail</pre>
or Git snail-9999 version.
<pre>echo "=x11-drivers/snail-9999 **" >> /etc/portage/package.keywords
emerge snail</pre>

* Manual installation
Download an ebuild file from repository to your local overlay, create Manifest and install it.
Example: <pre>sudo mkdir -p /usr/local/portage/x11-drivers/snail
sudo cp snail-1.0.0.ebuild /usr/local/portage/x11-drivers/snail
sudo ebuild /usr/local/portage/x11-drivers/snail/snail-1.0.0.ebuild manifest
sudo eselect rc stop xdm # stop X server

sudo emerge snail

sudo eselect rc start xdm # restart X server</pre>

h2. Installation on Debian Squeeze/Wheezy amd64 GNU/Linux

# Stop Gdm (KDM or what you use)<pre>sudo /etc/init.d/gdm3 stop</pre>
# Uninstall all nVidia packages and files installed by NVIDIA-installer*<pre>sudo apt-get purge nvidia*
sudo nvidia-uninstall</pre>
# Install Git, dmidecode, Linux kernel headers, Make, Gcc and OpenGL libraries.<pre>sudo apt-get install git dmidecode linux-headers-`uname -r` make gcc
sudo apt-get install --reinstall libgl1-mesa-glx libgl1-mesa-dri xserver-xorg-core xserver-xorg-video-intel</pre>
# Install bbswitch (preferable) or acpi_call.
## *bbswitch*.<pre>git clone --depth 1 git://github.com/Bumblebee-Project/bbswitch.git
cd bbswitch
make
sudo cp bbswitch.ko /lib/modules/`uname -r`/kernel/drivers/acpi
sudo depmod -a
sudo modprobe bbswitch</pre>
## *acpi_call*.<pre>git clone --depth 1 http://github.com/avilella/acpi_call
cd acpi_call
make
sudo cp acpi_call.ko /lib/modules/`uname -r`/kernel/drivers/acpi
sudo depmod -a
sudo modprobe acpi_call</pre>
# Install Snail<pre>git clone --depth=1 git://git.backbone.ws/snail/snail.git
cd snail
sudo make install</pre>
# For Debian Wheezy it is enough to add 'contrib non-free' flags to /etc/apt-sources.lst, for example <pre>deb http://mirror.yandex.ru/debian wheezy main contrib non-free</pre> and run <pre>sudo apt-get install nvidia-kernel-dkms</pre>For Debian Squeeze you need to download latest nVidia driver from "nvidia.com":http://www.geforce.com/Drivers because 195.x version of the nVidia drivers in repos doesn't support hybrid graphics cards.<pre>wget http://us.download.nvidia.com/XFree86/Linux-x86_64/295.33/NVIDIA-Linux-x86_64-295.33.run
# Important: switch on nVidia chip otherwise NVIDIA-installer fails.
sudo snail.nv_pwr_on
# Then run NVIDIA-installer and set appropriate Gcc compiler.
sudo CC=/usr/bin/gcc-4.3 ./NVIDIA-Linux-x86_64-295.33.run</pre>
# For multilib support you must install 32-bi libraries.
For Squeeze <pre>sudo apt-get install ia32-libs</pre>
For Wheezy <pre>sudo apt-get install libgl1-nvidia-glx-ia32</pre>
# Configure Snail.<pre>sudo snail.configure</pre>
# Start Gdm (KDM or what you use)<pre>sudo /etc/init.d/gdm3 start</pre>

h2. Installation on Ubuntu 12.04 LTS amd64 GNU/Linux

# Stop Gdm (KDM or what you use)<pre>sudo /etc/init.d/lightdm stop</pre>
# Install Git, dmidecode, Linux kernel headers, Make, Gcc, nVidia and OpenGL libraries.<pre>sudo apt-get install git dmidecode linux-headers-`uname -r` make gcc nvidia-current
sudo apt-get install --reinstall libgl1-mesa-glx libgl1-mesa-dri xserver-xorg-core xserver-xorg-video-intel</pre>
# Install bbswitch (preferable) or acpi_call.
## *bbswitch*.<pre>git clone --depth 1 git://github.com/Bumblebee-Project/bbswitch.git
cd bbswitch
make
sudo cp bbswitch.ko /lib/modules/`uname -r`/kernel/drivers/acpi
sudo depmod -a
sudo modprobe bbswitch</pre>
## *acpi_call*.<pre>git clone --depth 1 http://github.com/avilella/acpi_call
cd acpi_call
make
sudo cp acpi_call.ko /lib/modules/`uname -r`/kernel/drivers/acpi
sudo depmod -a
sudo modprobe acpi_call</pre>
# Install Snail<pre>git clone --depth=1 git://git.backbone.ws/snail/snail.git
cd snail
sudo make install</pre>
# For multilib support you must install 32-bi libraries.
<pre>sudo apt-get install ia32-libs</pre>
# Configure Snail.<pre>sudo snail.configure</pre>
# Start Gdm (KDM or what you use)<pre>sudo /etc/init.d/lightdm start</pre>

h2. Installation on Fedora 16 (Verne) x86_64

# Stop Gdm (KDM or what you use)<pre>sudo systemctl stop prefdm.service</pre>
# Install Git, dmidecode, Linux kernel headers, Gcc and OpenGL libraries.<pre>sudo yum install git dmidecode kernel-devel gcc</pre>
# Check that /lib/modules/`uname -r`/{build,source} symlinks not broken and point to /usr/src/kernels/appropriate_kernel_sources<pre>ls -l /lib/modules/`uname -r`/{build,source}</pre>
# Install bbswitch (preferable) or acpi_call.
## *bbswitch*.<pre>git clone --depth 1 git://github.com/Bumblebee-Project/bbswitch.git
cd bbswitch
make
sudo cp bbswitch.ko /lib/modules/`uname -r`/kernel/drivers/acpi
sudo depmod -a
sudo modprobe bbswitch</pre>
## *acpi_call*.<pre>git clone --depth 1 http://github.com/avilella/acpi_call
cd acpi_call
make
sudo cp acpi_call.ko /lib/modules/`uname -r`/kernel/drivers/acpi
sudo depmod -a
sudo modprobe acpi_call</pre>
# Install Snail<pre>git clone --depth=1 git://git.backbone.ws/snail/snail.git
cd snail
sudo make install</pre>
# Add RPMFusion Repositories (Free and Non-Free)<pre>rpm -Uvh http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-stable.noarch.rpm 
rpm -Uvh http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-stable.noarch.rpm</pre>
# Install nVidia proprietary drivers<pre>yum install akmod-nvidia xorg-x11-drv-nvidia-libs</pre>
# Configure Snail.<pre>sudo snail.configure</pre>
# Start Gdm (KDM or what you use)<pre>sudo systemctl start prefdm.service</pre>

h1. Upgrade

Pull changes to your local Git repository and reinstall.
<pre>
cd snail
git pull

sudo make install

# Stop X-server
sudo /etc/init.d/gdm3 stop # Debian
sudo /etc/init.d/lightdm stop # Ubuntu
sudo systemctl stop prefdm.service # Fedora

sudo snail.configure

# Start X-server
sudo /etc/init.d/gdm3 start # Debian
sudo /etc/init.d/lightdm start # Ubuntu
sudo systemctl start prefdm.service # Fedora
</pre>

h1. Uninstall

Change dir to snail repo and uninstall it.
<pre>
cd snail
sudo make uninstall
</pre>

h1. Powersave

For the best energy saving it is recommended to add kernel boot parameters to the Grub/Lilo menu.lst. Example:
<pre>
kernel /boot/vmlinuz-... root=/dev/sda... i915.i915_enable_rc6=1 i915.i915_enable_fbc=1 i915.lvds_downclock=1
</pre>

h1. Run

To run application add the user to the _video_ group.
<pre>
gpasswd -a user video
</pre>
If the user was not in the video group your must relogin.
To run any application on nVidia chip type in the command line or add to the link on the desktop command:
<pre>
nvrun application
</pre>

h1. Video

It is a little old video where graphics are switched manually. Now all is automatic.
{{video(https://youtu.be/c6RH69j-gMY)}}