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

• Download and extract the official ggpo-build-030.zip GGPO client to a folder. Create a ROMs folder inside. You'll need to put the rom zip files in the ROMs directory.
• Open UDP ports 6000-6009 (inbound/outbound) and TCP port 7000 (outbound) in your home network
• Register a ggpo account if needed

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

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