= Building =

== General Information ==

For running the *nix server, you will need {{{Xvfb}}} or [http://xpra.org/Xdummy.html Xdummy] (if available for your platform), xauth and keyboard utilities and xauth.



----

== [[Image(http://xpra.org/icons/fedora.png)]] Fedora and [[Image(http://xpra.org/icons/centos.png)]] CentOS ==

For building you will need to install:
{{{
yum install gcc python-devel libXtst-devel libXdamage-devel \
	  	gtk2-devel pygtk2-devel pygobject2-devel
}}}
Fedora users can install Cython via yum:
{{{
yum install Cython
}}}
CentOS users will need to [http://www.cython.org/#download download] and build from source (which is trivial), use EPEL ("Extra Packages for Enterprise Linux") or rely on third party packages. 

{{{
yum install xorg-x11-server-Xorg xorg-x11-drv-dummy xorg-x11-xauth xorg-x11-xkb-utils
}}}

For x264 support, Fedora users should install the [http://rpmfusion.org/ rpmfusion] repository then:
{{{
yum install ffmpeg-devel x264-devel libvpx-devel
}}}
(building x264/vpx on CentOS is out of scope)
At runtime, to get optimal support for PNG, JPEG and WEBP, install:
{{{
yum install python-imaging libwebp
}}}


----

== [[Image(http://xpra.org/icons/debian.png)]] Debian and [[Image(http://xpra.org/icons/ubuntu.png)]] Ubuntu

For building you will need to install:
{{{
apt-get install libx11-dev libxtst-dev libxcomposite-dev libxdamage-dev \
	  	python-all-dev python-gobject-dev python-gtk2-dev cython
}}}
If you encounter errors on char [32] keys_return .. Expected ')', then your version of cython is probably too old, either upgrade it (from backports) or build it from source.

{{{
apt-get install xvfb xauth x11-xkb-utils
}}}

For x264 and vpx support, you should install:
{{{
apt-get install libx264-dev libvpx-dev libswscale-dev libavcodec-dev
}}}

Notes:
* some, generally older, distributions may not have all the development libraries available.
* Many distributions ship incomplete libvpx-dev packages that are missing the crucial vpx.pc package config file, you may want to download this copy and place it in your package config directory - at your own risk. (generally {{{/usr/lib/pkgconfig/}}} or {{{/usr/lib64/pkgconfig/}}})



----

== [[Image(http://xpra.org/icons/opensuse.png)]] openSUSE ==
''These instructions may not be up to date:''
For building you will need to install:
{{{
zypper install gcc python-cython python-devel \
		gtk2-devel python-gtk-devel python-gobject2-devel
}}}
{{{
yum install xorg-x11-server-extra xorg-x11-xauth xkeyboard-config
}}}


----

== [[Image(http://xpra.org/icons/gentoo.png)]] Gentoo ==
You can find up-to-date ebuilds [http://xpra.org/dists/gentoo]


----

== [[Image(http://xpra.org/icons/archlinux.png)]] Arch Linux ==
* Package build for stable versions can be found [https://aur.archlinux.org/packages.php?ID=49348]
* The bleeding edge svn build is [https://aur.archlinux.org/packages.php?ID=58161]


----

== [[Image(http://xpra.org/icons/windows.png)]] Microsoft Windows ==

Please follow [http://winswitch.org/dev/win32.html these instructions] to build all the required dependencies (and trim the parts that are only relevant to [http://winswitch.org winswitch])

Then you can find the MS Windows specific build scripts [http://xpra.org/trac/browser/xpra/trunk/src/win32 here]


----

== [[Image(http://xpra.org/icons/osx.png)]] Mac OS X ==

Please follow [http://winswitch.org/dev/macosx.html these instructions] to build all the required dependencies (and trim the parts that are only relevant to [http://winswitch.org winswitch])

Then you can find the OSX specific build scripts [http://xpra.org/trac/browser/xpra/trunk/osx here]