AntiMicroX

버튼 및 축 매핑

게임패드/조이스틱의 버튼과 축을 키보드 키, 마우스 버튼과 이동, 스크립트·실행 파일, 그리고 이 요소들을 조합한 매크로에 매핑할 수 있습니다.

다중 매핑 세트

하나의 게임패드에 여러 개의 전환 가능한 매핑 세트를 할당해 용도에 따라 입력을 바꿔가며 사용할 수 있습니다.

Auto profiles

현재 활성화된 애플리케이션 창에 맞춰 매핑 프로파일을 자동으로 전환할 수 있는 기능입니다. 단, Wayland 환경에서는 이 기능을 사용할 수 없습니다.

SDL2 구성 생성

비정형(독특한) 게임패드를 Xbox 360 같은 범용 게임패드처럼 동작하도록 SDL2 구성을 생성해, 이후 다른 프로그램에서도 일반 게임패드로 인식되도록 만들어 줍니다.

D-Bus 인터페이스

io.github.antimicrox D-Bus 서비스를 통해 InputDevice 객체를 제어할 수 있습니다. getSDLName, getDescription, getActiveSetNumber, getActiveSetName, setActiveSetNumber 등의 메서드로 입력 장치 식별과 활성 세트 전환을 수행할 수 있습니다.

설치 및 시작 방법

Windows에서는 GitHub 릴리스 페이지에서 antimicrox-X.X.X-AMD64.exe 형태의 설치 파일을 내려받아 실행하면 됩니다. winget을 사용하는 경우 다음 명령으로 설치할 수 있습니다.

winget install --id AntiMicroX.antimicrox --exact

Linux에서는 배포판별로 다양한 설치 경로가 제공됩니다.

• Flatpak: Flathub에서 io.github.antimicrox.antimicrox 패키지로 배포되며, 설치 후에는 flatpak run io.github.antimicrox.antimicrox으로 실행합니다. 일부 Wayland 환경에서는 uinput 오류가 발생할 수 있습니다.
• AppImage: GitHub 릴리스에서 내려받아 실행하며, AppImageLauncher와 함께 사용하는 것이 권장됩니다.
• Debian/Ubuntu 계열: GitHub 릴리스의 .deb 패키지를 내려받아 설치합니다.
• Fedora: dnf install antimicrox
• openSUSE: 소프트웨어 저장소에서 antimicrox 패키지를 설치하며 zypper install antimicrox로 설치합니다.
• Arch Linux 계열: trizen 등 AUR 헬퍼를 사용하거나, chaotic-aur 미러를 pacman.conf에 추가한 뒤 pacman -S antimicrox로 설치할 수 있습니다.

기본 사용 흐름

1. 프로그램을 실행하고 게임패드를 PC에 연결합니다.
2. 매핑 창에서 게임패드의 각 버튼이나 스틱을 원하는 키보드 키, 마우스 동작 또는 스크립트에 연결합니다.
3. 필요에 따라 여러 매핑 세트를 구성하고, 자동 프로파일을 활성화할 애플리케이션 창을 지정합니다.
4. 매핑을 저장한 뒤 원하는 게임 또는 애플리케이션에서 게임패드를 사용해 동작을 확인합니다.

활용 예시

• 게임패드 미지원 PC 게임을 Xbox 360 컨트롤러 매핑으로 조작하기.
• SDL2 구성을 생성해 비정형 게임패드를 범용 게임패드로 인식시키기.
• 게임이나 애플리케이션별로 매핑 세트를 만들어 두고, Auto profiles로 활성 창에 맞춰 자동으로 전환하기.
• D-Bus를 통해 외부 스크립트에서 활성 매핑 세트를 원격으로 전환하기.

제한·라이선스·확인사항

• 라이선스는 GPL v3이며 소스 코드와 함께 LICENSE 문서가 제공됩니다.
• Windows XP 지원은 3.6.0에서 중단되었으며, 최소 Qt 요구 버전은 5.10입니다.
• Linux에서 Auto profiles는 Wayland에서 동작하지 않으며, Flatpak 패키지는 일부 Wayland 환경에서 uinput 관련 오류가 보고되어 있습니다.
• 개발자 사정으로 인해 신규 유지 관리자를 찾고 있는 상태이며, 공식적으로 신규 기능 추가는 제한되어 있고 외부 기여에 한해 추가될 수 있습니다.