-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
168 lines (116 loc) · 4.9 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
-------------------
## About Bumblebee
-------------------
Bumblebee aims to provide support for nVidia Optimus laptops for GNU/Linux
distributions. Using Bumblebee, you can use your nVidia card for rendering
graphics which will be displayed using the Intel card.
Note that you cannot disable the Intel GPU even with Bumblebee installed.
Support for enabling and disabling the the nVidia card is in development.
Please refer to section 'Power Management' below.
Currently, Bumblebee has only been tested on Ubuntu and Arch Linux.
----------------
## Installation
----------------
There are several ways to get Bumblebee:
### Using your package manager (recommended if available):
If you were using an old version of Bumblebee (<2.3 non-Arch distribution),
please run this the first time before switching to a newer version:
1. wget https://raw.github.com/Bumblebee-Project/Bumblebee/master/cleanup
2. chmod +x cleanup
2. sudo ./cleanup
Ubuntu:
1. sudo add-apt-repository ppa:bumblebee/stable
1bis. If you are on Ubuntu prior to 11.10 and want newer drivers (recommended)
than the ones available in the official repos, run:
sudo add-apt-repository ppa:ubuntu-x-swat/x-updates
2. sudo apt-get update
3. sudo apt-get install bumblebee
Arch Linux:
AUR package: http://aur.archlinux.org/packages.php?ID=49469
Instructions in the ArchWiki: https://wiki.archlinux.org/index.php/Bumblebee
### Using the installation script:
If you were using an old version of Bumblebee (<2.3), please run this the first
time before switching to a newer version:
1. wget https://raw.github.com/Bumblebee-Project/Bumblebee/master/cleanup
2. chmod +x cleanup
2. sudo ./cleanup
Then, you need to install VirtualGL > 2.2.1 (2.2.90 is advised) and nvidia driver.
Tarballs can be found at https://github.com/Ximi1970/bumblebee-obs/downloads
Download the tarball named like bumblebee-VERSION.tar.gz, extract and install it:
1. Download
2. Extract:
$ tar xf bumbleee-VERSION.tar.gz
3. Change your directory to the extracted folder:
$ cd bumblebee-VERSION
4. (if you've previously installed Bumblebee < 2.3:)
$ sudo ./cleanup
5. Run the installer:
$ sudo ./install
Installation instructions for getting the code from git:
$ git clone git://github.com/Ximi1970/bumblebee-obs.git
Users who want to test the development code should run:
$ git clone git://github.com/Ximi1970/bumblebee-obs.git -b develop --depth 1
Then in order to install:
$ cd bumblebee-obs
$ sudo ./install
---------
## Usage
---------
After the initial bumblebee installation, you need to add yourself to the
'bumblebee' group:
$ sudo usermod -a -G bumblebee YOURUSERNAME
Replace YOURUSERNAME accordingly and please double check the command, if you
forget the '-a' option, you remove yourself from other groups. After adding
yourself to the group, you need to re-login for the changes to apply.
Applications can be started using bumblebee by prefixing it with optirun. For
example, starting glxgears can be done with:
optirun glxgears
--------------------
## Power Management
--------------------
Since 2.4, we added backend support for enabling/disabling the card.
You should first read the following page:
https://github.com/Bumblebee-Project/Bumblebee/wiki/ACPI-Removed
It will help you understand the current situation about Power Management. If you
understand what that does mean, then, here is how to enable it.
You need to install acpi_call module for your system.
Ubuntu: available on the PPA. To install it, run:
sudo apt-get install acpi-call-tools
Arch Linux:
AUR package: https://aur.archlinux.org/packages.php?ID=39470
First, edit the 'bumblebee.conf' file and set power management to Y.
You should also set STOP_SERVICE_ON_EXIT to Y:
ENABLE_POWER_MANAGEMENT=Y
STOP_SERVICE_ON_EXIT=Y
Then, in the bumblebee conf dir, create the textfiles 'cardon' and 'cardoff'
which should just contain the calls to respectively enable and disable the card.
Each line should contain a call, comments are not allowed.
Check 'bumblebee.conf' file comments on Power Management for more informations.
After that, reboot (or restart daemon) to apply changes.
-------------
## Uninstall
-------------
If you're unsatisfied with Bumblebee, you can remove it by running:
$ sudo bumblebee-uninstall
If you used a package version of Bumblebee, then use your package manager to
uninstall.
---------------------------
## Reporting bugs/problems
---------------------------
Please create a bug report package with the bumblebee-bugreport tool and open an
issue on GitHub at https://github.com/Ximi1970/bumblebee-obs/issues
--------------
## Developers
--------------
The current developer for bumblebee-obs is:
- Ximi1970
Many thanks to the old developers of the original Bumblebee tree:
- ArchangeGabriel
- Lekensteyn
- Samsagax
- paulvriens
- Ximi1970
You can find the original Bumblebee branch here: https://github.com/Bumblebee-Project
----------------
## Useful Links
----------------