Difference between revisions of "Bumblebee"

From ArchWiki
Jump to: navigation, search
(Using Nouveau Driver)
Line 5: Line 5:
{{Warning|Bumblebee is a work in progress and may not work properly on your machine}}
{{Warning|Bumblebee is a work in progress and may not work properly on your machine}}
{{Note|Please report bugs at [https://github.com/Bumblebee-Project/bumblebeed Bumblebee-Project]'s GitHub tracker as described in it's [https://github.com/Bumblebee-Project/bumblebeed/wiki/Reporting-Issues Wiki].}}
{{Note|Please report bugs at [https://github.com/Bumblebee-Project/bumblebeed Bumblebee-Project]'s GitHub tracker as described in its [https://github.com/Bumblebee-Project/bumblebeed/wiki/Reporting-Issues Wiki].}}
From Bumblebee's [https://github.com/Bumblebee-Project/bumblebeed/wiki/FAQ FAQ]:
From Bumblebee's [https://github.com/Bumblebee-Project/bumblebeed/wiki/FAQ FAQ]:

Revision as of 12:52, 24 January 2012

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.

Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어

External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Warning: Bumblebee is a work in progress and may not work properly on your machine
Note: Please report bugs at Bumblebee-Project's GitHub tracker as described in its Wiki.

From Bumblebee's FAQ:

Bumblebee is a effort to make Nvidia Optimus enabled laptops work in GNU/Linux systems. Such feature involves two graphics cards with two different power consumption profiles plugged in a layered way sharing a single framebuffer.

About Bumblebee

Optimus Technology is an hybrid graphics implementation without a hardware multiplexer. The integrated GPU manages the display while the dedicated GPU manages the most demanding rendering and ships the work to the integrated GPU to be displayed. When the laptop is running on battery supply, the dedicated GPU is turned off to save power and longer the battery life.

Bumblebee is a software implementation based on VirtualGL and a kernel driver to be able to use the dedicated GPU, which is not physically connected to the screen.

How it works

Bumblebee tries to mimic the Optimus technology behavior; using the dedicated GPU for rendering when needed and power it down when not in use. The present releases only support rendering on-demand, power-management is a work in progress.

The Nvidia dedicated card is managed as a separate X server connected to a "fake" screen (the screen is configured but not used). The second server is called using VirtualGL as if it were a remote server. That said, you will need a series of steps to set-up the kernel driver, the X server and a daemon.


Install package bumblebeeAUR from AUR. If you want the bleeding edge, in-development version, you can install bumblebee-gitAUR. Both packages can be used with Nvidia or Nouveau drivers. For 32-bit applications on 64-bit systems you must install lib32-virtualglAUR and relevant lib32-* libraries.

To add Power Management functionality you need to install bbswitch-gitAUR package.


Using Nouveau Driver

To use the Nouveau driver make sure you have these packages:

To get them run

# pacman -S xf86-video-nouveau nouveau-dri mesa

Using Nvidia Driver

Warning: Don't install nvidia-utils from [extra] nor lib32-nvidia-utils from [multilib], both packages will break libgl

To use Nvidia you need to install nvidia-utils-bumblebeeAUR from AUR, and the nvidia kernel module you like, both dkms-nvidiaAUR or nvidia would work. Optionally there is nvidia-bumblebeeAUR package in AUR that will depend explicitly on nvidia-utils-bumblebeeAUR for convenience.

Then make sure you load the proper kernel module at startup. If you run into trouble try the official Bumblebee wiki on GitHub.


There are some post-install steps to do before you can use Bumblebee.

Giving permission to use Bumblebee

Permission to use optirun is granted to all members of the bumblebee group, so you must add yourself (and other users whiling to use Bumblebee) to that group:

# usermod -a -G bumblebee $USER

where $USER is the login name of the user to be added. Then log off and on again to apply the group changes.

Start Bumblebee Daemon

Bumblebee provides a daemon to start the second X server and manage some privileged functions, to start it simply run:

# rc.d start bumblebeed

To be started at boot add it to your DAEMONS array in /etc/rc.conf

DAEMONS=(... @bumblebeed)


You can test Bumblebee with this command:

$ optirun glxspheres

If it succeeds means you are able of offload render to the Nvidia card.

To run any program trough Bumblebee you need to append optirun to it:

$ optirun <application>

You can run

$ optirun --help

for available options.


You may configure some variables in file /etc/bumblebee/bumblebee.conf.

Compression and VGL Transport

Compression and transport regards how the frames are compressed in the server side (bumblebee X server), then transported to the client side (main X server) and uncompressed to be displayed in the application window. It mostly will affect performance in the GPU/GPU usage, as the transport is unlimited in bandwidth. Compressed methods (such as jpeg) will load the CPU the most but will load GPU the minimum necessary; uncompressed methods loads the most on GPU and the CPU will have the minimum load possible.

Note: CPU frequency scaling will affect directly on render performance

You can try different compression methods adding -c argument to optirun command and test which suits you best:

optirun -c <compress-method> glxspheres

Where <compress-method> can be jpeg, xv, proxy, rgb or yuv. Then you can replace the one you like in VGLTransport variable in /etc/bumblebee/bumblebee.conf.

Note: Uncompressed methods proxy and xv show lower framerates but they perform better in some applications


To launch an application using the dedicated graphics card:

$ optirun [options] <application> [application-parameters]

For a list of options for optirun run:

$ optirun --help

If you want to run a 32-bit application on a 64-bit system you may need to install the proper 'lib32' packages.

Power Management

The goal of power management is to turn the discrete card off when it is not used by any application, and turn it back on when it is needed. Currently the card can be used on-demand and no automatic switching is supported by default.

To enable it, first make sure you have bbswitchAUR in place and loaded at boot

MODULES=(... bbswitch ...)

Make sure the secondary Xorg server is stopped when not in use. Then in the driver section of bumblebee.conf set the PMMethod option to auto


This should be enough as the daemon will recognize the module loaded and act accordingly. Then restart the daemon

# rc.d restart bumblebeed

See also