Bumblebee

From Hybridgraphics

(Difference between revisions)
Jump to: navigation, search
(Installing on Ubuntu)
(Update for new version)
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.
-
[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].
+
[http://www.martin-juhl.dk/ Martin Juhl] started with the project and published under GPL v3 and now continues with [Ironhide] (deprecated). To improve co-operation, developers decided to fork the project into a team: [http://Bumblebee-Project/ Bumblebee-Project].
-
===What it does - and does not===
+
=== Installation ===
-
Currently, Ubuntu and Arch Linux is supported by the installer. Work is in progress to support Fedora, Debian and OpenSUSE.
+
Bumblebee 2.4 and before was written in Bash and has now been superseded by Bumblebee 3.0, which is written in C.
 +
Many distributions are supported, including Arch Linux, Debian, Mandriva and Ubuntu. For the latest installation
 +
instructions, see https://github.com/Bumblebee-Project/Bumblebee/wiki/Install-and-usage.
-
Arch Linux and Gentoo are support by:
 
-
* Arch Linux - ArchWiki: https://wiki.archlinux.org/index.php/Bumblebee
+
=== Testing ===
-
* 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.
+
-
 
+
-
===Installing it===
+
-
 
+
-
git clone git@github.com:Bumblebee-Project/Bumblebee.git
+
-
cd Bumblebee
+
-
sudo ./cleanup
+
-
sudo ./install
+
-
 
+
-
====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
+
-
 
+
-
When done, you need to add yourself to the bumblebee group:
+
-
 
+
-
sudo usermod -a -G bumblebee $USER
+
-
 
+
-
Re-login after this change.
+
-
 
+
-
===Testing it===
+
You can compare display performances with and without bumblebee :
You can compare display performances with and without bumblebee :
<pre>glxgears
<pre>glxgears
Line 56: Line 22:
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.
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.
-
===Uninstall it===
+
===Uninstalling===
-
If you're really using an old version (from MrMEEE, versions prior to 2.3):
+
If you've installed Bumblebee through your package manager, remove it using your package manager.
-
 
+
==== Source ===
-
wget https://raw.github.com/Bumblebee-Project/Bumblebee/master/cleanup
+
If you're really using an old version (from MrMEEE, versions prior to 2.3), you are screwed.
-
chmod +x cleanup
+
If you have installed Bumblebee 2.4 from git, run `bumblebee-uninstall`.
-
sudo ./cleanup
+
Version 3.0 and later can be uninstalled from the source directory by running `make uninstall`.
-
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===
-
Run '''bumblebee-bugreport''' and follow the instructions, bugs or feature requests can be reported at https://github.com/Bumblebee-Project/Bumblebee/issues.
+
Run '''bumblebee-bugreport''' and follow the instructions, bugs or feature requests can be reported at http://Bumblebee-Project.org/issues.
==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]
* [https://github.com/Bumblebee-Project/Bumblebee/wiki Bumblebee Project's Wiki]
-
* [https://github.com/Bumblebee-Project/Bumblebee/blob/master/README Read me file]
+
* [https://Bumblebee-Project.org/ Bumblebee Project homepage]
* [https://twitter.com/Team_Bumblebee Bumblebee updates on Twitter]
* [https://twitter.com/Team_Bumblebee Bumblebee updates on Twitter]

Revision as of 19:05, 19 January 2012

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 and now continues with [Ironhide] (deprecated). To improve co-operation, developers decided to fork the project into a team: Bumblebee-Project.

Contents

Installation

Bumblebee 2.4 and before was written in Bash and has now been superseded by Bumblebee 3.0, which is written in C. Many distributions are supported, including Arch Linux, Debian, Mandriva and Ubuntu. For the latest installation instructions, see https://github.com/Bumblebee-Project/Bumblebee/wiki/Install-and-usage.


Testing

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.

Uninstalling

If you've installed Bumblebee through your package manager, remove it using your package manager.

= Source

If you're really using an old version (from MrMEEE, versions prior to 2.3), you are screwed. If you have installed Bumblebee 2.4 from git, run `bumblebee-uninstall`. Version 3.0 and later can be uninstalled from the source directory by running `make uninstall`.

Reporting bugs

Run bumblebee-bugreport and follow the instructions, bugs or feature requests can be reported at http://Bumblebee-Project.org/issues.

External Links

Personal tools