Bumblebee

From Hybridgraphics

(Difference between revisions)
Jump to: navigation, search
(Updated for new Bumblebee)
Line 1: Line 1:
Bumblebee allows you to run specific programs on the discrete graphic card, inside of an X session using the integrated graphic card.
Bumblebee allows you to run specific programs on the discrete graphic card, inside of an X session using the integrated graphic card.
-
It's written by [http://www.martin-juhl.dk/ Martin Juhl] and published under GPL v3.<br />
+
[http://www.martin-juhl.dk/ Martin Juhl] started with the project and published under GPL v3. To improve co-operation, some developers decided to fork the project into a team: [https://github.com/Bumblebee-Project/Bumblebee Bumblebee-Project].
===What it does - and does not===
===What it does - and does not===
-
Actually only Ubuntu, Debian, OpenSuSE and Fedora is supported by this script, but Martin is working on to porting on other distros and make his script more distro-independent. For info about state of work in distro porting or to help in porting please see https://github.com/MrMEEE/bumblebee/issues/7
+
Currently, Ubuntu and Arch Linux is supported by the installer. Work is in progress to support Fedora, Debian and OpenSUSE.
-
Arch and Gentoo are support by:
+
Arch Linux and Gentoo are support by:
-
Arch Linux - ArchWiki: https://wiki.archlinux.org/index.php/Bumblebee
+
- Arch Linux - ArchWiki: https://wiki.archlinux.org/index.php/Bumblebee
 +
- Gentoo - Iegor: https://github.com/iegor/bumblebee-Gentoo-support
-
Gentoo - Iegor: https://github.com/iegor/bumblebee-Gentoo-support
+
Power management [https://github.com/Bumblebee-Project/Bumblebee/wiki/ACPI-Removed has temporary been disabled], but will be re-added later.
-
 
+
-
 
+
-
Currently this application '''does''' shut down the nvidia card when not used, but only on Ubuntu.. Other distribution are in progress.. still balance the load between the two cards is missing..
+
===Installing it===
===Installing it===
-
The installer installs the closed-source nvidia driver.
+
 
-
<pre>git clone https://github.com/MrMEEE/bumblebee
+
git clone git@github.com:Bumblebee-Project/Bumblebee.git
-
cd bumblebee
+
cd Bumblebee
-
sudo ./install.sh</pre>
+
sudo ./cleanup
 +
sudo ./install</pre>
====Installing on Ubuntu====
====Installing on Ubuntu====
-
If you're using Ubuntu, you can install Bumblebee from a PPA. Make sure that you've removed previous versions and the x-swat PPA containing the latest nvidia driver:
+
If you're using Ubuntu, you can install Bumblebee from a PPA. If you've installed versions before 2.3 from ppa:mj-casalogic/bumblebee or MrMEEE/bumblebee, you've to run the cleanup script first:
-
<pre>sudo bumblebee-uninstall
+
 
-
sudo apt-get install ppa-purge
+
wget https://raw.github.com/Bumblebee-Project/Bumblebee/master/cleanup
-
sudo ppa-purge ppa:ubuntu-x-swat/x-updates</pre>
+
chmod +x cleanup
-
Next, proceed with installing bumblebee from Martins PPA.
+
sudo ./cleanup
-
<pre>sudo apt-add-repository ppa:mj-casalogic/bumblebee
+
 
-
sudo apt-get update
+
The nvidia drivers supplied with Natty and before may not support your graphics card. Therefore, add the PPA containing more recent drivers:
-
sudo apt-get install bumblebee</pre>
+
 
 +
sudo add-apt-repository ppa:ubuntu-x-swat/x-updates
 +
 
 +
Next, add the Bumblebee PPA:
 +
 
 +
sudo add-apt-repository ppa:bumblebee/stable
 +
sudo apt-get update
 +
sudo apt-get install bumblebee
===Testing it===
===Testing it===
Line 42: Line 48:
===Configure it===
===Configure it===
-
To Reconfigure bumblebee :
+
On versions prior to 2.3, you had to run <tt>bumblebee-configuration</tt> to configure Bumblebee. Newer versions automatically detect the right version for you.
-
<pre>bumblebee-configuration</pre>
+
===Uninstall it===
===Uninstall it===
-
To uninstall or clean up ealier versions :
+
If you're really using an old version (from MrMEEE, versions prior to 2.3):
-
<pre>bumblebee-uninstall</pre>
+
 
 +
wget https://raw.github.com/Bumblebee-Project/Bumblebee/master/cleanup
 +
chmod +x cleanup
 +
sudo ./cleanup
 +
In other cases, you need to run the following to uninstall Bumblebee:
 +
 
 +
bumblebee-uninstall
 +
 
 +
If you're using Ubuntu and have installed Bumblebee through the PPA, you can remove it with:
 +
 
 +
sudo apt-get remove bumblebee
===Reporting bugs===
===Reporting bugs===
-
Use the '''bumblebee-bugreport''' script to create a nice bug report that you'll send [https://github.com/MrMEEE/bumblebee/issues here].
+
Run '''bumblebee-bugreport''' and follow the instructions.
==External Links==
==External Links==
* [https://lists.launchpad.net/hybrid-graphics-linux/msg01607.html 10 questions and answers on Bumblebee]
* [https://lists.launchpad.net/hybrid-graphics-linux/msg01607.html 10 questions and answers on Bumblebee]
 +
* [https://github.com/Bumblebee-Project/Bumblebee/wiki Bumblebee Project's Wiki]

Revision as of 19:43, 3 September 2011

Bumblebee allows you to run specific programs on the discrete graphic card, inside of an X session using the integrated graphic card. Martin Juhl started with the project and published under GPL v3. To improve co-operation, some developers decided to fork the project into a team: Bumblebee-Project.

Contents

What it does - and does not

Currently, Ubuntu and Arch Linux is supported by the installer. Work is in progress to support Fedora, Debian and OpenSUSE.

Arch Linux and Gentoo are support by:

- Arch Linux - ArchWiki: https://wiki.archlinux.org/index.php/Bumblebee - Gentoo - Iegor: https://github.com/iegor/bumblebee-Gentoo-support

Power management has temporary been disabled, but will be re-added later.

Installing it

git clone git@github.com:Bumblebee-Project/Bumblebee.git
cd Bumblebee
sudo ./cleanup
sudo ./install</pre>

Installing on Ubuntu

If you're using Ubuntu, you can install Bumblebee from a PPA. If you've installed versions before 2.3 from ppa:mj-casalogic/bumblebee or MrMEEE/bumblebee, you've to run the cleanup script first:

wget https://raw.github.com/Bumblebee-Project/Bumblebee/master/cleanup
chmod +x cleanup
sudo ./cleanup

The nvidia drivers supplied with Natty and before may not support your graphics card. Therefore, add the PPA containing more recent drivers:

sudo add-apt-repository ppa:ubuntu-x-swat/x-updates

Next, add the Bumblebee PPA:

sudo add-apt-repository ppa:bumblebee/stable
sudo apt-get update
sudo apt-get install bumblebee

Testing it

You can compare display performances with and without bumblebee :

glxgears
optirun glxgears

Note: when running just glxgears, if you see this message:

Running synchronized to the vertical refresh.  The framerate should be
approximately the same as the monitor refresh rate.

The FPS value will always be close to 60. Instead you should do:

vblank_mode=0 glxgears

Configure it

On versions prior to 2.3, you had to run bumblebee-configuration to configure Bumblebee. Newer versions automatically detect the right version for you.

Uninstall it

If you're really using an old version (from MrMEEE, versions prior to 2.3):

wget https://raw.github.com/Bumblebee-Project/Bumblebee/master/cleanup
chmod +x cleanup
sudo ./cleanup

In other cases, you need to run the following to uninstall Bumblebee:

bumblebee-uninstall

If you're using Ubuntu and have installed Bumblebee through the PPA, you can remove it with:

sudo apt-get remove bumblebee

Reporting bugs

Run bumblebee-bugreport and follow the instructions.

External Links

Personal tools