{"id":13562947,"url":"https://github.com/AntiMicroX/antimicrox","last_synced_at":"2025-04-03T19:31:55.990Z","repository":{"id":37086975,"uuid":"290138319","full_name":"AntiMicroX/antimicrox","owner":"AntiMicroX","description":"Graphical program used to map keyboard buttons and mouse controls to a gamepad. Useful for playing games with no gamepad support.","archived":false,"fork":false,"pushed_at":"2025-03-06T06:43:47.000Z","size":33147,"stargazers_count":2805,"open_issues_count":119,"forks_count":158,"subscribers_count":43,"default_branch":"master","last_synced_at":"2025-04-02T00:36:41.516Z","etag":null,"topics":["controller","gamepad","gamepad-api","games","gaming","keyboard-emulation"],"latest_commit_sha":null,"homepage":"","language":"C++","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/AntiMicroX.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":"AntiMicroX","buy_me_a_coffee":null,"custom":null}},"created_at":"2020-08-25T06:55:38.000Z","updated_at":"2025-04-01T18:16:21.000Z","dependencies_parsed_at":"2024-04-17T23:31:33.113Z","dependency_job_id":"8a4d3ea2-8088-42db-9522-6d61c583c037","html_url":"https://github.com/AntiMicroX/antimicrox","commit_stats":{"total_commits":2683,"total_committers":102,"mean_commits":26.30392156862745,"dds":0.5259038389862094,"last_synced_commit":"dea521e0e4cbec1e7f4f0c50da848924d8837651"},"previous_names":[],"tags_count":82,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntiMicroX%2Fantimicrox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntiMicroX%2Fantimicrox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntiMicroX%2Fantimicrox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntiMicroX%2Fantimicrox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AntiMicroX","download_url":"https://codeload.github.com/AntiMicroX/antimicrox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246943962,"owners_count":20858770,"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":["controller","gamepad","gamepad-api","games","gaming","keyboard-emulation"],"created_at":"2024-08-01T13:01:13.697Z","updated_at":"2025-04-03T19:31:55.969Z","avatar_url":"https://github.com/AntiMicroX.png","language":"C++","funding_links":["https://polar.sh/AntiMicroX","https://polar.sh"],"categories":["Useful","C++","Applications","Linux Input \u0026 Calibration"],"sub_categories":["Utilities","rFactor"],"readme":"# \u003cimg src=\"./src/images/antimicrox.png\" alt=\"Icon\" width=\"60\"/\u003e AntiMicroX\n\n1. [Description](#description)  \n2. [License](#license)  \n3. [Installation](#installation)\n4. [Wiki](#wiki)\n5. [Command Line](#command-line) \n6. [Testing Under Linux](#testing-under-linux)  \n7. [AntiMicroX Profiles](#antimicrox-profiles)\n8. [Support](#support)  \n\n## Description\n\nAntiMicroX is a graphical program used to map gamepad keys to keyboard, mouse, scripts and macros. You can use this program to control any desktop application with a gamepad on Linux🐧 and Windows 🪟.  \nIt can be also used for generating SDL2 configuration (useful for mapping atypical gamepads to generic ones like xbox360).\n\nWe support X.org and Wayland.\n\nFeatures:\n\n- Mapping of gamepads/joystick buttons to:\n  - keyboard buttons\n  - mouse buttons and moves\n  - scripts and executables\n  - macros consisting of elements mentioned above\n- Assigning multiple switchable sets of mappings to gamepad.\n- Auto profiles - assign profile to active application window (not in Wayland [note](https://github.com/AntiMicroX/antimicrox/issues/303)).\n\nThis program is currently supported under various Linux\ndistributions.\n\nThis application is continuation of project called `AntiMicro`, which was later abandoned and revived by juliagoda.\n\nLegacy repositories:\n- First AntiMicroX repository: https://github.com/juliagoda/antimicroX\n- Second, maintained by organization: https://github.com/AntiMicro/antimicro\n- First, original AntiMicro repository: https://github.com/Ryochan7/antimicro\n\n**Screenshots:**  \nDisclaimer: Theme may depend on your system configuration.\n\n\u003ctable border=\"0px\" \u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003cimg src=\"./other/appdata/screenshots/app_light.png\" alt=\"Main Window\" /\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003cimg src=\"./other/appdata/screenshots/controllermapping.png\" alt=\"Mapping\" /\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003cimg src=\"./other/appdata/screenshots/calibration.png\" alt=\"Calibration\" /\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n    \u003cimg src=\"./other/appdata/screenshots/advanced.png\" alt=\"Advanced settings\" /\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## License\n\nThis program is licensed under the GPL v.3. Please read the LICENSE text document\nincluded with the source code if you would like to read the terms of the license.\nThe license can also be found online at\nhttp://www.gnu.org/licenses/gpl.txt\n\n## Installation\n\n### Windows\n\nJust download `antimicrox-X.X.X-AMD64.exe` from [Release site](https://github.com/AntiMicroX/antimicrox/releases/latest) and install it.\n\n### Flatpak\n\nThe flatpak version is distributed on Flathub, and runs on most major Linux distributions. See instructions here: [Flathub application page](https://flathub.org/apps/details/io.github.antimicrox.antimicrox)\n\nIf you have Flathub [set up](https://flatpak.org/setup/) already:\n\n```bash\nflatpak install flathub io.github.antimicrox.antimicrox\n```\n\n❕ Flatpak package may not work correctly with wayland [(Fix available here)](https://github.com/AntiMicroX/antimicrox/wiki/Open-uinput-error)\n\n### AppImage\n\nDownload from the [release site](https://github.com/AntiMicroX/antimicrox/releases).\n\nIt is recommended to use [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) with this package.\n\n### Debian/Ubuntu-based distributions\n\nDownload from the [release site](https://github.com/AntiMicroX/antimicrox/releases) and install `.deb` package.\n\n### Fedora\n\n```\ndnf install antimicrox\n```\n\n### openSUSE\n\nA [package](https://software.opensuse.org/package/antimicrox) is available.\n\n```\nzypper install antimicrox\n```\n\n### Arch Linux or Arch Linux based distributions:\n\n```\ntrizen -S antimicrox\n```\n**or**\n\npre-built version can de downloaded from unofficial repository called [chaotic-aur](https://lonewolf.pedrohlc.com/chaotic-aur/).\n\nAppend (one of listed mirrors) to `/etc/pacman.conf`:\n```bash\n# Brazil\nServer = http://lonewolf-builder.duckdns.org/$repo/$arch\n# Germany\nServer = http://chaotic.bangl.de/$repo/$arch\n# USA (Cloudflare cached)\nServer = https://repo.kitsuna.net/$arch\n# Netherlands\nServer = https://chaotic.tn.dedyn.io/$arch\n```\nTo check signature, add keys:\n```bash\nsudo pacman-key --keyserver hkp://keyserver.ubuntu.com -r 3056513887B78AEB 8A9E14A07010F7E3\nsudo pacman-key --lsign-key 3056513887B78AEB\nsudo pacman-key --lsign-key 8A9E14A07010F7E3\n```\nInstall package\n```bash\npacman -S antimicrox\n```\n\n### Building Yourself\n\nList of required dependencies and build instructions can be found [here](./BUILDING.md).\n\n### Packages status\n\nStatus of package `antimicrox`:  \n[![Packaging status](https://repology.org/badge/vertical-allrepos/antimicrox.svg?columns=3\u0026minversion=3.1)](https://repology.org/project/antimicrox/versions)\n\n## Command Line\n\nRun `antimicrox --help` or read `man antimicrox` for command-line parameters.\n\n\u003cdetails\u003e\n  \u003csummary\u003eCommandline for flatpak\u003c/summary\u003e\n  In case of flatpak package AntiMicroX can be launched with command:\n  \u003cbr\u003e\n  \u003ccode\u003eflatpak run io.github.antimicrox.antimicrox\u003c/code\u003e instead of just \u003ccode\u003eantimicrox\u003c/code\u003e\n  \u003cbr\u003e\n  In some cases it may be good to add alias\n  \u003cbr\u003e\n  \u003ccode\u003ealias antimicrox='flatpak run io.github.antimicrox.antimicrox'\u003c/code\u003e\u003cbr\u003e\n  fo file \u003ccode\u003e~/.bashrc\u003c/code\u003e\n\u003c/details\u003e\n\n## Wiki\n\n[Look here](https://github.com/AntiMicroX/antimicrox/wiki)\n\n## Testing Under Linux\n\nIf you are having problems with antimicrox detecting a controller or\ndetecting all axes and buttons, you should test the controller outside of\nantimicrox to check if the problem is with antimicrox or not. The two endorsed\nprograms for testing gamepads outside of antimicrox are **sdl-jstest**\n(**sdl2-jstest**) and **evtest**. SDL2 utilizes evdev on Linux so performing\ntesting with older programs that use joydev won't be as helpful since some\ndevices behave a bit differently between the two systems. Another method also exists, \nwhich can be found [here](https://github.com/juliagoda/SDL_JoystickButtonNames).\n\n## AntiMicroX Profiles\n\nIf you would like to send the profile you are using for your application or find something \nfor yourself, [here](https://github.com/AntiMicroX/antimicrox-profiles) is the forked repository. If you want to report a bug, ask \na question or share a suggestion, you can do that on the antimicrox page or on the\n[antimicrox-profiles](https://github.com/AntiMicroX/antimicrox-profiles) page.\n\n## Support\n\nThere are several ways to get help with AntiMicroX. The easiest way is to upvote (with 👍) issues you thing are the most important ones. It is also possible to fund some issues using [Polar](https://polar.sh) platform to attract contributors.\n\n### Contributing\n\nAny contributions into codebase are welcome. You can find contribution guide [here](./CONTRIBUTING.md).  \nSome issues are may have bounties which are meant to attract contributors.\n\n### Translation\n\nTranslation process is handled via [Weblate](https://weblate.org/). If you want to help just click this [link](https://hosted.weblate.org/engage/antimicrox).\n\nTranslation status\n\n\u003ca href=\"https://hosted.weblate.org/engage/antimicrox/\"\u003e\n\u003cimg src=\"https://hosted.weblate.org/widgets/antimicrox/-/gui/multi-auto.svg\" alt=\"Translation status\" /\u003e\n\u003c/a\u003e\n\nMore information about translating can be found [here](https://github.com/AntiMicroX/antimicrox/wiki/Translating-AntiMicroX).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAntiMicroX%2Fantimicrox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAntiMicroX%2Fantimicrox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAntiMicroX%2Fantimicrox/lists"}