Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vorot93/obozrenie

Simple and easy to use game server browser.
https://github.com/vorot93/obozrenie

game-server gtk pygobject

Last synced: 24 days ago
JSON representation

Simple and easy to use game server browser.

Awesome Lists containing this project

README 

        
![Obozrenie](https://cdn.rawgit.com/vorot93/obozrenie/master/assets/icons/hicolor/scalable/apps/obozrenie.svg)



Simple and easy to use game server browser for Linux.



[![GNU GPL](https://img.shields.io/badge/license-GPL-brightgreen.svg)](https://gnu.org/licenses/gpl.html)

[![Docker Pulls](https://img.shields.io/docker/pulls/vorot93/obozrenie.svg)](https://hub.docker.com/r/vorot93/obozrenie/)



[![Build Status](https://img.shields.io/travis/vorot93/obozrenie.svg)](https://travis-ci.org/vorot93/obozrenie)

[![Climate](https://img.shields.io/codeclimate/github/vorot93/obozrenie.svg)](https://codeclimate.com/github/vorot93/obozrenie)

[![codecov.io](https://img.shields.io/codecov/c/github/vorot93/obozrenie.svg)](https://codecov.io/github/vorot93/obozrenie)



## Project status note (2016-06-13)

Right now Obozrenie is considered feature-complete and ready for general usage.



However, the fact that I chose Python as the language of code led to significant hurdles in terms of application performance, maintainability and shipping today. I am looking into rewriting Obozrenie in a lower level language (like Vala or Go) for better speed and maintainability.



Therefore, new **features** are not likely to be implemented in this codebase. **Game support**, however, will expand on request. Nevertheless you are welcome to voice your wishes at issue tracker.



## Overview

Obozrenie is a game server browser that can be used to access information about and connect to multiplayer servers.



## Features

- Fast, fully threaded stat engine

- Easy to use, elegant, uncluttered GUI

- Supports various backends, designed for modularity.



## Screenshot

![](screenshot.png)



## Dependencies

### Required:

- [Python 3.2+](https://python.org)

- [PythonGI with GTK+ 3.10+ and higher](https://wiki.gnome.org/Projects/PyGObject)

- [PyXDG](http://freedesktop.org/Software/pyxdg)

- [python-pytoml](https://github.com/avakar/pytoml)

- [python-xmltodict](https://github.com/martinblech/xmltodict)

- [python-setuptools](http://pypi.python.org/pypi/setuptools)



### Optional:

- [QStat](https://github.com/multiplay/qstat) - for QStat backend support

- [Babel](http://babel.pocoo.org) - for translation support

- [PyGeoIP](https://github.com/appliedsec/pygeoip) with GeoIP database - for geolocation support



## Get it

### Docker

Obozrenie project ships Ubuntu-based Docker image containing Obozrenie browser, runnable out of the box. It is only intended for quick test drive since custom GTK+ theming, game launching or settings storage is not available in this version.

#### Install / update

    docker pull vorot93/obozrenie

#### Run

    docker run -it --rm -e LANG=$LANG -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix vorot93/obozrenie

### Manual

    git clone https://github.com/vorot93/obozrenie.git

    cd obozrenie

    ./obozrenie-gtk



## Technical details

Obozrenie is written in Python, with use of PyGObject libraries. It consists of several backends for master server interaction, core module and different GUIs.



* Backends query master servers and receive the server list.

* Core library forms multi-layered tables with game settings and server information (Game Table) and Obozrenie-wide configuration (Settings Table).

* GTK+ GUI shows this information in a user-friendly form.



## Licenses

### Obozrenie

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 3, as published by the Free Software Foundation.



This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.



### Obozrenie logo

This logo uses Neometric typeface by [Andres Sanchez](http://andresl.tumblr.com) distributed under CC-BY-SA-NC.