Gentoo Wiki


This article is part of the HOWTO series.
Installation Kernel & Hardware Networks Portage Software System X Server Gaming Non-x86 Emulators Misc



Cedega (aka WineX) is a version of wine that is developed for users to play windows games under linux. Cedega is Non-Free Software, and forked off the Free (as in Freedom) Wine project. Wine is progressing rather well with its Direct3D-support, and may in many cases perform better than Cedega.

Using Emerge

First of all, we need the cedega-small-<version>.tgz file.

Downloading The Latest Version

Go to the transgaming website and download the .tgz file from there. NOTE: you need to fill out a billing address,... to obtain a transgaming subscription to download cedega. It is important that you download the "cedega-small" file, as the cedega-<version>.tgz now includes all of the dependencies; it is better to let portage handle all dependencies.

Copy the cedega-small-<version>.tgz file to /usr/portage/distfiles, e.g cp cedega-small-<version>.tgz /usr/portage/distfiles as root. Now (also as root) do emerge cedega. If it complains about a wrong checksum, redownload the file and make sure the version number you downloaded matches portages, or patch the ebuild /usr/portage/app-emulation/cedega/cedega-<version>.ebuild digest Then, when you first launch cedega, you need to install the engine. Get the cedega-engine-<version>.i386.cpkg file, and in the 'TransGaming' menu, select 'Install local update'. Enter the path to the file you just downloaded, and then, restart cedega. You are now ready to install your first Windows program.

Installing Cedega - The quick and dirty way, no portage.

After downloading Cedega, you will have a file of the form 'cedega_x.x-x.ix86.tgz' (where x are numbers). This is a compressed file which will have to be decompressed to the root directory. To view the contents of the file before decompressing it (after all it's the root directory we're talking about), execute the following:

tar -tzf cedega-small_x.x-x.ix86.tgz | less

Then, having verified the output, extract it. The easiest way to do this is to execute the following command as root:

tar -xvzpf cedega-small_x.x-x.ix86.tgz -C /

As of Cedega 5, the cedega install package will only provide the Cedega GUI, and it is not capable of running games on its own. For that, you need to install the "cedega-engine" files, which are available from transgaming as part of your subscription. They should look something like 'cedega-engine-x.x.x.i386.cpkg'. After you have obtained them, install them using the Cedega GUI by 'TransGaming->

Downloading from CVS

If you wish to download Cedega for free you can use the tutorial found at this website. Keep in mind that you will be downloading from the CVS sources you'll be downloading a previous cedega. Also you need to have the CVS client emerge cvs.

Get the script here:


Forums Gentoo
Forums Gentoo
this link

Using Cedega

After doing that you will have the command 'cedega' in your path. Use that to load the .exe file of the game you want to play.

For example, if you mounted your windows partition to /win, and you would like to play Warcraft 3, you may end up doing something like the following:

cd /win/Program*/War*
cedega war3.exe

Of course, you can INSTALL a game purely in linux, without a windows partition at all. This is done the same way as you would in windows. So do something like this:

cedega autoplay.exe

which will load the autoplay file (most games have that) and you can use that to install the game. While installing, you will be prompted for a location to install, something of the form C:\Folder\AnotherFolder. You can leave the default folder without changing it. The game will be installed in your ~/TransGaming_Drive folder, which emulates some of windows' more important folders. A symbolic link will also be placed in the user's home folder. However, as of Cedega 5, you now have the option of installing the game to its own Windows sandbox, which is very useful if you would like to separate a game and related programs from other games. This is done by using the following command:

cedega -install <Sandbox name> <file>

After installing the game, use cedega again to run the initial game .exe file.

Cedega and Dmixer

I assume that you already have a working dmixer setup, if not, visit ALSA/Install

File: ~/.cedega/configuration_profiles/cedega_<version>
"Drivers" = "winealsa.drv" # replace wineoss.drv with winealsa.drv
"WaveMapper" = "msacm.drv"
"MidiMapper" = "midimap.drv"

"UseMMap" = "N" #replace Y with N, aparently not stable
"pcm0" = "default" #change this setting to what your dmixer name is (e.g mine is default)
"ctl0" = "default" #same as above


The best place to begin is the 'Cedega Release Notes' for your version of Cedega. Specifically, the Known Issues section of the release notes provides information about bugs and issues as well as temporary workarounds for certain games.

However, understand that Cedega continues to improve with each subsequent version, so the issues you are having now may be fixed in versions to come.

Cedega's Scheduler

Cedega 5 introduced a new user-space Cedega process scheduler, which is supposed to handle the wineserver's process priority. According to the Cedega documentation:

"With the introduction of the 2.6 Linux kernel, drastic changes have been made in the of process scheduling. Some distributions have taken advantage of this and optimized their schedulers to run certain applications better than others. Unfortunately, this means that some 2.6-based kernels may starve more 'aggressive' applications like Cedega at inopportune times, leading to stuttering movies, jerky framerate and/or random freezes.

Starting with Cedega 5.0, we include a user-mode scheduler to alleviate most of these problems by performing rescheduling of game processes manually."Cedega 5.0.3 Release Notes

Gentoo 2.6 kernels should handle the wineserver's process priority effectively. If you are experiencing frame drops, jerkiness, or stuttering gameplay, turning off Cedega's internal scheduler, which is enabled by default, may solve the problem.


Retrieved from ""

Last modified: Tue, 26 Aug 2008 21:42:00 +0000 Hits: 69,244