Skip to content

Overlay utility to help people playing fighting games with keyboards memorize keymaps.

License

Notifications You must be signed in to change notification settings

meltingscales/potemkeys

Repository files navigation

Potemkeys: Previously "FGfGwK: Fighting Games for Goldfish with Keyboards"

TL;DR Download!

Linux, click here. (must run sudo apt-get install -y xdotool wmctrl!)

Old name was FGfGwK

This used to be called "FGfGwK", "Fighting games for Goldfish with Keyboards" (Can't remember button maps).

Credit to @flexadecimal for the new name, "potemkeys" (Potemkin from Guilty Gear + "keys")

PyPI

Using pip

pip install --upgrade potemkeys
python -m potemkeys

forthebadge

forthebadge

forthebadge

forthebadge

A picture of the application.

Another picture of the application.

What is this?

For those who can't remember {keyboard input => controller} mappings, and want to see them in-game.

Created because TEKKEN doesn't show input conversions in multiplayer matches, and neither does Guilty Gear: Strive, and I wanted to see my inputs, so I wasted 6 hours writing this tool.

Works on Windows 11, and tested on Ubuntu.

This tool sucks, it doesn't do X!

See ./TODO.md. Or fork this repo and add it yourself, and make a Pull Request, I'll probably accept your changes.

How do I use it?

See https://github.com/HenryFBP/potemkeys/releases and download the provided exe/binary file.

If you put potemkeysoptions.jsonc in the same folder as the EXE file, it will prefer that over its temporary directory.

If you want to know where the temp file is, look at the console output when the .exe first starts up.

Development

  1. Install Python version 3.whatever

  2. Clone this repo

  3. In the repo's folder, run:

    ./scripts/setup[.cmd|.sh]
    ./scripts/start[.cmd|.sh]
    
  4. The window should stay on top.

    Play your game in borderless/windowed mode and see the inputs get transformed and shown to you.

Build WHL

poetry build

Test built WHL

pip install .\dist\potemkeys-whatever-version-1.2.3.4.5-py3-none-any.whl --force-reinstall

Deploy to PyPI

poetry publish --build

Testing exe generation

./scripts/generate_exe[.cmd|.sh]
./dist/potemkeys[.exe|.app]

Config

Edit potemkeysoptions.jsonc.

You can make keymaps for literally any game that uses keyboard, by cloning the items under keymaps.

If you make one and want to see it included in the "official" branch of this tool, just fork this repo and make a PR.

License

No license, DWYW, I'm not your dad.

Just make sure to link/PR, or just fork it if I die or something :P

VIRUSES????

https://www.reddit.com/r/learnpython/comments/e99bhe/why_does_pyinstaller_trigger_windows_defender

REEEEEEEEEEEEEEE

https://docs.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/ms537361(v=vs.85)?redirectedfrom=MSDN