Version 63 (modified by 4 years ago) (diff) | ,
---|
Building
Platform specific index:
- Fedora, CentOS, RHEL, openSUSE
- Debian and Ubuntu
- Microsoft Windows
- MacOSX
- Gentoo
- ArchLinux
- FreeBSD, OpenBSD
- RaspberryPi
General Information
Before attempting to build from source, make sure that all the required dependencies are installed.
For running the *nix server, you will need Xvfb
or Xdummy (if available for your platform), xauth, keyboard utilities. Then just:
- download the source
- run:
python2 ./setup.py install
Do not mix source installation with packages. Remove one completely before installing the other.
Switches
There are a number of build switches, which you can see with:
./setup.py --help
These should be auto-detected in most cases.
Many of those switches are related to picture encodings.
On some platforms with older versions of libraries, it is possible, preferable and often mandatory to build static versions of the codecs. (see "--with-static*
" flags)
Patching
There are a number of patches in the source tree that may need to be applied to build on some platforms to deal with library or tools compatibility.
In particular, for Debian: browser/xpra/trunk/debian/patches/
Building with distutils
For installing into a local ./install
directory as a normal user, simply run:
./setup.py install --home=./install
You then have to add the local installation directory to your PYTHONPATH
whenever you want to use xpra:
PYTHONPATH=./install/lib*/python xpra ...
To install globally for all users via sudo:
rm -rf build install sudo ./setup.py install
Uninstall
setuptools/distutils do not provide any uninstallation mechanism, this has nothing to do with Xpra. That said, it is generally enough to remove (but you must ensure that these are the correct files as you may damage your system otherwise!):
/usr/bin/xpra /usr/lib*/python*/*-packages/xpra* /usr/share/xpra
Gentoo
The xpra ebuilds in portage are reasonably up to date, just avoid the outdated versions shipped as "stable"
RaspberryPi
Just follow the generic instructions above and make sure to apply patches where needed.
For example, raspbian: Compiling xpra for the Raspberry Pi - but make sure to install globally with sudo ./setup.py install
rather than dealing with unusual install paths.