{"id":16916349,"url":"https://github.com/gjum/gagar","last_synced_at":"2025-10-08T16:24:33.880Z","repository":{"id":32130299,"uuid":"35702930","full_name":"Gjum/gagar","owner":"Gjum","description":"Standalone graphical agar.io Python client/bot using GTK and agarnet","archived":false,"fork":false,"pushed_at":"2016-05-07T14:30:12.000Z","size":357,"stargazers_count":21,"open_issues_count":5,"forks_count":11,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-14T19:25:59.244Z","etag":null,"topics":["agar","bot","cairo","game","gtk","pypi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Gjum.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-16T00:14:56.000Z","updated_at":"2022-12-09T23:08:34.000Z","dependencies_parsed_at":"2022-09-12T01:01:37.426Z","dependency_job_id":null,"html_url":"https://github.com/Gjum/gagar","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gjum%2Fgagar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gjum%2Fgagar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gjum%2Fgagar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gjum%2Fgagar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Gjum","download_url":"https://codeload.github.com/Gjum/gagar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221826666,"owners_count":16887211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agar","bot","cairo","game","gtk","pypi"],"created_at":"2024-10-13T19:26:28.810Z","updated_at":"2025-10-08T16:24:28.809Z","avatar_url":"https://github.com/Gjum.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OUTDATED\n\nDue to heavy changes in the web client and protocol, this project does not work anymore.\n\ngagar\n=====\n\n[![Latest PyPI version](https://img.shields.io/pypi/v/gagar.svg?style=flat)](https://pypi.python.org/pypi/gagar/)\n[![Number of PyPI downloads](https://img.shields.io/pypi/dm/gagar.svg?style=flat)](https://pypi.python.org/pypi/gagar/)\n[![Join the chat at https://gitter.im/Gjum/gagar](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/Gjum/gagar?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\nStandalone graphical [agar.io](http://agar.io/) Python client using GTK and [`agarnet`](https://github.com/Gjum/agarnet)\n\n![Screenshot of gagar](http://lunarco.de/gagar/img/2015-08-01-151935_1000x562_scrot.png)\n\nFeatures\n--------\n- mass graph\n- minimap\n- skins\n- show eatability/hostility level of other cells\n- force fields for eatable/hostile cells\n- show/hide anything via key bindings\n- extend with your own plugins (more stats, server chooser, bot, ...)\n\n###Roadmap\n- command-line arguments (nick, gamemode, facebook token)\n- better virus interaction\n- zoom\n- make it work with Ogar\n- documentation (for now, look at [the `agarnet` docs](https://github.com/Gjum/agarnet/tree/v0.2.1/doc))\n- config file\n\nInstallation\n------------\nFirst of all, install the GTK dependencies.\nUnder Arch Linux, run\n\n    pacman -S python-gobject python-cairo pygtk\n\nOther distros should have similar packages.\nSomeone told me it even works on Mac using MacPorts.\nIf you get it to work, please comment on [this issue](https://github.com/Gjum/gagar/issues/8), so I can add instructions for your system.\n\nThe client itself can be installed from [PyPI](https://pypi.python.org/pypi?name=gagar\u0026:action=display) with\n\n    pip install gagar\n\nor, if you want to get the source code,\n\n    git clone git@github.com:Gjum/gagar.git\n    cd gagar/\n    python3 setup.py install\n\nRun the GUI with\n\n    gagar -h\n\nControls\n--------\n| Key       | Action                |\n|:----------|:----------------------|\n| `S`       | spectate              |\n| `Q`       | toggle spectate mode  |\n| `R`/`RETURN` | respawn            |\n| `Mouse`   | movement direction    |\n| `W`       | shoot small cell      |\n| `Space`   | split                 |\n| `K`       | explode (disabled on official servers) |\n| `C`       | reconnect to any server |\n| `I`       | show/hide helpful cell info |\n| `N`       | show/hide names       |\n| `K`       | show/hide skins       |\n| `M`       | show/hide movement lines |\n| `G`       | show/hide grid        |\n| `B`       | show/hide world border |\n| `F1`      | show/hide overlays    |\n| `F2`      | change background color |\n| `F3`      | show/hide FPS meter   |\n| `ESC`     | quit                  |\n\nAbout\n-----\nThis is a hobby project of me, on which I work in my free time.\n\nPull requests are more than welcome, but you should open an issue first, so we can talk about it.\n\nI reverse-engineered the protocol implementation by looking at the (barely) obfuscated Javascript code on the agar.io website.\nAlthough it would be much easier now to write a client, because [there is a wiki](http://agar.gcommer.com/) describing the whole protocol and most game mechanics.\n\nIf you have any game-related questions, feel free to ask in the [#agariomods IRC channel on the Rizon network](http://irc.lc/rizon/agariomods/CodeBlob@@@).\nFor questions about this client specifically, [open an issue](https://github.com/Gjum/gagar/issues/new) or write me an email: [code.gjum@gmail.com](mailto:code.gjum@gmail.com)\n\nDisclaimer\n----------\nThis project isn't affiliated with [agar.io](http://agar.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.\n\n---\n\nLicensed under GPLv3.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgjum%2Fgagar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgjum%2Fgagar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgjum%2Fgagar/lists"}