2016-10-04 15:42:36 +05:00
# URTrator
2016-10-04 17:06:30 +05:00
[![Join the chat at https://gitter.im/urtrator/Lobby ](https://badges.gitter.im/urtrator/Lobby.svg )](https://gitter.im/urtrator/Lobby?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)
2016-10-04 18:56:13 +05:00
![Main Window ](/doc/screenshots/0.1-main_window.png )
2016-10-04 15:42:36 +05:00
URTrator is a desktop application that should (eventually) replace
Urban Terror's and IRC client interfaces for you, because they're
pretty shitty :).
2016-10-06 15:04:55 +05:00
*Disclaimer: This software isn't written nor supported (for now) by FrozenSand.
All code is a community effort.*
2016-10-04 15:42:36 +05:00
Right now it can:
* Obtaining list of Urban Terror servers from master server and
updating information about them.
* Local caching of whole data (in SQLite3 database).
* Extended Urban Terror launching capabilities (e.g. launching game
in another X session).
* Supporting of multiple profiles with multiple game versions.
2016-10-04 23:39:32 +05:00
When you're launching Urban Terror URTrator will check profile you're
trying to use and, if version incompatability found, will not launch
the game.
* Favorites servers.
2016-10-07 21:27:23 +05:00
* Updating single server.
* Showing information about servers (like in UrT Connector).
2016-11-22 05:42:15 +05:00
* Clipboard monitoring.
2016-10-04 15:42:36 +05:00
Planning:
* Friends searching.
* RCON console.
* Game updating (not from official servers yet, sorry).
* Pickup/matchmaking interfaces.
* All kinds of notifications.
2016-10-04 18:09:14 +05:00
* Extended profile editor, so every profile could have own configuration
files, etc.
2016-10-04 15:42:36 +05:00
* ...maybe more :)
# Installation
## Release
2016-10-07 21:27:23 +05:00
You don't need to install anything, thanks to Go's.
2016-10-04 15:42:36 +05:00
URTrator executable contains everything we need. Just download
approriate binary and launch it! :) The only thing is to make
2016-10-07 21:27:23 +05:00
sure you have GTK2 and sqlite3 installed.
2016-10-04 15:42:36 +05:00
2016-10-09 03:29:36 +05:00
## Distro-and-OS specific instructions
* [MacOS ](/doc/installation/macos/ )
* Windows (to be written)
* Nixes: read below.
2016-10-04 15:42:36 +05:00
## Development version
URTrator written in Go and GTK2, so you should have them installed.
Make sure your ``GOPATH`` variable is defined.
Then execute:
```
go get -d github.com/pztrn/urtrator
go install github.com/pztrn/urtrator
```
First command will get sources of URTrator and dependencies, second
command will build executable for you and place it in ``$GOROOT/bin``.
2016-10-04 19:00:44 +05:00
### Updating
``go get`` will do initial repo clone for you, but flag ``-u`` is
required to get updated URTrator source. So, for updating sources
just issue:
```
go get -d -u github.com/pztrn/urtrator
```
2016-10-05 13:13:28 +05:00
Again, this will only update sources. To build executable you have to
issue:
```
go install github.com/pztrn/urtrator
```
2016-10-04 15:42:36 +05:00
# Important information
## GTK warnings in console
Many GTK warnings in console may appear while using URTrator. Unfortunately,
they are out of control, because they are related to Go GTK+2 bindings
and nothing can be done on URTrator side.
2016-10-04 18:47:47 +05:00
2016-10-06 16:31:31 +05:00
## Why GTK+2?
Because GTK+3 going on "stable api nonsense" way. And also it have some
troubles with integrating with current popular WM/DE (like XFCE4,
Openbox, etc.). And also I already tired of that shitty Adwaita and
Cantarella.
If you want to use GTK+3, well, you can write UI for yourself, Go
bindings exist.