Repository files navigation

Due to heavy changes in the web client and protocol, this project does not work anymore.

Standalone graphicalagar.io Python client using GTK andagarnet

• mass graph
• minimap
• skins
• show eatability/hostility level of other cells
• force fields for eatable/hostile cells
• show/hide anything via key bindings
• extend with your own plugins (more stats, server chooser, bot, ...)

###Roadmap

• command-line arguments (nick, gamemode, facebook token)
• better virus interaction
• zoom
• make it work with Ogar
• documentation (for now, look attheagarnet docs)
• config file

First of all, install the GTK dependencies.Under Arch Linux, run

pacman -S python-gobject python-cairo pygtk

Other distros should have similar packages.Someone told me it even works on Mac using MacPorts.If you get it to work, please comment onthis issue, so I can add instructions for your system.

The client itself can be installed fromPyPI with

pip install gagar

or, if you want to get the source code,

git clone git@github.com:Gjum/gagar.gitcd gagar/python3 setup.py install

Run the GUI with

gagar -h

This is a hobby project of me, on which I work in my free time.

Pull requests are more than welcome, but you should open an issue first, so we can talk about it.

I reverse-engineered the protocol implementation by looking at the (barely) obfuscated Javascript code on the agar.io website.Although it would be much easier now to write a client, becausethere is a wiki describing the whole protocol and most game mechanics.

If you have any game-related questions, feel free to ask in the#agariomods IRC channel on the Rizon network.For questions about this client specifically,open an issue or write me an email:code.gjum@gmail.com

This project isn't affiliated withagar.io in any way. When playing with this client, you do not get advertisements, which may be nice for you, but does not pay for the servers needed to run the game.

Licensed under GPLv3.