Cross platform (Linux, MacOSX, Windows) GUI client for GGPO.net
Python Shell
Permalink
Failed to load latest commit information.
ggpo support custom server Oct 20, 2014
.gitignore initial checkins Mar 12, 2014
BUILD.md update build instruction Mar 24, 2014
LICENSE Initial commit Mar 11, 2014
Makefile update Mar 22, 2014
README.md v0.04 release Mar 21, 2014
TODO.txt custom emoticons Mar 22, 2014
VERSION fix bug reported by furntree Apr 23, 2014
WHATSNEW.md fix bug reported by furntree Apr 23, 2014
__init__.py initial checkins Mar 12, 2014
main.py custom emoticons Mar 22, 2014
phonontest.py phonontest Mar 14, 2014
winbuild.bat build file for windows Mar 25, 2014

README.md

pyqtggpo

This is a cross platform (Linux, MacOSX, Windows) GUI client for GGPO.net written in python using the pyqt4 framework.

©2014 papasi GPL v2 License

Features

  • Support different Qt Stylesheets to reduce eye strain
  • More accurate GeoIP info
  • Simple emoticons support
  • Autocomplete in chat
  • Built in CLI commands in chat, type /help to see a list of commands
  • Support a database of ggpo unsupported game save states in the Unsupported Games room. Action > Sync / Select. Contribute save states
  • See What's New for a list of changes

Installation

Windows

  1. Download and extract pyqtggpo.zip
  2. Double click pyqtggpo.exe, login with your ggpo credential
  3. Go to Settings > Locate ggpofba.exe and select the ggpofba.exe file you extracted from the official client.

Mac

alt text

  1. Go to "Wine.app Downloads" and scroll to the middle section and download the Wine.app.
  2. Run Wine.dmg and drag the wine icon to your Applications folder
  3. Run Wine at least once (OSX will ask if you want to run this application downloaded from internet)
  4. Download PyQtGGPO.dmg
  5. Double click PyQtGGPO.dmg to mount it, go to the mounted volume and drag PyQtGGPO app to your Applications folder
  6. Right click PyQtGGPO, select open from the context menu. Confirm to run.
  7. login with your ggpo credential
  8. Go to Settings > Locate ggpofba.exe and select the ggpofba.exe file you extracted from the official client.

Linux

Only source code distribution is available currently, you'll need wine and pyqt4 for your Linux distribution

To install on Debian based systems (ubuntu, etc), you can type this in a terminal

sudo apt-get install wine python-qt4-phonon python-qt4 python-pip python-dev build-essential
sudo pip install geoip2

Download GeoIP2 database GeoLite2-Country.mmdb.gz and gunzip GeoLite2-Country.mmdb to a folder.

Either download and gunzip pyqtggpo source tarball or

sudo apt-get install git
git clone https://github.com/doctorguile/pyqtggpo.git
  1. Make sure you have wine installed
  2. Run winecfg and check the option to "Emulate a virtual desktop"
  3. cd pyqtggpo ; python main.py
  4. Login with your ggpo credential
  5. Go to Settings > Locate ggpofba.exe and select the ggpofba.exe file you extracted from the official client.
  6. Go to Settings > Locate GeoIP mmdb and select the GeoLite2-Country.mmdb file.

Credits

Tony Cannon (Ponder) Tom Cannon (ProtomCannon)
For the original ggpo client, innovative p2p protocol and hosting the service for free

Pau Oliva Fora (@pof)
For the amazing job of reverse engineering the client protocol and the CLI client that provides most of the ground work for this GUI port, as well as the wine installation instructions. Contribute save states

Andrew Furlani and Brendan O'Dowd
For the original idea of Unsupported Savestates Management and maintaining the database of savestates

Screenshots

alt text alt text