{"id":26480326,"url":"https://github.com/meltingscales/potemkeys","last_synced_at":"2026-03-08T19:09:09.981Z","repository":{"id":45589401,"uuid":"434945854","full_name":"meltingscales/potemkeys","owner":"meltingscales","description":"Overlay utility to help people playing fighting games with keyboards memorize keymaps.","archived":false,"fork":false,"pushed_at":"2022-02-11T03:23:43.000Z","size":17617,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-09T16:37:35.096Z","etag":null,"topics":["fighting-game","guilty-gear","guilty-gear-strive","pygame","tekken","tekken-7","tekken7"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/meltingscales.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-04T16:02:04.000Z","updated_at":"2024-10-02T06:15:54.000Z","dependencies_parsed_at":"2022-09-04T18:22:20.055Z","dependency_job_id":null,"html_url":"https://github.com/meltingscales/potemkeys","commit_stats":null,"previous_names":["meltingscales/potemkeys","henryfbp/potemkeys"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meltingscales%2Fpotemkeys","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meltingscales%2Fpotemkeys/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meltingscales%2Fpotemkeys/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meltingscales%2Fpotemkeys/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meltingscales","download_url":"https://codeload.github.com/meltingscales/potemkeys/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244536445,"owners_count":20468350,"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":["fighting-game","guilty-gear","guilty-gear-strive","pygame","tekken","tekken-7","tekken7"],"created_at":"2025-03-20T02:13:31.364Z","updated_at":"2026-03-08T19:09:09.962Z","avatar_url":"https://github.com/meltingscales.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Potemkeys: Previously \"FGfGwK: Fighting Games for Goldfish with Keyboards\"\n\n## TL;DR Download!\n\n### [Windows, click here.](https://github.com/HenryFBP/potemkeys/releases/download/latest-windows/potemkeys.exe)\n\n### [Linux, click here.](https://github.com/HenryFBP/potemkeys/releases/download/latest-ubuntu/potemkeys) (must run `sudo apt-get install -y wmctrl`!)\n\n### Old name was FGfGwK\n\nThis used to be called \"FGfGwK\", \"Fighting games for Goldfish with Keyboards\" (Can't remember button maps).\n\nName is inspired by Potemkin from Guilty Gear Strive - \"potemkeys\" (Potemkin from Guilty Gear + \"keys\")\n\n### PyPI\n\n-   \u003chttps://pypi.org/project/potemkeys/\u003e\n\n### Using pip\n\n    pip install --upgrade potemkeys\n    python -m potemkeys\n\n[![forthebadge](https://forthebadge.com/images/badges/you-didnt-ask-for-this.svg)](https://forthebadge.com)\n\n[![forthebadge](https://forthebadge.com/images/badges/built-with-swag.svg)](https://forthebadge.com)\n\n[![forthebadge](https://forthebadge.com/images/badges/check-it-out.svg)](https://forthebadge.com)\n\n[![forthebadge](https://forthebadge.com/images/badges/compatibility-club-penguin.svg)](https://forthebadge.com)\n\n![A picture of the application.](/media/screenshot1.png)\n\n![Another picture of the application.](/media/screenshot2.png)\n\n## What is this?\n\nFor those who can't remember {keyboard input =\u003e controller} mappings, and want to see them in-game.\n\nCreated because TEKKEN doesn't show input conversions in multiplayer matches, and neither does Guilty Gear: Strive, \nand I wanted to see my inputs, so I wasted 6 hours writing this tool.\n\nWorks on Windows 11, and tested on Ubuntu.\n\n## This tool sucks, it doesn't do X!\n\nSee [./TODO.md](./TODO.md). Or fork this repo and add it yourself, and make a Pull Request, I'll probably accept your changes.\n\n## How do I use it?\n\nSee \u003chttps://github.com/HenryFBP/potemkeys/releases\u003e and download the provided exe/binary file.\n \nIf you put `potemkeysoptions.jsonc` in the same folder as the EXE file, it will prefer that over its temporary directory.\n\nIf you want to know where the temp file is, look at the console output when the .exe first starts up.\n\n##  Development\n\n1.  Install [uv](https://docs.astral.sh/uv/getting-started/installation/)\n2.  Clone this repo\n3.  In the repo's folder, run:\n\n    ```\n    ./scripts/setup[.cmd|.sh]\n    ./scripts/start[.cmd|.sh]\n    ```\n\n4.  The window should stay on top.\n\n    ***Play your game in borderless/windowed mode*** and see the inputs get transformed and shown to you.\n\n### Build WHL\n\n    uv build\n\n#### Test built WHL\n\n    pip install .\\dist\\potemkeys-whatever-version-1.2.3.4.5-py3-none-any.whl --force-reinstall\n\n### Deploy to PyPI\n\n    uv publish\n\n### Testing exe generation\n\n    ./scripts/generate_exe[.cmd|.sh]\n    ./dist/potemkeys[.exe|.app]\n\n## Config\n\nEdit [`potemkeysoptions.jsonc`](/potemkeys/potemkeysoptions.jsonc).\n\nYou can make keymaps for literally any game that uses keyboard, by cloning the items under `keymaps`.\n\nIf you make one and want to see it included in the \"official\" branch of this tool, just fork this repo and make a PR.\n\n## License\n\nNo license, DWYW, I'm not your dad.\n\nJust make sure to link/PR, or just fork it if I die or something :P\n\n## VIRUSES????\n\nhttps://www.reddit.com/r/learnpython/comments/e99bhe/why_does_pyinstaller_trigger_windows_defender\n\n### REEEEEEEEEEEEEEE\n\nhttps://docs.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/ms537361(v=vs.85)?redirectedfrom=MSDN\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeltingscales%2Fpotemkeys","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeltingscales%2Fpotemkeys","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeltingscales%2Fpotemkeys/lists"}