Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Quake and DarkPlaces rcon client.Suppor such games like Xonotic, Nexuiz and other

Project description

Darkplaces and Quakes rcon [1] protocol and client implementation. Works with such games like Xonotic, Nexuiz, Warsow and other games with Quakes rcon.


  • Support old Quake rcon and new Darkplaces secure rcon protocols.
  • Support both IPv4 and IPv6 connections.
  • Bundled console client.
  • Well tested, test coverage near 100%.
  • Works with python 2.7, 3.3+.


  • execute pip install xrcon
  • or run pip install -e git+ to install development version from github


Using as library:

from xrcon.client import XRcon
rcon = XRcon('server', 26000, 'password')
rcon.connect() # create socket
    data = rcon.execute('status') # on python3 data would be bytes type

For more info read XRcon docstrings.

Using console client:

$ xrcon -s yourserver:26001 -p password command

If you want use IPv6 address it should be put inside square brackets. For example:

$ xrcon -s [1080:0:0:0:8:800:200C:417A]:26002 -p password status
$ xrcon -s [1080:0:0:0:8:800:200C:417B] -p password status

If port is omitted then by default would be used port 26000. You may also change type of rcon, by default would be used secure time based rcon protocol. This protocol works only in Darkplaces based games. For instance:

$ xrcon -s warsowserver:44400 -p password -t 0 status

0 means old (unsecure) quakes rcon, 1 means secure time base rcon, and 2 is secure challenge based rcon protocol.

You may also create ini configuration file in your home directory .xrcon.ini. For example:

server = someserver:26000
password = secret
type = 1
timeout = 0.9

server = someserver:26001

server = otherserver
password = otherpassword
type = 0
timeout = 1.2

Then if you wants execute command on this servers just do:

$ xrcon status # for DEFAULT server
$ xrcon -n other status # for other server
$ xrcon -n another status # for another server

Also, there is another one CLI utility — xping. It can be used to measure rtt for server or client. It also supports other games too, so you can measure ping for Warsow, Quake 3, Urban Terror and some other games. Here’s an example:

$ xping -c 4
XPING ( port: 26000 port=26000 time=39.36 ms port=26000 time=39.63 ms port=26000 time=39.83 ms port=26000 time=39.87 ms

--- ping statistics ---
4 packets transmitted, 4 received, 0.0% packet loss
rtt min/avg/max/mdev = 39.357/39.672/39.870/0.204 ms

Also, you can ping clients too, this might be helpful for server admins for checking client networking. First, you need to determine client host and port. You can do this via rcon status command. Let’s suppose that status command returned address, then xping command will be look like this: xping -p 33045 Note, that this might not work for some clients because of firewalls and NATs.

Here’s few other examples:

$ xping -p 26005  # stop it with Ctrl-C
$ xping -p 44400 -t qfusion  # ping warsow server
$ xping -p 27960 -t q3  # ping urban terror server

For more info about CLI options check xping --help.

In some cases results of xping might be inaccurate. For example, if you experience packet duplication or reordering. All currently supported gaming protocols have no way to identify concrete response for probe. Because of this, there is no way to determine if application received original or duplicated response. It can affect result even more, if duplicated packet will arrive some time later, so application can process it as response for new probe. In some cases application might detect packet duplication.



[1]remote console, for more info read this.

Project details

Release history Release notifications

This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
xrcon-0.2.tar.gz (24.1 kB) Copy SHA256 hash SHA256 Source None Mar 29, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page