AntiMicroX 3.1.0

1. Description
2. License
3. Command Line
4. Install
5. Wiki
6. Testing Under Linux
7. AntiMicroX Profiles
8. Support
9. Bugs
10. Shoutout
11. Credits
12. Participation in the translation of AntiMicroX

Description

antimicrox is a graphical program used to map keyboard keys and mouse controls
to a gamepad. This program is useful for playing PC games using a gamepad that
do not have any form of built-in gamepad support. However, you can use this
program to control any desktop application with a gamepad; on Linux, this
means that your system has to be running an X environment in order to run
this program.

This program is currently supported under various Linux
distributions.

This application is continuation of project called AntiMicro, which was later abandoned and revived by juliagoda.

Legacy repositories:
- First AntiMicroX repository: https://github.com/juliagoda/antimicroX
- Second, maintained by organization: https://github.com/AntiMicro/antimicro
- First, original AntiMicro repository: https://github.com/Ryochan7/antimicro

Screenshots:

License

This program is licensed under the GPL v.3. Please read the LICENSE text document
included with the source code if you would like to read the terms of the license.
The license can also be found online at
http://www.gnu.org/licenses/gpl.txt

Command Line

Usage: antimicrox [options] [profile]

Options:
-h, --help                     Print help text.
-v, --version                  Print version information.
--tray                         Launch program in system tray only.
--no-tray                      Launch program with the tray menu disabled.
--hidden                       Launch program without the main window
                               displayed.
--profile <location>           Launch program with the configuration file
                               selected as the default for selected
                               controllers. Defaults to all controllers.
--profile-controller <value>   Apply configuration file to a specific
                               controller. Value can be a
                               controller index, name, or GUID.
--unload [<value>]             Unload currently enabled profile(s).
                               Value can be a controller index, name, or GUID.
--startSet <number> [<value>]  Start joysticks on a specific set.
                               Value can be a controller index, name, or GUID.
-d, --daemon                   Launch program as a daemon. Use only on Linux.
--log-level (debug|info)       Enable logging. Default: debug.
--log-file <filename>          Choose a file for writing logs
--eventgen (xtest|uinput)      Choose between using XTest support and uinput
                               support for event generation. Use only if you have
                               enabled xtest and uinput options on Linux. Default: xtest.
-l, --list                     Print information about joysticks detected by
                               SDL. Use only if you have sdl library. You can 
                               check your controller index, name or 
                               even GUID.

Installation

Fedora

dnf install antimicrox

Arch Linux or Arch Linux based distributions:

trizen -S antimicrox-git

or

pre-built version can de downloaded from unofficial repository called chaotic-aur.

Append (one of listed mirrors) to /etc/pacman.conf:

# Brazil
Server = http://lonewolf-builder.duckdns.org/$repo/$arch
# Germany
Server = http://chaotic.bangl.de/$repo/$arch
# USA (Cloudflare cached)
Server = https://repo.kitsuna.net/$arch
# Netherlands
Server = https://chaotic.tn.dedyn.io/$arch

To check signature, add keys:

sudo pacman-key --keyserver hkp://keyserver.ubuntu.com -r 3056513887B78AEB 8A9E14A07010F7E3
sudo pacman-key --lsign-key 3056513887B78AEB
sudo pacman-key --lsign-key 8A9E14A07010F7E3

Install package

pacman -S antimicrox

Debian/Ubuntu-based distributions:

Download from the release site and install .deb package.

AppImage

Download from the release site.

It is recommended to use AppImageLauncher with this package.

Running using Docker

If you want to run application without building process and choose between various distributions, then look here
This method is described in details here

Building Yourself

List of required dependencies and build instructions can be found here.

Wiki

Look here

Testing Under Linux

If you are having problems with antimicrox detecting a controller or
detecting all axes and buttons, you should test the controller outside of
antimicrox to check if the problem is with antimicrox or not. The two endorsed
programs for testing gamepads outside of antimicrox are sdl-jstest
(sdl2-jstest) and evtest. SDL2 utilizes evdev on Linux so performing
testing with older programs that use joydev won't be as helpful since some
devices behave a bit differently between the two systems. Another method also exist,
which can be found here.

AntiMicroX Profiles

If you would like to send the profile you are using for your application or find something
for yourself, here is the forked repository. If you want to report a bug, ask
a question or share a suggestion, you can do that on the antimicrox page or on the
antimicrox-profiles page.

Support

In order to obtain support, you can post an issue here.

Bugs

Application's bugs will be fixed. There are created tests for detecting bugs. Of course, I'm open to proposals or questions from users.

Shoutout

A big, original inspiration for this program was the program QJoyPad.

Credits

Contributors

Full list is available here

Package Maintainers

Translators

VaGNaroK vagnarokalkimist@gmail.com - Brazilian Portuguese
zzpxyx - Chinese
Belleguic Terence hizo@free.fr - French
Leonard Koenig leonard.r.koenig@googlemail.com - German
phob - German
tou omiya - Japanese
Dmitriy Koshel form.eater@gmail.com - Russian
Jay Alexander Fleming tito.nehru.naser@gmail.com - Serbian
burunduk - Ukrainian
Flavio HR flavio.hrx@gmail.com - Spanish
WAZAAAAA - wazaaaaa00@gmail.com - Italian
juliagoda juliagoda.pl@protonmail.com - Polish

Participation in the translation of AntiMicroX

If you want to participate in the translation of the program, but your language is not yet on the support list. Please contact us.

However, if your language is already supported in the program, you must have the Qt Linguist program installed, which is usually included in the qt5-tools package, to conveniently translate the application. However, before you do that, make sure that you don't already have this program installed. All you have to do is open it, and then use it to open a file with the ts extension.

If a red exclamation mark appears in the translation field, it means that your translation does not end with the same sign as the original content. Try to place commas or dots in appropriate places and often save your progress.